A pyrig plugin to build executables.
pyrig-executables is a pyrig plugin that turns your project into standalone executables and attaches one per operating system to every GitHub release — so anyone can run it without installing Python.
- Standalone executables — a single-file binary of your project for Linux, Windows, and macOS, built with PyInstaller.
- Release integration — a matrix build job that compiles and attaches a binary per OS to each release.
- Entry point and icon — a
main.pyand a default icon, both scaffolded and ready to replace with your own. - Bundled resources — your project's resources are bundled into the binary.
- Run command —
pyrig-executables runruns your entry point the same way the built binary does, so you can try it locally. - Downloads badge — a badge showing the total downloads of your binaries.
uv add pyrig-executables --dev
uv run pyrig syncNo tokens or secrets are required — the release workflow uses GitHub's automatic token.
Full documentation, including the auto-generated API reference, is available on the documentation site.