---
id: python-semantic-release
version: "10.6.1"
license: MIT
license_treatment: permissive
maintenance: active
---

# python-semantic-release — Automatic Semantic Versioning for Python projects

License: permissive · Maintenance: active · Downloads: 1.8M/mo

## 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 above — 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

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

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

## Tags

semantic versioning automation, automatic release management, commit-based version bumping, semver python projects, release automation tool, version management cli, conventional commits versioning, release-automation, semver, ci-cd

[View on SkillFed](https://skillfed.io/packages/python-semantic-release) · [View on PyPI](https://pypi.org/project/python-semantic-release/)