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
.pyzfiles 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/.vbson Windows,.shon Unix).
Install
pip install uv-zipapps-gui
Requires Python >= 3.12 and zipapps >= 2026.4.17.
Usage
uv-zipapps-gui
# or run directly without installing:
uvx uv-zipapps-gui
Quick Start
- 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
.pyzfile, or Dist to create a distributable package. - Use Load Config / Export Config to save and restore build settings as JSON.
Build Options
| 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 |
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for uv-zipapps-gui 0.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| uv_zipapps_gui-0.4.0.tar.gz | 15.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| uv_zipapps_gui-0.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 31.2 kB
Release files / uv_zipapps_gui-0.4.0.tar.gz
| Download URL | uv_zipapps_gui-0.4.0.tar.gz |
|---|---|
| Size | 15.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8d52517fd416db19f4b4545ff99defd38db182883b6188b13426ea5ab4011f31
|
|
BLAKE2b-256 checksum How to use checksums |
7218c72ff0b17b4b5dbc6f134e8c0daf2a4b4bc8b38c07f441c8bdad7a26405e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-requests/2.33.1
|
Release files / uv_zipapps_gui-0.4.0-py3-none-any.whl
| Download URL | uv_zipapps_gui-0.4.0-py3-none-any.whl |
|---|---|
| Size | 15.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4e634c820a698f09feec45f991af4b88d92fd51740a63481abd217c40f1b7ff7
|
|
BLAKE2b-256 checksum How to use checksums |
02f547f3689c8b6a084a118433dd8529eaea78e0231809825fb1117add2b8ae3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-requests/2.33.1
|
