python-semantic-release

What it is and what it does

Python Semantic Release is a command-line tool that automates versioning and release workflows for Python projects by analyzing commit messages according to conventional commit standards. It determines when to bump major, minor, or patch versions, generates changelogs, and can publish releases to package repositories and version control platforms.

The tool integrates with git through gitpython and supports multiple hosting platforms through dependencies like python-gitlab and requests. It uses configuration files (parsed via tomlkit) to define release rules and can be run locally or as part of CI/CD pipelines, including as a GitHub Action. The package is actively maintained, supports Python 3.8 through 3.14, and has no known security vulnerabilities.

Use it for:

• Automate version bumps and PyPI releases triggered by commit messages in CI/CD pipelines.
• Generate changelogs automatically from conventional commits without manual version management.
• Enforce semantic versioning discipline across a team by making version changes explicit in commit conventions.
• Integrate release automation into GitHub Actions workflows for hands-off deployment.
• Manage releases to multiple platforms from a single configuration.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Automates semantic versioning and release management for Python projects by parsing commit messages, determining version bumps, and publishing releases according to SemVer conventions.

Yes. The package is actively maintained, has low install friction, carries a permissive MIT license, and solves a real problem in release automation. It is widely used (1840124 monthly downloads, top 5000 PyPI packages), has no known vulnerabilities, and integrates well with modern Python tooling and CI/CD systems. Install it if you want to automate versioning and releases via commit conventions.

Install

python-semantic-release on PyPI

pip install python-semantic-release

uv add python-semantic-release

poetry add python-semantic-release

Installing python-semantic-release

Before you install

Low install friction with a pure-Python wheel distribution. Active maintenance with a recent release 39 days ago and ongoing repository activity. Depends on 13 runtime packages including click, gitpython, requests, and pydantic—all stable, widely-used libraries.

License in practice

MIT license is permissive; you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart

pip install python-semantic-release

python-semantic-release version

Requires git repository context and configured commit message conventions to determine version changes; typically run as a CLI tool.

Verify before relying

• Whether the package supports custom version schemes beyond semantic versioning.
• Integration points with CI/CD systems beyond GitHub Actions (e.g., GitLab, Jenkins).
• Performance characteristics when processing repositories with large commit histories.
• Exact changelog generation capabilities and customization options.

Package facts

Evidence: python_semantic_release-10.6.1-py3-none-any.whl

Tags

More Build Tools packages

Further reading