QPyPack

简体中文 | English | 繁體中文 | 日本語 | 한국어 | Français | Deutsch | Español | Русский | Português

A Modern Cross-Platform Python Application Packaging & Compilation Suite Powered by PyInstaller and Nuitka

QPyPack is a visual GUI tool designed to simplify Python application packaging workflows. It deeply integrates two major compilation engines—PyInstaller and Nuitka—converting tedious CLI arguments into an intuitive graphical interface, helping developers generate cross-platform native executables efficiently and reliably.

---

📷 Screenshots

---

🚀 Key Features

QPyPack addresses configuration complexity, missing implicit dependencies, cross-platform glitches, and high compilation failure rates in traditional CLI workflows:

1. Modern UI & Intuitive UX

• 📥 Drag & Drop Workspace: Simply drop .py or .pyw source files into the window; QPyPack will automatically parse and initialize the workspace.
• 🎨 Pure Vector Icon Stack (Material Design SVG)：Cleaned up emoji icons in favor of Google Material SVG vector icons, completely eliminating font fallback issues and alignment glitches across Linux and older Windows systems.
• 🌐 Native i18n Support: Multilingual UI support out-of-the-box (English, Simplified/Traditional Chinese, German, French, Japanese, Korean, etc.) with auto-detection and live switching.
• 📊 Dual-Mode Live Log Viewer: Toggle between "Concise" and "Detailed" log panels with real-time build status tracking, error highlighting, and log export.

2. Dual Compilation Backends & Compiler Sniffing

• ⚙️ PyInstaller & Nuitka Integration: Seamlessly switch engines via GUI, with dynamic UI controls that adapt based on the selected backend.
• 🔍 Smart Compiler Auto-Detection: Automatically sniffs and prioritizes system C/C++ compilers for Nuitka, including MSVC, Clang (LLVM), and Zig (optimized for Python 3.13+ C backends).
• 💻 Platform Compatibility Matrix: Real-time status cards displaying OS support (Windows 7/8/10/11, macOS, Linux) for selected Python interpreters with official download shortcuts.

3. Robust Dependency Resolution & Zero-Config Presets

• 🛡️ Isolated Virtualenv Sandbox: Create pristine temporary build sandboxes with one click, eliminating global package pollution and minimizing output binary sizes.
• 🔍 Triple-Layer Dependency Protection: Reads requirements.txt, runs deep native AST (Abstract Syntax Tree) static analysis, and executes pipreqs to automatically catch hidden imports.
• 📦 Zero-Config Third-Party Presets: Built-in automated handling for error-prone libraries like ttkbootstrap, customtkinter, playwright, moviepy, and more.
• ⚡ Multi-Mirror PIP Management: Integrated PyPI mirror presets with automatic fallback to secondary index sources on network timeout.

4. Build Resilience & Self-Healing Fallbacks

• 📏 Pre-flight Resource Evaluation: Assesses available RAM and disk space before build, dynamically adjusting CPU concurrency.
• 🛡️ OOM Fallback Recovery: Automatically triggers single-thread retry mode (--jobs=1) when catching ZstdError / Out-Of-Memory exceptions.
• 🛡️ Antivirus/Icon Lock Resilience: Automatically strips icon parameters and retries build if icon resource writing is blocked by security software or system locks.
• ☁️ Cloud Storage Lock Alerts: Detects file synchronization locks caused by OneDrive, Dropbox, or other cloud drives and provides clear diagnostic tips.

5. Data File Management & Metadata Injection

• 📝 PE / Plist Metadata Injection: Configure version strings, company names, and application descriptions via GUI; automatically writes Windows PE VersionInfo or macOS Info.plist bundles.
• 📂 Visual Data Files Management: Manage supplementary files and directories in a structured list with inline double-click editing for relative output destination paths.

---

⚡ Quick Start

Method 1: Install via pip

Ensure you are using Python >= 3.8:

# Install QPyPack
pip install qpypack

# Launch
qpypack

Method 2: Download Standalone Binaries

Download pre-compiled standalone executables directly from GitHub Releases: 👉 GitHub Releases

---

📅 Changelog

For detailed update history and release notes, please refer to CHANGELOG.md or GitHub Releases.

---

💖 Sponsorship

QPyPack is an open-source project developed and maintained by the author in their free time. If QPyPack has improved your efficiency or solved packaging challenges, consider supporting the project with a voluntary donation:

• ⚡ Buy the Author a Coffee: Sponsor QPyPack

Note

: Sponsorship is completely voluntary and represents unconditional encouragement to open-source development, involving no commercial commitments or specific feature promises. Thank you for your support!

---

📄 License

Open-sourced under the GNU General Public License v3.0.

Note

Regarding Binary Product Licensing: Binaries and applications built using QPyPack are entirely owned by the user. QPyPack's GPL-3.0 license does not restrict or apply to your compiled output binaries.

Copyright (C) 2026 QwejayHuang.