python-uv-project - Opinionated Python Project Bootstrap

Build a modern Python repo around uv, fast local automation, and predictable quality gates. Prefer current stable releases and avoid unnecessary version pin micromanagement unless the user asks for it.

Default stack

• Bootstrap with uv init, then keep dependency management in uv.
• Initialize git immediately and make the repo ready for normal commit flow.
• Use a src/ layout for packages.
• Use pytest for tests.
• Use ruff for formatting and linting.
• Use pyright for type checking.
• Use pydantic (and pydantic-settings when config/env modeling is needed) for strict data contracts.
• Use hatch for version bump operations.
• Drive routine developer commands through Makefile targets: test, format, lint, typecheck.
• Include a practical repo baseline: README.md, LICENSE, .gitignore, .editorconfig, CI, and coverage support.

Standard repo baseline