QBCompiler Python version

English • Türkçe

---

English Documentation

QBCompiler Python version is a modern, responsive, and robust desktop compilation wrapper designed to streamline the packaging of source code into standalone executable binaries. By putting a beautiful dark-themed graphical interface over several popular compiler suites, it takes the complexity out of software distribution.

🎯 Purpose & The Vibe-Coder Movement

This application is built with a clear focus on the Vibe-Coder workflow (developers who primarily write code using AI assistants).

When writing software with AI, generating scripts in Python, Go, Node.js, or Rust is fast and friction-free. However, compiling and packaging those scripts for end-users remains a tedious process involving command-line flags, environment configurations, and dependency troubleshooting.

QBCompiler Python version bridges this gap. It acts as an intelligent compiler companion that detects your script language, checks your system for compiler dependencies, installs missing tools automatically, and executes compiling pipelines asynchronously with a crash-proof GUI.

👥 Authors & Collaboration

This project was built through a collaborative pair-programming effort between:

• tommyvercetti89 (Lead Developer & Project Conception)
• Antigravity (Google DeepMind's agentic AI coding assistant)

🚀 Key Features

• Multi-Toolchain Support: Out-of-the-box integration for:
  • Python: Packages scripts via PyInstaller or Nuitka (C-transpilation).
  • Go: Compiles source files natively.
  • C/C++: Builds binaries using GCC/G++.
  • Node.js: Bundles scripts using PKG.
  • Rust: Invokes Cargo or Rustc compiler pipelines.
  • .NET: Publishes projects using the .NET SDK.
  • Inno Setup: Compiles .iss installer scripts using the Inno Setup Compiler (ISCC.exe).
• Environment Auto-Provisioning: Checks system PATH for developer tools. If missing, it provides single-click automated installation via standard package managers (winget, pip, npm).
• Asynchronous Workflows: Compilations and environment updates run in separate background threads, keeping the GUI fully responsive. Build logs stream in real-time to an integrated console view.
• Binary Hardening & Security:
  • Python scripts can be obfuscated using PyArmor before packaging.
  • Supports Windows SignTool code signing with certificate password masking.
  • Supports optional custom icon (.ico) embedding for PyInstaller, Nuitka, and Inno Setup compilations.
• Integrated Editor: A minimalist code preview and editor tab allows you to perform fast, pre-compilation adjustments on your active files.
• Cross-OS Targeting: Enables cross-compilation configurations (Go, Rust, .NET) targeting Windows, Linux, and macOS platforms.
• Smart Assistant & Diagnostic Shield: A global exception handler prevents the GUI from crashing. If a compile fails, the Smart Assistant parses the logs to diagnose the exact issue (e.g. syntax errors, missing compilers, or file locks) and guides you on how to resolve it step-by-step.

📁 Project Structure

qbcompiler_project/
├── run.py                 # Terminal-bound Python launcher
├── run.pyw                # Windowed Python launcher (spawns no background console)
├── run.bat                # Windows launcher & crash diagnostic shell script
├── LICENSE                # Apache 2.0 license file
├── logo.png               # QBCompiler Logo
├── .gitignore             # Git ignore file excluding cache, build and certificate files
└── qbcompiler/            # Core package
    ├── __init__.py        
    ├── config.py          # Color palettes, typography, and toolchain command settings
    ├── core/              # Logical operations
    │   ├── __init__.py    
    │   ├── compiler.py    # Background compile runner & code signing logic
    │   └── env_check.py   # Dependency checker & package manager installer
    └── gui/               # Interface views
        ├── __init__.py    
        ├── main_window.py # Window grid coordinator & log queue manager
        ├── widgets.py     # Custom styled inputs and buttons
        ├── assistant.py   # Smart Assistant popup dialog window
        └── tabs.py        # Individual tab views drawing logic

💻 Installation & Quick Start

Running the Application

To launch the application, run the bootstrap script from your terminal:

python run.py

On Windows systems, you can also double-click run.bat.

Tip

To launch the application on Windows without any background command prompt/terminal window appearing, double-click run.pyw directly.

---

Türkçe Dokümantasyon

QBCompiler Python version, kaynak kodlarınızı bağımsız çalıştırılabilir ikili dosyalara (executable binaries) dönüştürme sürecini kolaylaştırmak için tasarlanmış modern, esnek ve güçlü bir masaüstü derleyici arayüzüdür. Popüler derleme araçlarını şık bir koyu tema grafiksel arayüzü altında birleştirerek yazılım dağıtımındaki karmaşıklığı ortadan kaldırır.

🎯 Amaç ve Vibe-Coder Hareketi

Bu uygulama, özellikle Vibe-Coder iş akışı (kodlarını çoğunlukla yapay zeka asistanları yardımıyla yazan geliştiriciler) odaklanarak geliştirilmiştir.

Yapay zeka ile çalışırken Python, Go, Node.js veya Rust dilinde kodlar üretmek son derece hızlı ve akıcıdır. Ancak, bu kodları derleyip son kullanıcının doğrudan çalıştırabileceği hale getirmek; karmaşık komut satırı parametreleri, ortam değişkenleri ve eksik kütüphane hatalarıyla uğraşmayı gerektirir.

QBCompiler Python version bu boşluğu doldurur. Seçtiğiniz dil tipini otomatik algılayan, sisteminizdeki eksik derleyicileri tespit edip tek tıkla otomatik kuran ve derleme süreçlerini arka planda çalıştırarak çökmeleri engelleyen akıllı bir derleme asistanıdır.

👥 Yazarlar ve İş Birliği

Bu proje, aşağıdaki geliştiricilerin ortak çalışması (pair-programming) ile geliştirilmiştir:

• tommyvercetti89 (Baş Geliştirici ve Proje Sahibi)
• Antigravity (Google DeepMind yapay zeka kodlama asistanı)

🚀 Önemli Özellikler

• Çoklu Derleyici (Toolchain) Desteği: Aşağıdaki araçlarla tam entegrasyon:
  • Python: Scriptlerinizi PyInstaller veya Nuitka (C-transpilation) ile paketler.
  • Go: Kaynak dosyalarınızı yerel olarak derler.
  • C/C++: GCC/G++ kullanarak ikili dosyaları derler.
  • Node.js: Scriptlerinizi PKG aracılığıyla paketler.
  • Rust: Cargo veya Rustc derleme süreçlerini tetikler.
  • .NET: .NET SDK kullanarak projelerinizi yayınlar.
  • Inno Setup: .iss kurulum betiklerinizi Inno Setup Derleyicisi (ISCC.exe) ile tek tıkla paketler.
• Otomatik Bağımlılık Kurulumu (Auto-Provisioning): Derleyicilerin sisteminizde yüklü olup olmadığını denetler. Eksik olanları Winget, Pip veya NPM üzerinden tek tıkla otomatik kurar.
• Asenkron İş Akışları: Derleme ve kurulum süreçleri arka planda çalışır, böylece arayüz hiçbir zaman donmaz. Çıktılar gerçek zamanlı olarak entegre konsoldan izlenebilir.
• Binary Güvenliği ve Şifreleme:
  • Python dosyalarınızı derlemeden önce PyArmor ile şifreleyebilirsiniz.
  • Windows SignTool ile sertifikalı kod imzalama desteği sunar.
  • PyInstaller, Nuitka ve Inno Setup derlemeleri için isteğe bağlı olarak özel .ico ikonları eklemenize olanak tanır.
• Entegre Düzenleyici: Minimalist bir kod düzenleme sekmesi, derleme öncesinde dosyalarınız üzerinde hızlıca değişiklik yapmanızı sağlar.
• Çapraz Platform Hedefleme: Go, Rust ve .NET için Windows, Linux ve macOS platformlarına uygun derleme seçenekleri sunar.
• Akıllı Hata Teşhis Asistanı (Smart Assistant): Global hata yakalama mekanizması sayesinde uygulamanın çökmesi engellenir. Derleme başarısız olursa, asistan hata günlüklerini analiz ederek sorunu (sözdizimi hatası, eksik araç, yetki hatası vb.) teşhis eder ve kullanıcıya adım adım çözüm rehberi sunar.

💻 Kurulum ve Başlatma

Uygulamayı başlatmak için terminalden run.py dosyasını çalıştırabilir veya Windows üzerinde doğrudan run.bat dosyasına çift tıklayabilirsiniz.

Tip

Windows'ta uygulamanın arkasında boş bir siyah komut istemi (CMD) penceresinin açılmasını engellemek için doğrudan run.pyw dosyasına çift tıklayarak başlatabilirsiniz. Bu dosya, arka plan konsolunu tamamen gizleyerek uygulamayı pencere modunda çalıştırır.

python run.py

---

🛡️ License / Lisans

This project is licensed under the Apache License 2.0. See the LICENSE file for details. / Bu proje Apache Lisansı 2.0 kapsamında lisanslanmıştır. Detaylar için LICENSE dosyasına göz atabilirsiniz.