Skip to content

Release Process

Huzefaaa2 edited this page Jan 24, 2026 · 7 revisions

Release Process

Version bump

Update version in pyproject.toml.

Tag and push

git tag -a v0.2.0 -m "v0.2.0"
git push origin v0.2.0

GitHub release

Create a GitHub release from the tag and paste notes from the changelog.

Package publish

python -m pip install build twine
python -m build
python -m twine upload dist/*

Requires a PYPI_API_TOKEN configured for the repo.

CI Release Workflow

The release workflow publishes to PyPI and creates a GitHub release on tag push.

Setup:

  • Add repository secret PYPI_API_TOKEN with your PyPI API token.
  • Push a tag like v0.2.1 to trigger the workflow.

The workflow reads RELEASE_NOTES.md for release body content.

Container Image

On tag pushes, a separate workflow builds and publishes a container image to GHCR:

Clone this wiki locally