Python Developer Tooling Handbook – Ai-Assistants

uv won developer hearts. Now it has to win READMEs.

Tim Hopper — Tue, 14 Apr 2026 09:00:00 -0400

uv ranked as the most admired technology in Stack Overflow’s 2025 Developer Survey at 74%. A recent analysis by Andrey Aleyan of the top 100,000 Python repositories on GitHub put uv adoption (measured by the presence of uv.lock) at roughly 10%. The gap between “developers love this” and “developers ship this” is wider than any tooling story in recent memory.

Aleyan’s diagnosis is that AI coding agents are the bottleneck: their training data is overwhelmingly pip install -r requirements.txt, so they emit pip install -r requirements.txt. That diagnosis is correct but incomplete. Adoption is bottlenecked by three reinforcing forces, and the AI-agent story is only one of them.

OpenAI to Acquire Astral

Tim Hopper — Thu, 19 Mar 2026 00:00:00 +0000

OpenAI announced today that it will acquire Astral, the company behind uv, Ruff, and ty. The Astral team will join OpenAI’s Codex group after the deal closes, subject to regulatory approval.

What this means for Codex

Codex, OpenAI’s coding agent, has grown to over 2 million weekly active users, with 3x user growth and 5x usage increase since the start of 2026. Acquiring Astral gives OpenAI direct ownership of tools that millions of Python developers already depend on. OpenAI plans to integrate Astral’s tools more deeply into Codex so the agent can interact with the toolchain developers already use.

Charlie Marsh on uv, Coding Agents, and the Changing Open Source Contract

Tim Hopper — Tue, 24 Feb 2026 12:00:00 -0500

Charlie Marsh (founder of Astral, creator of ruff, uv, and ty) joined Michael Chow and Wes McKinney on The Test Set. They covered uv’s adoption strategy, how coding agents are changing Astral’s development process, and what’s happening to open source when writing code becomes cheap.

uv’s compatibility layer was the point

When uv first shipped, it only had uv pip install and uv venv. Some people found this odd. Charlie says it was deliberate:

Seven Claude Code Skills for Python from the Creator of spaCy

Tim Hopper — Mon, 16 Feb 2026 08:00:00 -0500

atthew Honnibal, co-founder of Explosion and creator of spaCy, has published a collection of Claude Code skills for Python development. It’s one of the more thoughtful skill collections I’ve seen.

Claude Code skills are markdown files you place in ~/.claude/commands/. When you type /<skill-name> in Claude Code, the file’s contents are injected as instructions. Think of them as reusable prompts that give Claude a specific methodology for a task, rather than leaving it to improvise.

Pydantic Monty: A Secure Python Interpreter for AI Agents

Tim Hopper — Fri, 06 Feb 2026 10:00:00 -0500

Pydantic has released Monty, a minimal Python interpreter written in Rust for safely executing LLM-generated code.

AI agents that generate code face a tradeoff: trust the generated code completely, or spin up containers for isolation. Containers are slow and resource-intensive. Trusting arbitrary code is risky. Monty sidesteps both by sandboxing execution at the interpreter level, blocking dangerous operations while running Python in microseconds.

How It Works

Monty provides a straightforward API:

Teaching Claude Code Quality Patterns with a Custom Skill

Tim Hopper — Fri, 09 Jan 2026 09:00:00 -0500

Dagster’s dignified-python-313 skill guides Claude Code to write Python 3.13 code that matches their project conventions.

What It Covers

Modern Python 3.13 Patterns: Use native type syntax (list[str], str | None) instead of older alternatives. Skip from __future__ import annotations since Python 3.13 doesn’t need it.

CLI Development: Build Click interfaces with proper error handling. Use click.echo() for output, direct errors to stderr, and treat CLI commands as error boundaries that catch exceptions and exit with SystemExit(1).

ty is Built with AI

Tim Hopper — Fri, 02 Jan 2026 08:00:00 -0500

Tool creators are building their tools with AI coding assistants.

Boris Cherny, creator of Claude Code, didn’t open an IDE in December but wrote 200 PRs with Claude Code. Charlie Marsh, creator of ruff, uv, and ty, noted that all his PRs to ty were created with Claude Code. The tools building themselves.

Integration with Python Tooling

The handbook’s Modern Python Project Setup Guide for AI Assistants provides structured guidance so AI tools default to uv and modern patterns rather than falling back to pip commands.

Teaching LLMs Python Best Practices

Tim Hopper — Fri, 21 Nov 2025 09:00:00 -0500

Large language models possess extensive Python knowledge from training data, yet they consistently struggle with modern tooling practices. Despite being trained on massive amounts of Python code, frontier models often default to outdated patterns like direct python or pip commands instead of using virtual environments and modern tools like uv.

how is it, that despite every frontier LLM being insanely python maxxed they rarely use virtural envs, and even adding rules like "we are using uv, do everything with uv" they ignore it and think the system python is broken. like, every time. that's actually an accomplishment

Claude Code Hooks for uv Projects

Tim Hopper — Tue, 11 Nov 2025 06:00:00 -0500

Claude Code supports custom hooks that guide the AI agent toward project-specific workflows. For Python projects using uv, hooks can prevent Claude from falling back to pip and python commands.

Note

This post builds on the interceptor approach for teaching AI agents about uv. Interceptors provide runtime feedback; hooks prevent problematic commands before execution.

Use Interceptors to teach Claude Code to use uv

Tim Hopper — Mon, 28 Jul 2025 09:34:00 -0400

AI coding agents like Claude Code, Cursor, or GitHub Copilot often default to using system Python interpreters instead of using uv.

Armin Ronacher, creator of Flask and Jinja, shared an elegant solution to this problem: creating dummy Python interpreter that actively redirect AI agents toward better tooling choices.

Tip