# navdeep-G/setup.py

📦 A Human's Ultimate Guide to setup.py.

Repository: https://github.com/navdeep-G/setup.py
Canonical: https://ross.abutalabs.com/products/setuppy
Homepage: https://github.com/navdeep-G/setup.py/blob/master/setup.py
Language: Python
License: MIT
License Family: permissive
Topics: python, guide, setuptools, distutils, packaging, kennethreitz, forumans
Last push: 2023-02-08T17:57:56+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3292, "days_push": 1302, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5040, forks 548 (observed 2026-08-28T04:09:08.790473+00:00)

## What it is
A guide and example setup.py template for Python packaging, offering a well-commented, best-practice setup.py that can be copy-pasted to bootstrap new Python projects. It includes advanced patterns like a universal wheel/sdist upload command to PyPI via Twine with automatic git tagging.

## Use cases
- bootstrap a setup.py for a new python package
- learn best practices for python packaging
- upload a package to pypi with twine
- create universal wheels and sdists
- find a copy-paste setup.py template
- understand setuptools and distutils configuration

## When to choose
- you are starting a new Python package and need a solid setup.py
- you want a commented reference for setuptools patterns
- you want a simple upload-to-PyPI workflow without setup.cfg

## When to avoid
- you use modern packaging tools like pyproject.toml, Poetry, Flit, or Hatch
- you need actively maintained packaging tooling rather than a reference guide
- you need a full project scaffolding tool like Cookiecutter

## Facets
- artifact type: learning-resource
- maturity: maintenance
- function: developer-tools, build-tool, package-manager, documentation, boilerplate
- domain: developer-tools, tutorials, documentation
- platform: python, cli, cross-platform
- tags: setup-py, setuptools, python-packaging, pypi, twine, guide, example-template, copy-paste

## Member repositories
- navdeep-G/setup.py (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:08.790473+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-29T18:17:24.317271+00:00, confidence not recorded.
  - readme: https://github.com/navdeep-G/setup.py (fetched 2026-08-28T04:09:08.790473+00:00, sha 2ea059e74594)
  - homepage: https://github.com/navdeep-G/setup.py/blob/master/setup.py (fetched 2026-08-29T08:57:54.567846+00:00, sha 56409df16c0b)
- Data as of 2026-08-30T08:39:29.467469+00:00.