Tilegym Monkey Patch Kernels To Transformers

by nvidiacf5224d14250CC-BY-4.0 AND Apache-2.03.5K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated today

Integrate TileGym kernels into Hugging Face `transformers` models by replacing the library's submodule(s) and certain class(es)' implementations, and patching certain class(es)' init/forward/load weight methods prior to instantiating models. Used when the user requires integrating TileGym kernels into `transformers` models.

AI-generated overview

Integrates TileGym cuTile kernels into Hugging Face transformers models via non-intrusive monkey-patching and auto-generates new kernels.

What it does
Guides an agent through integrating TileGym kernels into a target Hugging Face transformers model by replacing submodules and patching class init, forward, and weight-loading methods before instantiation, so the model runs TileGym kernels at runtime. It also runs an auto-research-style loop to create and integrate new cuTile kernels for uncovered PyTorch code, then summarizes and reports results. It produces patched model integrations, new kernel definitions, and a report.
When to use it
Use when a user wants TileGym kernels integrated into a specific transformers model for end-to-end correctness and throughput validation. It is intended for kernel integration and kernel generation work on transformer models rather than general model training or inference tasks.
Requirements
Requires an AI agent environment (verified on Claude Code, CodeX, and Cursor Agent mode) and access to the TileGym project and Hugging Face transformers. It references environment setup, kernel integration, auto-kernelize, and kernel inventory schema documents, and ships no scripts.

Integrate and create cuTile kernels into 🤗 Transformers

The main purpose of TileGym project is to provide performant kernels for LLM training and inference. We will integrate proper kernels available in TileGym project to LLM models provided by Hugging Face transformers library to validate end-to-end functional correctness and performance improvements. Instead of modifying transformers source code, we will take a non-intrusive monkey-patch approach: We will replace certain modules/classes/methods in transformers library that implement the Transformer model we would like to integrate, such that at model instantiation, that model's core components will be replaced by TileGym implementations. At runtime the model will actually invoke TileGym kernels under the hood. In addition, we will follow an auto-research-style agent harness loop to create and integrate new cuTile kernels to the target model to improve kernel coverage and end-to-end throughput.

Instructions

This is for human readers: Simply prompt your favorite AI Agent with skill name and target model ID. E.g.,:

Claude/CodeX
Hi, please /monkey-patch-kernels-to-transformers Qwen/Qwen3.5-0.8B.

The Agent might ask you several questions. Make clarifications and give a go confirmation.

Workflow

  1. Prepare experiment environment. Follow environment-setup.md
  2. Integrate existing TileGym kernels to the target model. Follow kernel-integration.md
  3. Autonomously create new cuTile kernels for uncovered PyTorch code. Follow auto-kernelize.md
    • Feel free to add new cuTile kernels with constraints in mind
    • Do not stop until meet auto-kernelize loop stop conditions
  4. Summarize and report

Disciplines

This is for AI Agents executing this workflow.

Kernel inventory

Reusable transformer-local kernels must be represented with FlashInfer-Bench-style Definition and Solution metadata. Follow kernel-inventory-schema.md when researching compute requirements, inventorying existing kernels, proposing candidates, or creating new generated kernels.

Source and attribution

Source:nvidia/skillsinskills/tilegym-monkey-patch-kernels-to-transformersat commitcf5224d

License: CC-BY-4.0 AND Apache-2.0

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal