Build

How to build executables and release packages. Content is based on the repo README and docs/LINUX_BUILD_SETUP.md.

Build prerequisites

• Python 3.9+
• UV (recommended): pip install uv
• PyInstaller (included as a dependency in this project)

Build: Windows executable

uv sync
uv run python scripts/build_exe.py

Output: dist/

Build: Linux distribution

uv sync
uv run python scripts/build_linux.py

See also the Linux setup guide for distro/AppImage details.

Create releases

Windows release

uv run python scripts/release.py

Linux release

uv run python scripts/release_linux.py

Release output goes to versioned folders (e.g. release-v{version}/ and release-linux-v{version}/).

Troubleshooting (Linux)

• Permission denied: chmod +x scripts/build_linux.py
• Missing dependencies: install required system libs, then retry