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

Run Claude Code Python commands in the project virtual environment using uv run or an explicit interpreter path.

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

Create a Python project with Codex, uv, Ruff, and pytest. Use explicit project instructions, review the generated files, and verify the environment locally.

How to install Astral's plugin for Claude Code

Install Astral's 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 with git worktrees and isolated uv environments. Keep checkouts separate, then review integration conflicts.

How to stop AI agents from bypassing pre-commit hooks

Keep skipped local hooks from reaching main: document check commands, add Claude Code deny rules, and require CI status checks before merging.

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 AGENTS.md for a Python Project

Write shared AGENTS.md instructions with uv commands and quality checks, then verify how Codex, Claude Code, Cursor, and Copilot load them.

How to write Claude Code hooks for Python projects

Write Claude Code hooks for uv command feedback, Ruff formatting, and bounded type-check feedback at turn end.

Explanation

Complete Guide to Codex

Use Codex across the desktop app, IDE, terminal, and cloud. Configure permissions, AGENTS.md, and skills around a reproducible Python workflow.

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