Skip to content

Python Package Template

A production-ready template for starting new Python packages. Clone it, rename a few things, and start building — dependency management, linting, type checking, testing, and CI/CD are already wired up.

Features

  • uv for fast Python package management
  • Ruff for linting and formatting
  • Pyright for static type checking
  • Pytest with coverage for testing
  • GitHub Actions CI/CD with auto-release on merge to main
  • TDD-first development lifecycle

Quick Start

git clone https://github.com/michaelellis003/pypkgkit.git my-project
cd my-project
uv run --script ./scripts/init.py
uv sync
uv run pytest -v --cov

Next Steps

  • API Reference — auto-generated documentation for all public functions