Skip to content

GitVersioned Logo

GitVersioned

Opinionated PEP 440 Python versioning for Git repos and submodules. Enforces CI/User authority and generates rich version.py files with deep metadata for auditability. Native Hatch & Setuptools support. Simple, predictable, and foolproof automation.

Get Started View on GitHub

Overview

User Flow Diagram

What's Included

Getting Started

Installation guide, quick start tutorial, and common workflow walkthroughs.

Get Started

Guides

Step-by-step guides for common tasks, integrations, and configuration patterns.

Browse Guides

Examples

Runnable code examples that demonstrate real-world usage of GitVersioned.

See Examples

Reference

Full API reference and configuration schema.

View Reference

Community

Contributing guide, developer setup, Code of Conduct, and support resources.

Get Involved

Security

Our security policy, responsible disclosure process, and supported versions.

Security Policy

Quick Install

Build Configuration

GitVersioned is primarily used as a build plugin. The preferred pathway is to configure it in your pyproject.toml:

[build-system]
requires = ["hatchling", "gitversioned"]
build-backend = "hatchling.build"

[tool.hatch.version]
source = "gitversioned"

For advanced installation options, Setuptools alternatives, and step-by-step onboarding, see the Installation Guide.