This is a collection of examples using Codegen. You can use these examples to learn how to use Codegen and build custom code transformations.

We recommend using uv with Python 3.13 for the best experience.

To install Codegen, please follow the official installation guide. Once Codegen is installed, use these steps to run the examples in this repository:

Install the Codegen CLI globally

uv tool install codegen

Initialize Codegen in your project

codegen init

Activate the virtual environment

source .codegen/.venv/bin/activate

Your environment is now ready to run example codemods.

To configure your IDE for optimal use with Codegen, follow our IDE setup guide.

Within the examples folder, each subdirectory contains a self-contained example with:

• An explanation of the transformation (README.md)
• A Codegen script that performs the transformation (run.py)
• Sample code to transform, if not using a repository (input_repo/)

To see a transformation, simply run the run.py script within the desired directory.

• Documentation
• Getting Started Guide
• Tutorials
• API Reference

Have a useful example to share? We'd love to include it! Please see our Contributing Guide for instructions.

The Apache 2.0 license.