---
id: bump2version
version: "1.0.1"
license: MIT
license_treatment: permissive
maintenance: aging
---

# bump2version — Version-bump your software with a single command!

License: permissive · Maintenance: aging · Downloads: 2.3M/mo

## What it is and what it does

bump2version is a maintained fork of the bumpversion project that simplifies software releases by automating version updates across your codebase. It reads your current version, increments the part you specify (major, minor, patch, or custom), updates all version strings in configured files, and optionally creates a commit and tag in Git or Mercurial. The tool works with any text-based file format and supports highly configurable version formats through configuration files (.bumpversion.cfg or setup.cfg) or command-line arguments.

You can run it as a simple one-liner for single-file operations or use a configuration file for complex multi-file projects. It supports templated commit messages and tag names with access to version parts, environment variables, and timestamps. The package has no runtime dependencies and installs cleanly on modern Python versions.

Use it for:

- Automate version bumping in CI/CD pipelines before publishing releases to PyPI or other package repositories.
- Maintain consistent version strings across multiple files (setup.py, __init__.py, package.json, etc.) in a single operation.
- Create annotated or lightweight Git tags and commits automatically when releasing new versions of your software.
- Customize version formats and increment logic for non-standard versioning schemes using parse and serialize configuration.
- Integrate version bumping into pre-release workflows with templated commit messages that include build numbers or timestamps.

## Worth the install?

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

A command-line tool that automates version bumping across your source code by updating version strings, creating commits, and tagging releases in Git or Mercurial.

Yes, if you need reliable automated version bumping. The package has low install friction, no dependencies, and permissive licensing. However, be aware it is aging (last release 2020-10-07) and consider verifying compatibility with your specific Python version and VCS setup before adopting it in production workflows. The maintained fork status and active repository suggest ongoing support, but infrequent releases may indicate limited active development.

## Install

pip install bump2version
uv add bump2version
poetry add bump2version

## Installing bump2version

Before you install: Low install friction with no runtime dependencies. The package is aging (last release 2020-10-07) but the repository remains active and unarchived with recent commits (2025-02-20), suggesting maintenance continues despite infrequent releases.

License in practice: MIT license is permissive, allowing commercial and private use with minimal restrictions—you may use, modify, and distribute this package freely as long as you include the license notice.

Quickstart:

pip install bump2version

bump2version --current-version 0.5.1 minor src/VERSION

# Or with a config file (.bumpversion.cfg):
bump2version patch

Requires Python 3.5 or later; Git or Mercurial must be installed if you want to create commits and tags.

Verify before relying:

- Whether the package's aging status (last release 2020-10-07) affects compatibility with modern Python versions beyond 3.8.
- Current state of the maintained fork relative to the original bumpversion project and whether migration is recommended.
- Whether pre-commit hook integration and environment variable handling (BUMPVERSION_CURRENT_VERSION, BUMPVERSION_NEW_VERSION) work reliably in modern CI/CD environments.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 2.3M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

version bump automation, semantic versioning tool, release version management, git tag and commit automation, version string updater, software release automation, version increment tool, release-automation, version-management, git-integration

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