tbump
Bump software releases
Decision gist · record as of 2026-08-14
No—the project is archived and abandoned with no releases or commits since 2023-09-09. While it has low install friction and no known vulnerabilities, the lack of active maintenance means no bug fixes, security updates, or compatibility improvements for modern Python or git workflows. Consider maintained alternatives for new projects or critical release automation.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.7 or later.
- A git repository and tbump.toml configuration file are required to run version bumps.
- Low install friction with four straightforward runtime dependencies.
License · maintenance · safety
BSD-3-Clause (permissive) — BSD-3-Clause is permissive and poses no restrictions on commercial or private use, modification, or redistribution, though you must retain the license notice.
last release 2023-09-09 (1070 days) · last repo commit 2026-02-20 · 173 stars · archived
0 known vulnerabilities (OSV.dev, 2026-08-14) · 186,958 downloads/mo, #9,973 on PyPI
Alternatives
Verify before relying
pip install tbump
tbump init 1.0.0
tbump 1.0.1- Whether the archived status and lack of maintenance since 2023 affects compatibility with modern git or Python workflows.
- Whether the 173 GitHub stars reflect active community forks or maintained alternatives.
What it is and what it does
tbump is a command-line tool that automates the process of bumping your project's version number. It reads a configuration file (tbump.toml or pyproject.toml) that specifies which files contain the version string and how to match it, then replaces the old version with the new one across all listed files. Before making any changes, it displays a preview of all modifications and waits for your confirmation, allowing you to abort if something looks wrong.
Once confirmed, tbump patches the files, optionally runs custom shell commands (hooks) before and after committing, creates a git commit with a templated message, tags the commit with an annotated tag, and pushes both the commit and tag to the remote repository. It supports advanced features like restricting replacements to specific lines via regex patterns, custom version templates for complex versioning schemes, and per-field default values. The tool is designed to be used as a standalone CLI application, typically installed via pipx.
Use it for
- Automate routine version bumps in Python projects by updating setup.py, pyproject.toml, and other version files in one command.
- Enforce consistent version numbering across multiple files and formats with regex-based pattern matching.
- Run pre-release checks or post-release publishing commands as part of the bump workflow.
- Manage complex versioning schemes using custom version templates and field defaults.
- Reduce human error in release workflows by automating git operations with a single interactive command.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
No—the project is archived and abandoned with no releases or commits since 2023-09-09.
While it has low install friction and no known vulnerabilities, the lack of active maintenance means no bug fixes, security updates, or compatibility improvements for modern Python or git workflows. Consider maintained alternatives for new projects or critical release automation.
Install
tbump on PyPI
Before you install
Low install friction with four straightforward runtime dependencies. However, the project is archived and abandoned as of its last commit in 2026-02-20, with no releases since 2023-09-09—over 1070 days ago. No active maintenance or security updates should be expected.
Requires Python 3.7 or later. A git repository and tbump.toml configuration file are required to run version bumps.
License in practice
BSD-3-Clause is permissive and poses no restrictions on commercial or private use, modification, or redistribution, though you must retain the license notice.
Quickstart
pip install tbump
tbump init 1.0.0
tbump 1.0.1Verify before relying
- Whether the archived status and lack of maintenance since 2023 affects compatibility with modern git or Python workflows.
- Whether the 173 GitHub stars reflect active community forks or maintained alternatives.
Package facts
| License | BSD-3-Clause permissive |
| Python support | Supports the current Python release >=3.7,<4.0 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 4 packagesdocoptcli-uischematomlkit |
| Maintenance | Abandoned 1,070 days since the last release |
| Last repo commit | repository archived |
| First released | |
| Downloads | 186,958 / month, #9,973 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: BSD LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9 |
Evidence: tbump-6.11.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
An agent finds packages by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language. Give your agent the search over MCP.
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 bump2version · bumpversion · bump-my-version · hatch-regex-commit · bump · release-tag · python-semantic-release · commitizen · commit-check · pip-upgrader