Installation¶

Quick start¶

$ cd my-project
$ uvx -- repomatic init
$ git add .
$ git commit -m "Update repomatic files"
$ git push

Works for both new and existing repositories. Run repomatic init --help to see available components and options: the workflows then take it from there, opening issues and PRs to guide any remaining setup.

Try it¶

Thanks to uv, you can run it in one command, without installation or venv:

Latest release

$ uvx -- repomatic --help

Specific version

$ uvx -- repomatic==6.13.0 --help

Development version

$ uvx --from "repomatic @ git+https://github.com/kdeldycke/repomatic" -- repomatic --help

Install methods¶

repomatic is available on a couple of package managers:

Easiest way is to install uv, then install repomatic system-wide with the uv tool command:

$ uv tool install repomatic

pip

You can install the latest stable release and its dependencies with a simple pip call:

$ python -m pip install repomatic

If you have difficulties to use pip, see pip’s own installation instructions.

pipx

pipx is a great way to install Python applications globally:

$ pipx install repomatic

Arch Linux

A repomatic package is available on AUR and can be installed with any AUR helper:

$ yay -S python-repomatic

$ paru -S python-repomatic

$ pacaur -S python-repomatic

Python compatibility¶

The table below shows which Python versions each repomatic release range supports, derived from the requires-python field and Programming Language :: Python classifiers across all release tags. Releases prior to 4.0.0 did not declare an explicit requires-python constraint and are not represented.

`repomatic`	Released	`3.8`	`3.9`	`3.10`	`3.11`	`3.12`	`3.13`	`3.14`
`4.25.x` → `6.x`	2025-12-05	❌	❌	✅	✅	✅	✅	✅
`4.20.x` → `4.24.x`	2025-10-10	❌	❌	❌	✅	✅	✅	✅
`4.15.x` → `4.19.x`	2025-03-05	❌	❌	❌	✅	✅	✅	❌
`4.7.x` → `4.14.x`	2024-11-03	❌	❌	✅	✅	✅	✅	❌
`4.4.x` → `4.6.x`	2024-07-27	❌	✅	✅	✅	✅	❌	❌
`4.0.x` → `4.3.x`	2024-06-29	✅	✅	✅	✅	✅	❌	❌

Executables¶

To ease deployment, standalone executables of repomatic’s latest version are available as direct downloads for several platforms and architectures:

Platform	`arm64`	`x86_64`
Linux	Download `repomatic-6.13.0-linux-arm64.bin`	Download `repomatic-6.13.0-linux-x64.bin`
macOS	Download `repomatic-6.13.0-macos-arm64.bin`	Download `repomatic-6.13.0-macos-x64.bin`
Windows	Download `repomatic-6.13.0-windows-arm64.exe`	Download `repomatic-6.13.0-windows-x64.exe`

That way you have a chance to try it out without installing Python or uv. Or embed it in your CI/CD pipelines running on minimal images. Or run it on old platforms without worrying about dependency hell.