QPyPack

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

A Cross-Platform GUI Packaging & Compilation Suite based on 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.

---

📷 Screenshots

---

🚀 Key Features

To reduce configuration overhead in traditional CLI builds and resolve cross-platform environment/dependency conflicts, QPyPack provides the following integrated engineering features:

1. Intuitive Visual Interaction

• 📥 Drag & Drop Loading: Simply drag .py or .pyw source files into the app window; QPyPack will automatically parse and load them into the workspace.
• 🎨 Smart Icon Search & Adaptation: Automatically searches for common icon assets in the source directory (icon.ico, logo.ico, icon.svg, logo.svg), performs format conversion, binds them, and provides high-res previews.
• 🌐 Internationalization (i18n) Support: Native multi-language interface support (English, Simplified Chinese, etc.) with real-time switching, providing a seamless, obstacle-free experience for global developers.

2. Dependency Resolution & Sandbox Isolation

• 🛡️ Virtualenv Sandbox: One-click creation of isolated temporary virtual environments to install only minimal required dependencies, significantly reducing output binary size.
• 🔍 Multi-dimensional Dependency Scanning:
  • Config Sync: Automatically detects and prioritizes requirements.txt in the project directory.
  • AST Static Analysis: Provides deep Abstract Syntax Tree (AST) scanning to extract non-standard modules and automatically complete hidden imports.
• ⚡ Built-in PyPI Acceleration Mirrors: Presets mainstream PyPI mirror channels to drastically speed up package downloading in the sandbox.

3. Advanced Compilation Control

• ⚙️ Dual-Engine Adaptive Switch: Seamlessly switch between PyInstaller and Nuitka. Parameter panels dynamically adapt based on the selected engine.
• 📝 Application Metadata Injection: Write version numbers, company names, and descriptions directly in the UI without editing spec/version files (Supports Windows PE metadata & macOS Info.plist).
• 📂 Visual Data Files Management: Add files or folders via GUI lists with double-click editing support for output relative destination paths.

---

⚡ Quick Start

Method 1: Install via pip

# Install QPyPack
pip install qpypack

# Launch
qpypack

Method 2: Download Standalone Binaries

Download pre-compiled binaries directly from the GitHub Releases page.

---

📅 Changelog

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

---

🤝 Contributing

Issues and Pull Requests are welcome on GitHub Issues!

---

📄 License

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

Copyright (C) 2026 QwejayHuang.