Installation

Install and set up Codegen in your development environment.

Prerequisites

We recommend using uv for installation. If you haven’t installed uv yet:

curl -LsSf https://astral.sh/uv/install.sh | sh

Installing Codegen

Install the Codegen CLI globally:

uv tool install codegen

This makes the codegen command available globally in your terminal, while keeping its dependencies isolated.

Quick Start

Let’s walk through a simple example of using Codegen in a project:

Navigate to your repository:
cd path/to/your/project

Initialize Codegen in your project:

codegen init

This creates a .codegen/ directory with:

.codegen/
├── .venv/            # Python virtual environment (gitignored)
├── config.toml       # Project configuration
├── codemods/         # Your codemod implementations
├── jupyter/          # Jupyter notebooks for exploration
└── codegen-system-prompt.txt  # AI system prompt

Create your first codemod with codegen create:
codegen create organize-imports \ -d "Sort and organize imports according to PEP8"
The -d flag in codegen create generates an AI-powered implementation. This requires a Github account registered on codegen.sh
Run your codemod with codegen run:
codegen run organize-imports
Reset any filesystem changes (excluding .codegen/*) with codegen reset:
codegen reset

Next Steps

IDE Integration

Learn how to use Codegen effectively in VSCode, Cursor, and other IDEs.

Tutorials

Follow step-by-step tutorials for common code transformation tasks.

Work with AI

Leverage AI assistants like Copilot, Cursor and Devin

Guides

Learn more about building with Codegen

For more help, join our community Slack or check the FAQ.

Introduction

Tutorials

Building with Codegen

Prerequisites

Installing Codegen

Quick Start

Next Steps

IDE Integration

Tutorials

Work with AI

Guides

​Prerequisites

​Installing Codegen

​Quick Start

​Next Steps

IDE Integration

Tutorials

Work with AI

Guides

Prerequisites

Installing Codegen

Quick Start

Next Steps