Cookiecuter Python Package¶

Modern cookiecutter template for creating Python packages with complete CI/CD setup and automatic PyPI publishing.

Quick Start¶

Using cookiecutter directly¶

# Install cookiecutter
pip install cookiecutter

# Create project
cookiecutter https://github.com/serafinovsky/cookiecutter-uv-package

# Setup development environment
cd your-project-name
make dev-setup

Using CLI tool¶

# Install the CLI tool
pip install cookiecutter-uv-package

# Create project with CLI
cookiecutter-uv-package

# Or with custom options
cookiecutter-uv-package --output-dir /path/to/projects --no-input

# Setup development environment
cd your-project-name
make dev-setup

Key Features¶

Modern Tools¶

Hatchling, uv, Ruff, MyPy, Pytest - latest Python development tools

Learn more about modern tools →

CI/CD Ready¶

GitHub Actions with automatic PyPI publishing and release management

Learn more about CI/CD →

Code Quality¶

Linting, typing, tests, security checks - all configured automatically

Learn more about code quality →

Docker Support¶

Optional Docker and devcontainer support for convenient development

What You Get¶

• Ready Python package with proper structure
• CI/CD pipeline with GitHub Actions
• Automatic PyPI publishing
• Version management via Release Please
• Complete code quality setup
• Ready-to-use Makefile commands

Documentation¶

• Setup Guide - Step-by-step project creation guide
• Prompt Arguments - All configuration parameters
• Examples - Template usage examples

Example Project¶

See a real example of this template in action: demo-example-package

License¶

MIT License