Introducing uv-version-bumper: Simple Version Bumping with uv

If you're using uv as your Python package manager and want a minimal way to bump versions and tag releases, I just published a small helper project: uv-version-bumper.

What It Does

This tool automates a few common steps:

• Verifies your git repository is clean
• Bumps your project version (patch, minor, or major)
• Updates your uv lock file
• Commits the changes
• Creates a git tag

All of this is done via a simple justfile, which you can run using uvx—so there's no need to install just manually.

How to Use It

1. Copy the justfile into your project root.
2. Run commands like:

1
2

uvx --from just-bin just bump-patch
uvx --from just-bin just push-all

This will bump the version, update the lock file, commit the changes, and push the tag to your git remote.

Why

Until uv adds native support for task automation (issue #5903), this setup offers a lightweight workaround without leaving the uv ecosystem.

Try It

Repo is here: https://github.com/alltuner/uv-version-bumper

MIT licensed. Feedback welcome.