A portable, minimal toolkit for bootstrapping a working Python engineering environment on any machine — a personal workstation, a cloud sandbox, or an unfamiliar box handed to you for the day.
A small, deliberately minimal set of conventions and scripts for standing up a working Python project fast: a virtual environment, a test runner, and a consistent way for a human and a coding agent to work together on the same codebase.
It grows by need, not by anticipation. Nothing is in here that hasn't already earned its place.
git clone <this repo> project
cd project
make bootstrap
make bootstrap creates a local virtualenv (.venv) and installs the
toolkit's base dependencies (pytest, ruff).
If git, gh, or claude aren't installed yet — a genuinely fresh
machine — see BOOTSTRAP.md for the manual install and browser-auth
commands for each.
| Command | What it does |
|---|---|
make bootstrap |
Create .venv, install base dev dependencies |
make test |
Run the test suite (pytest) |
make lint |
Check formatting and lint (ruff) |
make fmt |
Auto-format the codebase (ruff format) |
Start with AGENTS.md — it describes how we work, not just what commands
exist.