---
id: uv-dynamic-versioning
version: "0.14.0"
license: MIT License Copyright (c) 2024 Manabu Niseki Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# uv-dynamic-versioning — Dynamic versioning based on VCS tags for uv/hatch project

License: permissive · Maintenance: active · Downloads: 8.6M/mo

## What it is and what it does

uv-dynamic-versioning is a Hatch plugin that automates package versioning by reading version information from VCS tags (via dunamai) and injecting it into your build. It offers two main features: a version source plugin that sets the package version from git tags, and a metadata hook plugin that can dynamically adjust dependencies based on the detected version—useful for monorepo setups where different versions need different dependency configurations.

The plugin integrates into Hatch's build system through the pyproject.toml [build-system] configuration and works with hatchling as the build backend. It depends on dunamai for VCS tag parsing, jinja2 for templating, and tomlkit for TOML manipulation. The project is actively maintained and used by several high-profile projects including IBM/Agentics, microsoft/agent-framework, and pydantic/pydantic-ai.

Use it for:

- Automatically version Python packages from git tags without manual version bumping in source files
- Manage monorepo projects where different packages need version-specific dependency configurations
- Integrate version information into package metadata at build time without hardcoding versions
- Replace manual version management in pyproject.toml with VCS-driven versioning for CI/CD pipelines

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Hatch plugin that automatically derives package versions from VCS tags and can dynamically set dependencies based on version information, designed for use with uv and hatch build systems.

Yes. This is a well-maintained, actively-used build plugin with low install friction, no security vulnerabilities, and a permissive MIT license. Install it if you use Hatch and want to automate versioning from git tags or manage dynamic dependencies in a monorepo. Note the current limitation: it does not work with the uv build backend, only with hatchling.

## Install

pip install uv-dynamic-versioning
uv add uv-dynamic-versioning
poetry add uv-dynamic-versioning

## Installing uv-dynamic-versioning

Before you install: Low install friction with a pure-Python wheel distribution. Actively maintained with recent releases; last commit on 2026-08-11 and 201 repository stars indicate ongoing development.

License in practice: MIT License permits unrestricted use, modification, and distribution with minimal restrictions, making it safe for both open-source and commercial projects.

Quickstart:

# Add to pyproject.toml [build-system]
[build-system]
requires = ["hatchling", "uv-dynamic-versioning"]
build-backend = "hatchling.build"

# Then configure version source in [tool.hatch.version]
[tool.hatch.version]
source = "regex"
path = "src/__init__.py"
pattern = "__version__ = ['\"](?P<version>[^'\"]*)['\"]"

Requires Python 3.10 or later; does not currently work with the uv build backend (only with hatchling).

Verify before relying:

- Whether the monorepo metadata hook feature works reliably across complex dependency graphs
- Performance impact when used in large monorepos with many interdependent packages

## Package facts

- License: MIT License Copyright (c) 2024 Manabu Niseki Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 8.6M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

hatch dynamic versioning, vcs tag versioning, automatic version from git, hatch build plugin, dynamic dependencies hatch, build-automation, monorepo, vcs-integration

[View on SkillFed](https://skillfed.io/packages/uv-dynamic-versioning) · [View on PyPI](https://pypi.org/project/uv-dynamic-versioning/)