# pypa/setuptools

Official project repository for the Setuptools build system

Repository: https://github.com/pypa/setuptools
Canonical: https://ross.abutalabs.com/products/setuptools
Homepage: https://pypi.org/project/setuptools/
Language: Python
License: MIT
License Family: permissive
Last push: 2026-08-09T13:06:58+00:00

## Health v2 (maintenance only)
Score: 97/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 96, release rhythm 96, longevity 100
- inputs: {"age_days": 3809, "days_push": 24, "days_rel": 25, "gap_med": 3.0, "n_releases_24m": 49}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2854, forks 1422 (observed 2026-08-28T04:07:25.803905+00:00)

## What it is
Setuptools is the official build system and packaging library for Python, enabling developers to build, package, and distribute Python projects as wheels and sdists. It extends distutils and supports modern pyproject.toml-based configuration.

## Use cases
- build a wheel for my python package
- define package metadata in pyproject.toml
- package and publish my library to pypi
- declare dependencies and entry points for a python project
- build an sdist for distribution
- migrate from distutils to a modern build backend
- install a package in editable/development mode

## When to choose
- you are packaging a Python library or application for distribution on PyPI
- you need a mature, widely supported build backend for pyproject.toml
- you need editable installs, entry points, or package data handling

## When to avoid
- you are building a non-Python project
- you only need a modern alternative like hatchling, flit, or poetry-core and have no legacy setuptools constraints
- you need a dependency manager rather than a build system

## Facets
- artifact type: library
- maturity: stable
- function: build-tool, package-manager, developer-tools
- domain: developer-tools, programming-languages
- platform: python, cross-platform
- tags: packaging, distutils, pypi, setup-py, pyproject-toml, wheels, sdists, automation

## Member repositories
- pypa/setuptools (main) score 97

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:25.803905+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-30T07:36:45.912034+00:00, confidence not recorded.
  - readme: https://github.com/pypa/setuptools (fetched 2026-08-28T04:07:25.803905+00:00, sha ad1ff105e33a)
  - homepage: https://pypi.org/project/setuptools/ (fetched 2026-08-29T09:52:20.750064+00:00, sha 4b4e8fead74a)
- Data as of 2026-08-30T08:39:29.467469+00:00.