tilegym-monkey-patch-kernels-to-transformers

name	tilegym-monkey-patch-kernels-to-transformers
description	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.
version	2026.05.05-beta
environment	{"IDE":["Claude Code","Cursor (Agent mode)"],"model":["Opus 4.6","GPT-5.3-CodeX"]}
license	CC-BY-4.0 AND Apache-2.0
metadata	{"author":"TileGym Team <[e-mail]>","tags":["tilegym","transformers","integration","kernel","monkey-patch"]}

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.

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