A modern, production-ready Python project template using uv for fast dependency management. Pre-configured tooling, pre-commit hooks, and agentic coding support out of the box.
Documentation index: docs/DOCS.md.
- uv for fast dependency management and workspace support (
packages/) - Ruff for linting and formatting
- Mypy for strict type checking
- Pytest with coverage, markers, and importlib mode
- prek for pre-commit hooks (ruff, mypy, pytest, detect-secrets, file validation)
- conventional-pre-commit for commit message validation with required scopes
- Commitizen for version bumping and changelog generation
- Makefile wrappers for common
uv runcommands - GitHub Actions CI (off until you enable triggers) and Dependabot for uv and GitHub Actions updates
- Dev Containers with Python 3.14, zsh, Oh My Zsh, and Powerlevel10k
- Agent support via
AGENTS.mdand.cursor/rules/
- Python 3.14+
- uv
Starting a new project from this template?
Follow this step-by-step guide.
It covers renaming your package, updating configs, and removing every template placeholder.
For an existing project, install and start:
uv sync --dev && uv pip install -e .
prek install --hook-type pre-commit --hook-type commit-msgSee DEVELOPING.md for commands, hooks, commit conventions, and configuration details.
uv run ruff format . # Format
uv run ruff check . # Lint
uv run mypy . # Type check
uv run pytest # Test
prek run --all-files # All pre-commit hooksyour-project/
├── src/your_package/ # Main package (rename for your project)
├── tests/ # Test suite
│ ├── unit/
│ └── integration/
├── packages/ # Workspace members
└── docs/ # Documentation
See docs/DOCS.md for the full map. Agent entry point: AGENTS.md.
[Your License Here]