Cookiecutter PyPackage

Cookiecutter template for a Python package with production-ready CI and automated PyPI publishing.

uvx cookiecutter-pypackage

What you get

Tooling

CI/CD (GitHub Actions, security-hardened)

All actions pinned by SHA, minimal permissions, no persisted credentials.

Quickstart

Install uv, then:

uvx cookiecutter-pypackage

You'll be prompted for your package name, GitHub username, and a few other values (full list). Then push to GitHub and follow the tutorial to enable Pages and set up PyPI publishing.

Without uvx

uv venv
source .venv/bin/activate
uv pip install cookiecutter
cookiecutter gh:audreyfeldroy/cookiecutter-pypackage

Documentation

audreyfeldroy.github.io/cookiecutter-pypackage

• Tutorial - from generation to first PyPI release
• Project Structure - what's in the generated project
• GitHub Actions - CI, publish, docs deployment, security hardening
• Prompts - what each prompt means
• Troubleshooting

Alternatives

This template is opinionated. If it doesn't fit:

• Browse the fork network for variants
• Create your own template from scratch

Pull requests welcome if they're small, atomic, and improve the template.

Discord | MIT license