bumpversion
Version-bump your software with a single command!
Decision gist · record as of 2026-08-14
No. The project is abandoned (last release 2020-05-14, Development Status :: 7 - Inactive). The maintainers explicitly recommend installing the maintained fork bump2version instead. If you need version bumping automation, use bump2version or another actively maintained alternative.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Git or Mercurial to be installed for commit and tag functionality; works with text files only and is language-agnostic.
- Installation is straightforward with low friction, but the project is abandoned as of 2020-05-14.
- The maintainers explicitly recommend installing a maintained fork (bump2version) instead.
License · maintenance · safety
MIT (permissive) — MIT license is permissive and poses no restrictions on use, modification, or distribution in commercial or private projects.
last release 2020-05-14 (2283 days) · last repo commit 2023-07-14 · 1,519 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 1,227,709 downloads/mo, #4,190 on PyPI
Alternatives
Verify before relying
pip install bumpversion
bumpversion --current-version 0.5.1 minor src/VERSION- Whether the package remains compatible with modern Python versions beyond those listed (3.2–3.4 are quite old).
- Current state of the fork (bump2version) and whether it is truly the recommended replacement.
- Whether the package's configuration file parsing works reliably with contemporary .bumpversion.cfg formats.
What it is and what it does
bumpversion is a command-line tool for automating version increments across your codebase. It reads the current version from your configuration or command line, increments the part you specify (major, minor, patch, or custom), and updates all occurrences in your source files. It can optionally create a commit and tag in Git or Mercurial with a templated message.
The tool is language-agnostic—it works on any text file—and supports highly configurable version formats via regex parsing and serialization rules. You can define custom version parts (e.g., alpha, beta, release names) and control which files get updated. However, the project is abandoned and its maintainers recommend using the maintained fork bump2version instead.
Use it for
- Automate version bumps in CI/CD pipelines before building and releasing software packages.
- Keep version strings synchronized across setup.py, package.json, version files, and documentation in a single command.
- Create consistent Git tags and commit messages when releasing new versions of a project.
- Manage complex versioning schemes with custom parts (e.g., alpha/beta/release stages) across multiple files.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
No.
The project is abandoned (last release 2020-05-14, Development Status :: 7 - Inactive). The maintainers explicitly recommend installing the maintained fork bump2version instead. If you need version bumping automation, use bump2version or another actively maintained alternative.
Install
bumpversion on PyPI
Before you install
Installation is straightforward with low friction, but the project is abandoned as of 2020-05-14. The maintainers explicitly recommend installing a maintained fork (bump2version) instead. The last commit was 2023-07-14, but this appears to be repository metadata only, not active development.
Requires Git or Mercurial to be installed for commit and tag functionality; works with text files only and is language-agnostic.
License in practice
MIT license is permissive and poses no restrictions on use, modification, or distribution in commercial or private projects.
Quickstart
pip install bumpversion
bumpversion --current-version 0.5.1 minor src/VERSIONVerify before relying
- Whether the package remains compatible with modern Python versions beyond those listed (3.2–3.4 are quite old).
- Current state of the fork (bump2version) and whether it is truly the recommended replacement.
- Whether the package's configuration file parsing works reliably with contemporary .bumpversion.cfg formats.
Package facts
| License | MIT permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagebump2version |
| Maintenance | Abandoned 2,283 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 1,227,709 / month, #4,190 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 7 - InactiveIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 2Programming Language :: Python :: 2.7Programming Language :: Python :: 3Programming Language :: Python :: 3.2Programming Language :: Python :: 3.3Programming Language :: Python :: 3.4Programming Language :: Python :: Implementation :: PyPy |
Evidence: bumpversion-0.6.0-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 › “software release helper”
- bumpversionA command-line tool that automates version bumping by updating…
- loggerA Python logging helper that provides utilities for configuring and…
- jaraco.itertoolsProvides additional iterator utilities and helper functions that…
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 · bump2version · bumpver · tbump · Incremental · bump · hatch-regex-commit · keepachangelog · pipupgrade · python-hglib