python-versioneer/python-versioneer

Health v2 · maintenance only

Adoption not part of the score

1093 stars · 152 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Versioneer is a Python tool that manages version strings for setuptools-based projects by deriving them automatically from version-control tags (primarily Git). It eliminates the manual step of updating embedded version numbers during releases.

Use cases

• automatically derive package version from git tags
• stop manually updating version strings in setup.py
• manage versions for sdists built from git tarballs
• keep python package version in sync with VCS
• set up versioning for a setuptools project

When to choose

• your Python package is hosted in Git and built with setuptools
• you want tag-driven, zero-maintenance version numbers
• you distribute both VCS checkouts and release tarballs

When to avoid

• your project doesn't use setuptools
• you prefer modern PEP 621 tooling like setuptools-scm or hatch-vcs
• your VCS is not Git or a supported system

Facets

library · maturity stable

build-tool version-control developer-tools developer-tools version-control python cli cross-platform setuptools versioning git packaging release-automation automation

Member repositories

For agents

markdown · JSON · MCP: product_card(name="python-versioneer/python-versioneer")