Need help with python-semantic-release?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

374 Stars 123 Forks MIT License 675 Commits 41 Opened issues


Automatic semantic versioning for python projects

Services available


Need anything else?

Contributors list

Python Semantic Release

|Test Status| |PyPI Version| |conda-forge version| |Read the Docs Status|

Automatic Semantic Versioning for Python projects. This is a Python implementation of

_ for JS by Stephan Bönnemann. If you find this topic interesting you should check out his
talk from
JSConf Budapest

The general idea is to be able to detect what the next version of the project should be based on the commits. This tool will use that to automate the whole release, upload to PyPI and post changelogs to GitHub. You can run the tool on a CI service, or just run it locally.



python3 -m pip install python-semantic-release semantic-release --help

Python Semantic Release is also available from

_ or as a
GitHub Action
. Read more about the setup and configuration in our
getting started guide

.. _semantic-release: .. _talk from JSConf Budapest: .. _getting started guide: .. _GitHub Action: .. _conda-forge:

.. |Test Status| image:: .. |PyPI Version| image:: .. |conda-forge Version| image:: .. |Read the Docs Status| image::

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.