bump2version
Version-bump your software with a single command!
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.5 or later; Git or Mercurial must be installed if you want to create commits and tags.
- 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 · maintenance · safety
MIT (permissive) — 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.
last release 2020-10-07 (2137 days) · last repo commit 2025-02-20 · 1,115 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 2,278,739 downloads/mo, #3,169 on PyPI
Alternatives
Verify before relying
pip install bump2version
bump2version --current-version 0.5.1 minor src/VERSION
# Or with a config file (.bumpversion.cfg):
bump2version patch- 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.
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 on this page. Verify before relying on it.
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
bump2version on PyPI
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.
Requires Python 3.5 or later; Git or Mercurial must be installed if you want to create commits and tags.
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 patchVerify 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 the current Python release >=3.5 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Aging 2,137 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 2,278,739 / month, #3,169 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.5Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: Implementation :: PyPy |
Evidence: bump2version-1.0.1-py2.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 › “version increment tool”
- bump2versionA command-line tool that automates version bumping across your source…
- release-tagAutomatically creates and optionally pushes semantic version git tags…
- keepachangelogParse, manipulate, and generate changelog files in Keep a Changelog…
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 bump-my-version · bumpversion · tbump · bumpver · hatch-regex-commit · Incremental · bump · keepachangelog · python-hglib · gitchangelog