A small Python starter with strict defaults, fast feedback, and a package layout that scales past the first weekend.

The goal is simple: start from a clean baseline, keep the toolchain boring, and make quality checks cheap enough to run all the time.

• uv for dependency and lockfile management
• src/ layout with Hatchling packaging
• Click for a minimal CLI entry point
• Ruff, Pyright, and pytest as the default quality bar
• GitHub Actions for CI, build validation, and release artifacts

make setup-dev
make check
uv run python -m python_template --help
uv run python -m python_template hello

Sample output:

Let's build something fun, Yujeong.

.
├── .github/workflows/
├── src/python_template/
├── tests/
├── .pre-commit-config.yaml
├── Makefile
├── pyproject.toml
└── uv.lock

If your real project wants agent-specific instructions, add AGENTS.md and/or CLAUDE.md later with project-specific guidance. This template does not ship opinionated defaults for them.

This template is intentionally strict by default:

• Ruff enforces formatting, imports, docstrings, naming, typing hygiene, and common bug-prone patterns.
• Pyright runs in strict mode.
• pytest is the default regression layer.

If a real project constraint justifies relaxing a rule, change it deliberately. The default posture is to keep the baseline tight.

The repository ships with three focused workflows:

• ci.yml — lint, typecheck, and test on Python 3.11–3.13
• build.yml — build the package and smoke-test the generated wheel
• release.yml — build and upload release artifacts for version tags

MIT.