How It Works at Runtime

A top-to-bottom flow from user action through authentication, core engines, and supporting services. Every module has one job.

USERUICORESUPPORTif root neededUser ActionClean / Scan / Health Check / AI Analysisui.pyInterface ControllerPolkit Authpkexeccleaner.pyWhitelist scan → safe deletehealth_engine.pyCPU / RAM / Disk → Score 0–100security_scanner.pySUID · permissions · SSHai_engine.pyLocal analysis → optional cloudpardus_analyzer.pyRepo & service healthlog_analyzer.pyJournal error classificationreport_exporter.pyTXT / HTML / JSON output

Tech Stack

LanguagePython 3.9+
GUIGTK 3 (PyGObject)
BuildMeson / GNU Make
Testingpytest — 246+ tests, 75%+ coverage
PackagingFlatpak, Debian (.deb), Arch, RPM
AuthPolkit (pkexec)