| ## 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 | |