# estebanarosemena/stellarhub architecture

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

- Interactive diagram: https://gitdiagram.com/estebanarosemena/stellarhub
- Repository: https://github.com/estebanarosemena/stellarhub

## Overview

StellarHub is a Windows desktop control center: users inspect their PC and run maintenance, updating, removal, storage, privacy, and testing workflows through a WebView interface. The graph preserves the README’s major product branches and the Python engine/API boundary. Some feature implementations and UI/API routes were not excerpted; where their connections are not established by the available source, links are omitted or marked unverified.

Main entry points: [`stellarhub/app.py`](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/app.py) (Desktop app), [`stellarhub/engine/removal/scanner.py`](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/removal/scanner.py) (Leftover scanner), [`stellarhub/startup.py`](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/startup.py) (Launch orchestration), [`stellarhub/api/main_window.py`](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/api/main_window.py) (Main window API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop runtime"]
  node_startup["Launch orchestration<br/>[startup.py]"]
  node_app["Desktop app<br/>[app.py]"]
  node_main_window["Main window API<br/>[main_window.py]"]
  node_engine_api["Engine API<br/>[engine_api.py]"]
  node_settings[("Settings<br/>[settings.py]")]
  node_jobs["Job queue<br/>[jobs.py]"]
  node_config["Runtime config<br/>[config.py]"]
  node_instance["Single instance<br/>[instance.py]"]
  node_logging["Application log<br/>[log.py]"]
  node_windowing["Window mechanics<br/>[winmgr.py]"]
  node_splash["Start screen<br/>[splash.py]"]
  node_tray["System tray<br/>[tray.py]"]
  node_translations["Translations<br/>[i18n.py]"]
  node_selfupdate["Self updater<br/>[selfupdate.py]"]
end

subgraph group_hardware["Hardware insights"]
  node_home_monitor["Home and monitor<br/>[monitor.py]"]
  node_telemetry["Live telemetry<br/>[telemetry.py]"]
  node_device_tests["Hardware testing<br/>[tester.js]"]
end

subgraph group_maintenance["Maintenance tools"]
  node_storage["Storage checker<br/>[storage.py]"]
  node_optimizer["System optimizer<br/>[optimizer.py]"]
  node_debloat["Debloat<br/>[debloat.py]"]
  node_privacy["Privacy and security<br/>[privacy.py]"]
  node_autopilot["Autopilot routines<br/>[autopilot.py]"]
end

subgraph group_management["App management"]
  node_drivers["Driver updater<br/>[drivers.py]"]
  node_app_updater["Program updater<br/>[updater.py]"]
  node_hangar["App Hangar<br/>[hangar.py]"]
  node_remover["Program remover<br/>[remover.py]"]
  node_removal_scanner["Leftover scanner<br/>[scanner.py]"]
  node_removal_programs["Installed programs<br/>[programs.py]"]
  node_removal_safety["Removal safety<br/>[safety.py]"]
  node_removal_paths["Path handling<br/>[paths.py]"]
  node_removal_registry["Registry access<br/>[registry.py]"]
end

node_user(("PC user"))

node_user -->|"launches"| node_startup
node_startup -->|"prepares"| node_app
node_app -->|"creates"| node_main_window
node_app -->|"starts"| node_tray
node_app -->|"sets event emitter"| node_jobs
node_app -->|"attaches"| node_autopilot
node_startup -->|"applies staged update"| node_selfupdate
node_startup -->|"shows"| node_splash
node_app -->|"watches UI"| node_windowing
node_main_window -->|"uses"| node_settings
node_main_window -->|"uses"| node_windowing
node_engine_api -->|"uses"| node_jobs
node_engine_api -->|"uses"| node_telemetry
node_user -.->|"inspects PC"| node_home_monitor
node_user -.->|"updates drivers"| node_drivers
node_user -.->|"updates apps"| node_app_updater
node_user -.->|"installs apps"| node_hangar
node_user -.->|"uninstalls apps"| node_remover
node_remover -.->|"scans leftovers"| node_removal_scanner
node_removal_scanner -->|"consults"| node_removal_programs
node_removal_scanner -->|"checks safety"| node_removal_safety
node_removal_scanner -->|"uses"| node_removal_paths
node_removal_scanner -->|"uses"| node_removal_registry
node_user -.->|"analyzes disk"| node_storage
node_user -.->|"runs maintenance"| node_optimizer
node_user -.->|"removes bundled apps"| node_debloat
node_user -.->|"checks privacy"| node_privacy
node_user -.->|"tests devices"| node_device_tests
node_user -.->|"configures routines"| node_autopilot
node_home_monitor -.->|"reads live data"| node_telemetry

click node_startup "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/startup.py"
click node_app "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/app.py"
click node_main_window "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/api/main_window.py"
click node_engine_api "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/api/engine_api.py"
click node_settings "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/settings.py"
click node_jobs "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/jobs.py"
click node_config "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/config.py"
click node_instance "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/instance.py"
click node_logging "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/log.py"
click node_windowing "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/winmgr.py"
click node_splash "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/splash.py"
click node_tray "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/tray.py"
click node_translations "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/i18n.py"
click node_home_monitor "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/monitor.py"
click node_telemetry "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/telemetry.py"
click node_device_tests "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/ui/js/modules/tester.js"
click node_drivers "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/drivers.py"
click node_app_updater "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/updater.py"
click node_hangar "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/hangar.py"
click node_remover "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/remover.py"
click node_removal_scanner "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/removal/scanner.py"
click node_removal_programs "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/removal/programs.py"
click node_removal_safety "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/removal/safety.py"
click node_removal_paths "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/removal/paths.py"
click node_removal_registry "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/removal/registry.py"
click node_storage "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/storage.py"
click node_optimizer "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/optimizer.py"
click node_debloat "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/debloat.py"
click node_privacy "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/privacy.py"
click node_autopilot "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/autopilot.py"
click node_selfupdate "https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/selfupdate.py"

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_startup,node_app,node_main_window,node_engine_api,node_settings,node_jobs,node_config,node_instance,node_logging,node_windowing,node_splash,node_tray,node_translations,node_selfupdate,node_user toneBlue
class node_home_monitor,node_telemetry,node_device_tests toneAmber
class node_storage,node_optimizer,node_debloat,node_privacy,node_autopilot toneMint
class node_drivers,node_app_updater,node_hangar,node_remover,node_removal_scanner,node_removal_programs,node_removal_safety,node_removal_paths,node_removal_registry toneRose
```

## Components

### Desktop runtime

- [Launch orchestration](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/startup.py): `stellarhub/startup.py`
- [Desktop app](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/app.py): `stellarhub/app.py`
- [Main window API](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/api/main_window.py): `stellarhub/api/main_window.py`
- [Engine API](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/api/engine_api.py): `stellarhub/api/engine_api.py`
- [Settings](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/settings.py): `stellarhub/settings.py`
- [Job queue](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/jobs.py): `stellarhub/engine/jobs.py`
- [Runtime config](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/config.py): `stellarhub/config.py`
- [Single instance](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/instance.py): `stellarhub/instance.py`
- [Application log](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/log.py): `stellarhub/log.py`
- [Window mechanics](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/winmgr.py): `stellarhub/winmgr.py`
- [Start screen](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/splash.py): `stellarhub/splash.py`
- [System tray](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/tray.py): `stellarhub/tray.py`
- [Translations](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/i18n.py): `stellarhub/i18n.py`
- [Self updater](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/selfupdate.py): `stellarhub/engine/selfupdate.py`

### Hardware insights

- [Home and monitor](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/monitor.py): `stellarhub/engine/monitor.py`
- [Live telemetry](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/telemetry.py): `stellarhub/engine/telemetry.py`
- [Hardware testing](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/ui/js/modules/tester.js): `stellarhub/ui/js/modules/tester.js`

### Maintenance tools

- [Storage checker](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/storage.py): `stellarhub/engine/storage.py`
- [System optimizer](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/optimizer.py): `stellarhub/engine/optimizer.py`
- [Debloat](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/debloat.py): `stellarhub/engine/debloat.py`
- [Privacy and security](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/privacy.py): `stellarhub/engine/privacy.py`
- [Autopilot routines](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/autopilot.py): `stellarhub/engine/autopilot.py`

### App management

- [Driver updater](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/drivers.py): `stellarhub/engine/drivers.py`
- [Program updater](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/updater.py): `stellarhub/engine/updater.py`
- [App Hangar](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/hangar.py): `stellarhub/engine/hangar.py`
- [Program remover](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/remover.py): `stellarhub/engine/remover.py`
- [Leftover scanner](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/removal/scanner.py): `stellarhub/engine/removal/scanner.py`
- [Installed programs](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/removal/programs.py): `stellarhub/engine/removal/programs.py`
- [Removal safety](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/removal/safety.py): `stellarhub/engine/removal/safety.py`
- [Path handling](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/removal/paths.py): `stellarhub/engine/removal/paths.py`
- [Registry access](https://github.com/estebanarosemena/StellarHub/blob/main/stellarhub/engine/removal/registry.py): `stellarhub/engine/removal/registry.py`

### Other components

- **PC user**

## Connections

- PC user → Launch orchestration: launches (evidence: `README.md`)
- Launch orchestration → Desktop app: prepares (evidence: `stellarhub/app.py`)
- Desktop app → Main window API: creates (evidence: `stellarhub/app.py`)
- Desktop app → System tray: starts (evidence: `stellarhub/app.py`)
- Desktop app → Job queue: sets event emitter (evidence: `stellarhub/app.py`)
- Desktop app → Autopilot routines: attaches (evidence: `stellarhub/app.py`)
- Launch orchestration → Self updater: applies staged update (evidence: `stellarhub/startup.py`)
- Launch orchestration → Start screen: shows (evidence: `stellarhub/startup.py`)
- Desktop app → Window mechanics: watches UI (evidence: `stellarhub/app.py`)
- Main window API → Settings: uses (evidence: `stellarhub/api/main_window.py`)
- Main window API → Window mechanics: uses (evidence: `stellarhub/api/main_window.py`)
- Engine API → Job queue: uses (evidence: `stellarhub/api/engine_api.py`)
- Engine API → Live telemetry: uses (evidence: `stellarhub/api/engine_api.py`)
- PC user → Home and monitor: inspects PC (evidence: `README.md`)
- PC user → Driver updater: updates drivers (evidence: `README.md`)
- PC user → Program updater: updates apps (evidence: `README.md`)
- PC user → App Hangar: installs apps (evidence: `README.md`)
- PC user → Program remover: uninstalls apps (evidence: `README.md`)
- Program remover → Leftover scanner: scans leftovers
- Leftover scanner → Installed programs: consults (evidence: `stellarhub/engine/removal/scanner.py`)
- Leftover scanner → Removal safety: checks safety (evidence: `stellarhub/engine/removal/scanner.py`)
- Leftover scanner → Path handling: uses (evidence: `stellarhub/engine/removal/scanner.py`)
- Leftover scanner → Registry access: uses (evidence: `stellarhub/engine/removal/scanner.py`)
- PC user → Storage checker: analyzes disk (evidence: `README.md`)
- PC user → System optimizer: runs maintenance (evidence: `README.md`)
- PC user → Debloat: removes bundled apps (evidence: `README.md`)
- PC user → Privacy and security: checks privacy (evidence: `README.md`)
- PC user → Hardware testing: tests devices (evidence: `README.md`)
- PC user → Autopilot routines: configures routines (evidence: `README.md`)
- Home and monitor → Live telemetry: reads live data
