---
id: hatch-vcs
version: "0.5.0"
license: MIT
license_treatment: permissive
maintenance: aging
---

# hatch-vcs — Hatch plugin for versioning with your preferred VCS

License: permissive · Maintenance: aging · Popularity: top 1,000 on PyPI

## Install

pip install hatch-vcs
uv add hatch-vcs
poetry add hatch-vcs

## Description

# hatch-vcs

| | |
| --- | --- |
| CI/CD | [![CI - Test](https://github.com/ofek/hatch-vcs/actions/workflows/test.yml/badge.svg)](https://github.com/ofek/hatch-vcs/actions/workflows/test.yml) [![CD - Build](https://github.com/ofek/hatch-vcs/actions/workflows/build.yml/badge.svg)](https://github.com/ofek/hatch-vcs/actions/workflows/build.yml) |
| Package | [![PyPI - Version](https://img.shields.io/pypi/v/hatch-vcs.svg?logo=pypi&label=PyPI&logoColor=gold)](https://pypi.org/project/hatch-vcs/) [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/hatch-vcs.svg?logo=python&label=Python&logoColor=gold)](https://pypi.org/project/hatch-vcs/) |
| Meta | [![Hatch project](https://img.shields.io/badge/%F0%9F%A5%9A-Hatch-4051b5.svg)](https://github.com/pypa/hatch) [![code style - black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) [![types - Mypy](https://img.shields.io/badge/types-Mypy-blue.svg)](https://github.com/ambv/black) [![License - MIT](https://img.shields.io/badge/license-MIT-9400d3.svg)](https://spdx.org/licenses/) [![GitHub...

## AI interpretation — verify before relying

A Hatch plugin that automatically determines your project's version from version control system tags (Git, Mercurial) and can inject that version into build artifacts and metadata.

Verdict: A stable, low-friction plugin for teams already using Hatch who want version numbers driven by VCS tags. No known vulnerabilities and permissive licensing make it safe to adopt. Aging maintenance (443 days since last release) is typical for mature build tools but means slower bug fixes if issues arise.

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