# audreyfeldroy/cookiecutter-pypackage

Cookiecutter template for a Python package.

Repository: https://github.com/audreyfeldroy/cookiecutter-pypackage
Canonical: https://ross.abutalabs.com/products/cookiecutter-pypackage
Language: Python
License: MIT
License Family: permissive
Last push: 2026-08-17T18:41:09+00:00

## Health v2 (maintenance only)
Score: 90/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 75, longevity 100
- inputs: {"age_days": 4798, "days_push": 16, "days_rel": 169, "gap_med": 29, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4597, forks 1790 (observed 2026-08-28T04:08:54.771422+00:00)

## What it is
A Cookiecutter template that scaffolds a production-ready Python package with modern tooling (uv, ruff, ty, pytest, Typer) and security-hardened GitHub Actions CI/CD including automated PyPI publishing. It is run via `uvx cookiecutter-pypackage` to generate a new project from prompts.

## Use cases
- scaffold a new python package
- create a pypi package with ci/cd
- generate a python project template with uv and ruff
- bootstrap a python cli package with typer
- set up automated pypi publishing via trusted publishers
- start a python package with github actions workflows

## When to choose
- starting a brand-new Python package and wanting modern tooling preconfigured
- you want automated, tokenless PyPI publishing with Sigstore attestations
- you prefer uv, ruff, and just-based workflows out of the box

## When to avoid
- adding templating to an existing codebase
- you need a template for non-Python languages
- you require a different CI provider than GitHub Actions

## Facets
- artifact type: learning-resource
- maturity: active
- function: developer-tools, build-tool, ci-cd, linter, testing, documentation
- domain: developer-tools
- platform: python, cli, cross-platform
- tags: cookiecutter, template, python-package, pypi-publishing, github-actions, uv, boilerplate-generator, boilerplate, python, packaging

## Member repositories
- audreyfeldroy/cookiecutter-pypackage (main) score 90

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:54.771422+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T08:31:25.054555+00:00, confidence not recorded.
  - readme: https://github.com/audreyfeldroy/cookiecutter-pypackage (fetched 2026-08-28T04:08:54.771422+00:00, sha 4957d379798f)
  - registry_pypi: https://pypi.org/pypi/cookiecutter-pypackage/json (fetched 2026-08-29T09:05:07.304455+00:00, sha c8dfa3873e68)
- Data as of 2026-08-30T08:39:29.467469+00:00.