A Python project build workshop with a Qt GUI, a headless-friendly CLI, a pre-compilation pipeline, and a multi-engine system.
Build Python apps with a predictable workflow, a configurable pre-compile pipeline, and the freedom to choose your build engine.
- BCASL pre-compile pipeline: validation, preparation, transformation before the build, with safety controls.
- Unified EngineRunner architecture: a single source of truth for both CLI and GUI compilation, ensuring identical build results across all interfaces.
- BuildContext-driven builds: engines receive a normalized project context, abstracting away the source of configuration (YAML vs. Lock files).
- Multi-engine support: switch between PyInstaller, Nuitka, and cx_Freeze seamlessly.
- Extensible SDKs: create new engines and BCASL plugins using simplified, consolidated APIs.
- Core auto-mapping for 80+ libraries: automatic import detection from requirements and imports covers major AI, modern web, data science, and automation stacks, with engine-specific arguments applied through the engine mapping layer.
- Simplified build inclusions:
build.includeforces package bundling and ARK translates it automatically per engine. - Workspace-first UI: filter files, manage exclusions, and follow progress and logs in one place.
- Venv-aware execution: engines can use the project virtual environment automatically.
- Theme-aware dynamic UI: 100% dynamic integration using QPalette and themed SVGs.
git clone https://github.com/raidos23/PyCompiler_ARK.git
cd PyCompiler_ARK
pip install -e .pip install pycompiler-arkpycompiler_ark gui
# or
python -m pycompiler_ark guiThe PyCompiler ARK CLI provides a structured set of commands for workspace management, building, and developer tasks.
# Workspace Initialization
pycompiler_ark init --entry <path> [--icon <path>] [--with-venv] [--install-requirements] [--generate-requirements] [--apply-internal] [-y|--yes]
# Building
pycompiler_ark build [-y|--yes] [-v|--verbose] [--json]
pycompiler_ark build --engine <id> [-y|--yes]
pycompiler_ark build --lock [file] [-y|--yes]
# Execution
pycompiler_ark run bcasl [-y|--yes] [--list-plugins]
# GUI
pycompiler_ark gui
pycompiler_ark gui --legacy# Discovery
pycompiler_ark list engines
pycompiler_ark list plugins
# Configuration
pycompiler_ark set user-engine-dir <path>
pycompiler_ark set user-plugin-dir <path>
pycompiler_ark set dev-engine-dir <path>
pycompiler_ark set dev-plugin-dir <path>
pycompiler_ark get user-engine-dir
pycompiler_ark get user-plugin-dir
pycompiler_ark get dev-engine-dir
pycompiler_ark get dev-plugin-dir
pycompiler_ark unset user-engine-dir
pycompiler_ark unset user-plugin-dir
pycompiler_ark unset dev-engine-dir
pycompiler_ark unset dev-plugin-dir
# Scaffolding
pycompiler_ark scaffold engine <name> [--path <dir>]
pycompiler_ark scaffold plugin-bcasl <name> [--path <dir>]For CI/CD and scripting, key commands support the --json flag to return machine-readable results:
pycompiler_ark build --json
pycompiler_ark init --entry main.py --jsonark.yml: Project metadata, build entrypoint, build include/exclude rules, and global BCASL activation.bcasl.yml: Detailed BCASL pipeline configuration, plugin settings, and execution order.
Apache-2.0 (see LICENSE).