uv-dynamic-versioning
Dynamic versioning based on VCS tags for uv/hatch project
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later; does not currently work with the uv build backend (only with hatchling).
- 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 · maintenance · safety
permissive license (permissive) — MIT License permits unrestricted use, modification, and distribution with minimal restrictions, making it safe for both open-source and commercial projects.
last release 2026-03-22 (145 days) · last repo commit 2026-08-11 · 201 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 8,631,606 downloads/mo, #1,601 on PyPI
Alternatives
Verify before relying
# 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>[^'\"]*)['\"]"- Whether the monorepo metadata hook feature works reliably across complex dependency graphs
- Performance impact when used in large monorepos with many interdependent packages
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 on this page. Verify before relying on it.
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
uv-dynamic-versioning on PyPI
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.
Requires Python 3.10 or later; does not currently work with the uv build backend (only with hatchling).
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>[^'\"]*)['\"]"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 | permissive license permissive |
| Python support | Supports the current Python release <4.0,>=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 4 packagesdunamaihatchlingjinja2tomlkit |
| Maintenance | Actively maintained 145 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 8,631,606 / month, #1,601 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Framework :: HatchLicense :: OSI Approved :: MIT LicenseProgramming Language :: PythonProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14 |
Evidence: uv_dynamic_versioning-0.14.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “hatch dynamic versioning”
- uv-dynamic-versioningA Hatch plugin that automatically derives package versions from VCS…
- versioningitAutomatically determines your Python package's version from Git or…
- hatch-vcsA Hatch plugin that automatically determines your project's version…
Give your agent the search over MCP, or paste the wish link into any chat.
More Build Tools packages
Provides reusable utilities for Python packaging interoperability, including version handling, specifiers, markers, requirements, tags, and metadata parsing according to standards like PEP 440 and PEP 425.
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
pip is the standard installer for Python packages, enabling you to download and install packages from the Python Package Index and other indexes into your Python environment.
Hatchling is a standards-compliant Python build backend that handles packaging, metadata, and distribution of Python projects when configured in a project's pyproject.toml file.
Generates Python gRPC service stubs and message classes from Protocol Buffer definitions, enabling developers to build gRPC clients and servers.
pre-commit is a framework for installing and running git hooks written in any language before commits are made, automating code quality and validation checks across multi-language projects.
Install it if your team needs consistent, automated validation at commit time.
See also hatch-vcs · hatchling-autoextras-hook · poetry-dynamic-versioning · versioningit · dunamai · uv-sort · hatch_build_scripts · hatch-regex-commit · hatch-requirements-txt