Skip to content

AI Assistants

AI coding assistants change how Python developers write code, but they need to be configured to use the modern toolchain: uv, Ruff, Pyrefly, pytest. The handbook covers configuration, project initialization, and the supervisory practices that keep AI-generated code maintainable.

Set up your assistant

Claude Code + uv
Configure Claude Code for uv projects
Cursor + uv
Configure Cursor for uv projects
CLAUDE.md template
A starter template for AI assistants

Start a new project with AI

With Claude Code
Tutorial: scaffold a uv project for Claude Code
With Cursor
Cursor rules for a uv project
Complete Guide to Claude Code
Long-form walkthrough

Supervise the work

Enough git
What you need to know to review AI commits
Project setup for AI
Conventions that keep AI productive

More AI Assistants pages

Everything else tagged ai-assistants, grouped by section. Pages featured above are not repeated here.

How To

How to configure Claude Code to run your pre-commit hooks

Wire pre-commit into Claude Code with hooks. Agents fix violations immediately using the same rules that gate your commits.

How to configure Claude Code to run your pytest suite

Wire pytest into Claude Code with Stop hooks for fast feedback. Sparse tracebacks help agents fix failures efficiently.

How to configure Claude Code to use virtual environments

Make Claude Code use virtual environments via `uv run`, CLAUDE.md rules, env config, or PreToolUse hooks. Shell activation doesn't persist.

How to configure Claude Code with a Python type checker

Integrate type checkers with Claude Code using CLAUDE.md, language-server plugins, Stop hooks, and pre-commit to surface errors during turns, not after.

How to configure Cursor for pytest

Enable pytest in Cursor's Testing sidebar, configure test discovery with pyproject.toml, and add a Cursor rule so the AI agent always runs tests via uv.

How to configure Cursor for Ruff

Configure the Ruff extension in Cursor for format-on-save, auto-fix, and import sorting with .vscode/settings.json setup.

How to configure Ruff with Claude Code

Wire Ruff into Claude Code via CLAUDE.md rules, PostToolUse hooks, and pre-commit for real-time linting.

How to create a new Python project with Codex

Scaffold Python projects with Codex. Pipe the Modern Python Setup Guide URL and let Codex bootstrap the project.

How to install OpenAI's Astral plugins for Claude Code

Install OpenAI's Astral plugin for Claude Code. Get skills and a language server for uv, ruff, and ty with live type diagnostics.

How to Run Parallel AI Coding Agents on One Python Project

Run multiple AI coding agents in parallel with git worktrees and isolated uv environments. Agents edit independently without conflicts.

How to stop AI agents from bypassing pre-commit hooks

Stop AI agents from using git commit --no-verify to skip pre-commit hooks. Implement PreToolUse hooks, deny rules, PATH shims, or CI-level enforcement.

How to use Python skills with Claude Code

Create reusable Claude Code skills to automate Python workflows. Write once, invoke by slash command or natural language description.

How to write Claude Code hooks for Python projects

Write Claude Code hooks for uv enforcement, Ruff auto-format, type checking, and project context injection into sessions.

Explanation

Complete Guide to Codex

How to use OpenAI's Codex CLI for Python development: sandbox modes, autonomy levels, project setup, testing, and scripted automation.

Reference

claude code

Claude Code is Anthropic's terminal AI coding agent that edits files, runs commands, and configures uv, Ruff, and pytest via CLAUDE.md, hooks, and MCP.

From the blog

Posts tagged ai-assistants.

Last updated on