Agents.md

Python Environment

Always use uv to run Python scripts and manage dependencies -- never use pip or python directly.

Run scripts with uv run python script.py instead of python script.py.

Install packages with uv add package-name instead of pip install.

To run one-off commands: uv run <command>.

The project uses uv for virtual environment management; do not create venvs manually with python -m venv.

Common Commands

uv run python script.py -- run a script

uv add <package> -- add a dependency

uv sync -- install all dependencies from lockfile

uv run pytest -- run tests