uv-zipapps-gui

A Tkinter-based GUI for zipapps configuration and Python version management via uv.

Features

ZipApps Config — Visual editor for all zipapps build options: entry point, interpreter, pip packages, includes, unzip rules, lazy install, layer mode, and more. Build .pyz files or package distributable bundles (pyz + interpreter + launcher) with one click.
Python Manager — Browse, filter, install, and delete Python versions through uv. Auto-detects installed versions and sets the interpreter path for builds.
Cross-platform — Works on Windows, macOS, and Linux. Generates platform-appropriate launchers (.bat/.vbs on Windows, .sh on Unix).

pip install uv-zipapps-gui

Requires Python >= 3.12 and zipapps >= 2026.4.17.

uv-zipapps-gui
# or run directly without installing:
uvx uv-zipapps-gui

Python Manager tab — Set uv path (auto-detected if in PATH), select a Python version, and click Install Selected.
ZipApps Config tab — Configure build options, then click pyz to build a .pyz file, or Dist to create a distributable package.
Use Load Config / Export Config to save and restore build settings as JSON.

Option	Description
Output (`-o`)	Path of the output `.pyz` file
Interpreter (`-p`)	Python interpreter for the shebang line
Entry point (`-m`)	`package.module:function` format
Pip packages	Packages to install via pip
Includes (`-a`)	Extra paths to copy into the archive
Unzip (`-u`)	Names to extract at runtime (native extensions)
Compress (`-c`)	Deflate compression
Lazy install (`-d`)	Defer pip install to runtime
Layer mode	Serverless-friendly layout without `__main__.py`
Build ID (`-b`)	Skip duplicate builds based on file mtime
Dist	Package pyz + interpreter + launcher for distribution

MIT