# cc-infiltration/nuitkagui architecture

> Architecture diagram of the GitHub repository cc-infiltration/nuitkagui, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cc-infiltration/nuitkagui
- Repository: https://github.com/cc-infiltration/nuitkagui

## Overview

NuitkaGUI is a PySide6 desktop front end for configuring and running Nuitka builds. The main workflow is user configuration, environment checking, command construction and execution, then log review and failure diagnosis. The README documents further configuration areas and safety features; unsampled implementation details are represented only where their documented role is clear. Source excerpts show the app’s calls into the builder, dependency checks and configuration persistence, but not every UI-to-worker detail.

Main entry points: [`modules/builder.py`](https://github.com/cc-infiltration/nuitkagui/blob/main/modules/builder.py) (Command and build runner), [`modules/app.py`](https://github.com/cc-infiltration/nuitkagui/blob/main/modules/app.py) (Main window), [`modules/deps.py`](https://github.com/cc-infiltration/nuitkagui/blob/main/modules/deps.py) (Environment checks), [`main.py`](https://github.com/cc-infiltration/nuitkagui/blob/main/main.py) (Application entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gui["Desktop interface"]
  node_entry["Application entry<br/>[main.py]"]
  node_window["Main window<br/>[app.py]"]
  node_project_options["Project options<br/>[app.py]"]
  node_build_options["Build options<br/>[app.py]"]
  node_plugin_options["Plugin selection<br/>[app.py]"]
  node_data_options["Data and modules<br/>[app.py]"]
  node_metadata_options["Windows metadata<br/>[app.py]"]
  node_command_preview["Command preview<br/>[app.py]"]
  node_log_diagnosis["Logs and diagnosis<br/>[app.py]"]
end

subgraph group_build["Build workflow"]
  node_builder["Command and build runner<br/>[builder.py]"]
end

subgraph group_environment["Environment support"]
  node_environment_check["Environment checks<br/>[deps.py]"]
  node_plugin_discovery["Plugin discovery<br/>[deps.py]"]
  node_compiler_detection["Compiler detection<br/>[deps.py]"]
  node_mingw_download["MinGW download<br/>[deps.py]"]
end

subgraph group_persistence["Configuration and themes"]
  node_config_store[("Config persistence<br/>[config.py]")]
  node_themes["QSS themes<br/>[dark.qss]"]
end

node_user(("Project user"))
node_nuitka["Nuitka compiler"]
node_compiler["C compiler"]

node_user -->|"uses"| node_window
node_entry -->|"creates"| node_window
node_window -->|"loads and saves"| node_config_store
node_window -->|"checks environment"| node_environment_check
node_window -->|"starts build"| node_builder
node_project_options -->|"configures"| node_builder
node_build_options -->|"configures"| node_builder
node_plugin_options -->|"configures"| node_builder
node_data_options -->|"configures"| node_builder
node_metadata_options -->|"configures"| node_builder
node_command_preview -->|"previews command"| node_builder
node_builder -->|"runs command"| node_nuitka
node_builder -->|"streams build logs"| node_log_diagnosis
node_environment_check -->|"checks compilers"| node_compiler_detection
node_environment_check -->|"checks plugins"| node_plugin_discovery
node_compiler_detection -->|"detects"| node_compiler
node_mingw_download -->|"downloads MinGW"| node_compiler
node_window -->|"offers download"| node_mingw_download
node_window -->|"applies theme"| node_themes

click node_entry "https://github.com/cc-infiltration/nuitkagui/blob/main/main.py"
click node_window "https://github.com/cc-infiltration/nuitkagui/blob/main/modules/app.py"
click node_project_options "https://github.com/cc-infiltration/nuitkagui/blob/main/modules/app.py"
click node_build_options "https://github.com/cc-infiltration/nuitkagui/blob/main/modules/app.py"
click node_plugin_options "https://github.com/cc-infiltration/nuitkagui/blob/main/modules/app.py"
click node_data_options "https://github.com/cc-infiltration/nuitkagui/blob/main/modules/app.py"
click node_metadata_options "https://github.com/cc-infiltration/nuitkagui/blob/main/modules/app.py"
click node_command_preview "https://github.com/cc-infiltration/nuitkagui/blob/main/modules/app.py"
click node_log_diagnosis "https://github.com/cc-infiltration/nuitkagui/blob/main/modules/app.py"
click node_builder "https://github.com/cc-infiltration/nuitkagui/blob/main/modules/builder.py"
click node_environment_check "https://github.com/cc-infiltration/nuitkagui/blob/main/modules/deps.py"
click node_plugin_discovery "https://github.com/cc-infiltration/nuitkagui/blob/main/modules/deps.py"
click node_compiler_detection "https://github.com/cc-infiltration/nuitkagui/blob/main/modules/deps.py"
click node_mingw_download "https://github.com/cc-infiltration/nuitkagui/blob/main/modules/deps.py"
click node_config_store "https://github.com/cc-infiltration/nuitkagui/blob/main/modules/config.py"
click node_themes "https://github.com/cc-infiltration/nuitkagui/blob/main/styles/dark.qss"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_window,node_project_options,node_build_options,node_plugin_options,node_data_options,node_metadata_options,node_command_preview,node_log_diagnosis,node_user toneBlue
class node_builder toneAmber
class node_environment_check,node_plugin_discovery,node_compiler_detection,node_mingw_download toneMint
class node_config_store,node_themes toneRose
class node_nuitka,node_compiler toneIndigo
```

## Components

### Desktop interface

- [Application entry](https://github.com/cc-infiltration/nuitkagui/blob/main/main.py): `main.py`
- [Main window](https://github.com/cc-infiltration/nuitkagui/blob/main/modules/app.py): `modules/app.py`
- [Project options](https://github.com/cc-infiltration/nuitkagui/blob/main/modules/app.py): `modules/app.py`
- [Build options](https://github.com/cc-infiltration/nuitkagui/blob/main/modules/app.py): `modules/app.py`
- [Plugin selection](https://github.com/cc-infiltration/nuitkagui/blob/main/modules/app.py): `modules/app.py`
- [Data and modules](https://github.com/cc-infiltration/nuitkagui/blob/main/modules/app.py): `modules/app.py`
- [Windows metadata](https://github.com/cc-infiltration/nuitkagui/blob/main/modules/app.py): `modules/app.py`
- [Command preview](https://github.com/cc-infiltration/nuitkagui/blob/main/modules/app.py): `modules/app.py`
- [Logs and diagnosis](https://github.com/cc-infiltration/nuitkagui/blob/main/modules/app.py): `modules/app.py`

### Build workflow

- [Command and build runner](https://github.com/cc-infiltration/nuitkagui/blob/main/modules/builder.py): `modules/builder.py`

### Environment support

- [Environment checks](https://github.com/cc-infiltration/nuitkagui/blob/main/modules/deps.py): `modules/deps.py`
- [Plugin discovery](https://github.com/cc-infiltration/nuitkagui/blob/main/modules/deps.py): `modules/deps.py`
- [Compiler detection](https://github.com/cc-infiltration/nuitkagui/blob/main/modules/deps.py): `modules/deps.py`
- [MinGW download](https://github.com/cc-infiltration/nuitkagui/blob/main/modules/deps.py): `modules/deps.py`

### Configuration and themes

- [Config persistence](https://github.com/cc-infiltration/nuitkagui/blob/main/modules/config.py): `modules/config.py`
- [QSS themes](https://github.com/cc-infiltration/nuitkagui/blob/main/styles/dark.qss): `styles/dark.qss`

### Other components

- **Project user**
- **Nuitka compiler**
- **C compiler**

## Connections

- Project user → Main window: uses (evidence: `README.md`)
- Application entry → Main window: creates (evidence: `main.py`)
- Main window → Config persistence: loads and saves (evidence: `modules/app.py`)
- Main window → Environment checks: checks environment (evidence: `modules/app.py`)
- Main window → Command and build runner: starts build (evidence: `modules/app.py`)
- Project options → Command and build runner: configures (evidence: `README.md`)
- Build options → Command and build runner: configures (evidence: `README.md`)
- Plugin selection → Command and build runner: configures (evidence: `README.md`)
- Data and modules → Command and build runner: configures (evidence: `README.md`)
- Windows metadata → Command and build runner: configures (evidence: `README.md`)
- Command preview → Command and build runner: previews command (evidence: `README.md`)
- Command and build runner → Nuitka compiler: runs command (evidence: `modules/builder.py`)
- Command and build runner → Logs and diagnosis: streams build logs (evidence: `README.md`)
- Environment checks → Compiler detection: checks compilers (evidence: `modules/deps.py`)
- Environment checks → Plugin discovery: checks plugins (evidence: `README.md`)
- Compiler detection → C compiler: detects (evidence: `README.md`)
- MinGW download → C compiler: downloads MinGW (evidence: `modules/deps.py`)
- Main window → MinGW download: offers download (evidence: `README.md`)
- Main window → QSS themes: applies theme (evidence: `README.md`)
