Skip to content
xnet-baPublic

About

MujoFix: AI mehanicar za Windows racunar (open source)

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

mujofix

Typing SVG

Stars License Top lang Last commit matrix


🛠️ MujoFix

AI mehaničar za Windows računar

Klikneš SCAN — aplikacija nađe probleme, prevede ih u običan jezik, predloži plan popravki, ti odobriš, ona popravi, provjeri i vrati nazad ako nešto pođe po zlu.

Status Licenca Platforma Python

Šta je MujoFix • Kako radi • Moduli • AI sloj • Sigurnost • Status


❓ Šta je MujoFix

MujoFix je open-source desktop aplikacija koja običnom korisniku — bez ikakvog admin znanja — pomaže da održava Windows računar zdravim. Umjesto tehničkih poruka o greškama, korisnik dobija rečenice poput:

"Tvoj računar ima 7 problema.
🔴 2 ozbiljna   🟠 3 srednja   🟢 2 mala
Automatski se može popraviti: 4."

…i jedno dugme [ POPRAVI SVE ]. Ispod se nalazi proširiva lista s detaljima ("Prikaži tehničke detalje") za naprednije korisnike.

Podržano Detalj
🖥️ Sistem Windows 10 (22H2) i Windows 11 (23H2+), x64
👤 Korisnik Bez admin znanja; radi i bez admin prava (čitanje + popravke u korisničkom profilu)
🔐 UAC Elevacija se traži samo kad je potrebno, uz objašnjenje zašto — prije nego iskoči Windows prozor
🌐 Jezik Bosanski/hrvatski/srpski (default), i18n struktura za engleski
📶 Offline Aplikacija ostaje potpuno upotrebljiva bez interneta i bez AI-ja (offline mod)

🔄 Kako radi

  1. SCAN — moduli skeniranja (izvršavaju se redom) uz progres bar i mogućnost otkazivanja. Greška modula ne ruši aplikaciju — postaje skipped u izvještaju.
  2. ANALIZA — svaki nalaz ima ozbiljnost (CRITICAL / MEDIUM / LOW), procjenu uticaja, rizik popravke i oznaku da li je popravka reverzibilna.
  3. PRIKAZ — jednostavan sažetak običnim jezikom + proširiva lista detalja. Izgled: Fluent 2 / Windows 11 (Segoe UI, zaobljene kontrole, automatska svijetla/tamna tema) i Mica pozadina kad je DWM pruža (Win11; u suprotnom solidna boja). Izbor jezika (Bosanski / English, primjenjuje se pri sljedećem pokretanju) i zapamćena veličina/pozicija prozora. Dvojezično je sve što korisnik vidi: interfejs, nalazi skenera (naslov, zašto, uticaj, rizik), poruke akcija (precondition/apply/verify/rollback), nazivi i rizik akcija u katalogu, razlozi validacije AI plana, offline objašnjenja, izvještaj i CLI izlaz. (Tehničke poruke izuzetaka u platformskom sloju ostaju na bosanskom.)
  4. PLAN — AI predloži plan popravki (koraci + redoslijed), koji se prikaže uz objašnjenje; svaki predlog prolazi katalog akcija i validator prije nego se uopšte prikaže. Primjenjuju se akcije odabranih nalaza (deterministički, sa snapshot/rollback tačkom i verifikacijom) — korisnik odobrava: sve, pojedinačno ili ništa. Bez odobrenja se NIŠTA ne mijenja.
  5. IZVRŠENJE — prije svakog koraka snapshot/rollback tačka, pa izvršenje.
  6. VERIFIKACIJA — nakon svakog koraka ponovo se izmjeri isto što je nalaz detektovao i potvrdi da je problem stvarno riješen.
  7. ROLLBACK — ako verifikacija padne ili se stanje pogorša, korak se automatski vraća i korisnik se izvijesti.
  8. SAŽETAK — koliko je problema, po ozbiljnosti, i koliko ih se može automatski popraviti (nalazi bez akcije su preporuke).
  9. IZVJEŠTAJ — broj popravljenih / preskočenih / neuspjelih koraka, koliko je u karantinu i, poslije čišćenja, oslobođeni GB + opcija "Poništi sve" preko rollback tačaka. (Vrijeme boot-a se ne mjeri nigdje u kodu — vidi scanners/startup.py.)
Zašto svaki nalaz mora imati dokaz?

AI smije govoriti samo o podacima koje je scanner stvarno prikupio (sirova mjerenja, ključevi registra, event ID-jevi, putanje). Bez dokaza nalaz se ne prikazuje. Kad je AI nesiguran, mora to izričito reći. Zabranjeno: izmišljeni procenti, brojke i tvrdnje o uzroku bez dokaza.


🖼️ Izgled

Fluent 2 / Windows 11: Segoe UI, zaobljene kontrole, automatska svijetla/tamna tema i Mica pozadina na Win11. Snimke su sa stvarne aplikacije (offscreen render na pravom Windows 11, bs jezik):

MujoFix — svijetla tema MujoFix — tamna tema


🧩 Moduli skeniranja

Svi moduli su pluginovi s istim interfejsom (scan() nikad ne ruši aplikaciju — greška postaje skipped izvještaj). Svaki modul provjerava verziju Windowsa i graceful se isključuje gdje nije podržan.

ModulŠta gledaFaza
🚀 StartupRun/RunOnce ključevi, Startup folder, Taskovi, auto-servisi1 ✅
🔁 ServisiServisi koji se ruše (Event ID 7031/7034), neočekivana stanja1 ✅
💾 DiskSlobodan prostor, temp, WU keš, recycle bin, Windows.old, SMART1 ✅
📁 Veliki fajlovi i duplikatiVeličina → djelimični hash → puni hash; duplikati se nikad ne brišu automatski5
🔧 Drajveri i paketiStari drajveri (pnputil), zaostali instaleri, nekorišteni programi5
⚙️ KonfiguracijaPATH, env varijable, hosts, power plan, SFC/DISM indikatori5
🌐 MrežaDNS, proxy, adapteri, latencija, hosts hijack, Winsock5
🕵️ Sumnjivi procesiNepotpisani procesi na čudnim lokacijama, autostart iz Temp-a, Defender izuzeci (i isključena real-time zaštita). Ne tvrdi "virus" — kaže "sumnjivo, razlozi: …"; izuzeci su samo čitanje5
⏰ Zakazani zadaciZadaci koji se pokreću pri prijavi/boot-u, a program im je izvan sistemskih foldera (Task Scheduler)5
🛡️ Sigurnosna postavka (samo čitanje)BitLocker na sistemskom disku, Secure Boot, TPM, Windows Update servis — samo prijavljuje, ništa ne mijenja5
🔒 PermisijePreširoke ACL dozvole, svijet-zapisivi folderi u PATH-u, UAC, share-ovi5

Od 32 nalaza, 12 ima automatsku popravku (akcija iz kataloga, sa snapshot/verify/rollback); ostali su namjerno samo preporuke — sa razlogom:

Nalaz Popravka Napomena
config-path-writable ❌ samo POSIX (na Windowsu ACL nije mode); skidanje prava pisanja je rizično
config-path-missing ✅ remove_path_entry
config-temp-var ✅ fix_temp_var
config-power-saver ✅ disable_power_saver
config-sfc ❌ traži sfc /scannow (duga popravka sistema, van kataloga)
disk-almost-full ❌ uzrok je širok — temp i WU keš imaju svoje nalaze
disk-low ❌ uzrok je širok — temp i WU keš imaju svoje nalaze
disk-temp ✅ clean_temp
disk-wu-cache ✅ clean_temp
disk-windows-old ❌ brisanje je NEPOVRATNO (nema povratka na staru verziju)
drivers-old ❌ update drajvera traži proizvođački alat i restart (rizik plavog ekrana)
duplicates-found ✅ quarantine_duplicates
network-dns ❌ dijagnostika — uzrok je ruter/provajder, ne računar
network-unreachable ❌ dijagnostika — uzrok je firewall/provajder
network-slow ❌ dijagnostika — uzrok je mreža/provajder
network-hosts ✅ remove_hosts_entry
network-proxy ✅ disable_proxy
network-winsock ❌ netsh winsock reset traži restart i mijenja mrežni stek
permissions-uac-off ❌ uključivanje UAC-a traži restart (može zaključati zavisne programe)
permissions-acl ❌ zatezanje ACL-a može slomiti pristup — rizično bez pregleda
permissions-shares ✅ remove_share
permissions-path-writable ❌ samo POSIX fallback; isto kao config-path-writable
bitlocker-off ❌ mijenjanje zaštitnih politika je IZVAN politike app-a — samo prijavljujemo
secureboot-off ❌ isto — boot politika se ne dira iz aplikacije
tpm-absent ❌ hardverski nedostatak — nema šta da se popravi softverski
wuauserv-disabled ❌ politika ažuriranja je izvan politike app-a — samo prijavljujemo
services-auto-stopped ✅ restart_service
startup-count ✅ disable_startup_item
suspicious-process ❌ namjerno report-only — app ne gasi procese i ne tvrdi da je virus
suspicious-defender-off ❌ app nikad ne dira antivirus/zaštitu (politika)
defender-exclusions ❌ mijenjanje zaštitnih politika je IZVAN politike app-a — samo prijavljujemo
tasks-autostart-untrusted ✅ disable_task

🚫 Šta aplikacija NE radi (iskreno)

  • Ne mjeri vrijeme boot-a. Startup nalaz broji stavke i to izričito kaže; stvarno vrijeme podizanja se ne mjeri nigdje u kodu.
  • Ne pravi System Restore Point. Sigurnosna mreža je snapshot po akciji + rollback + karantin (traži admin/Checkpoint-Computer).
  • Ne instalira drajvere ni Windows zakrpe. Zastarjeli drajveri i isključen Windows Update se prijavljuju, ne popravljaju.
  • Ne mijenja zaštitne politike: Defender (izuzeci, real-time), UAC, BitLocker, Secure Boot, deljeni folderi, firewall — sve je samo čitanje + preporuka.
  • Ne gasi procese i nikad ne tvrdi „virus" — sumnjivi nalazi kažu „sumnjivo, razlozi: …".
  • Ne briše trajno bez tvoje potvrde. Fajlovi idu u karantin; trajno briše samo dugme „Očisti karantin" (uz potvrdu) i to se upiše u dnevnik.
  • Karantin nema automatski rok. Ništa se ne briše samo — dok ti ne očistiš, fajlovi stoje u %LOCALAPPDATA%\MujoFix\quarantine.
  • Nema telemetrije. Mreža se koristi samo za: provjeru ažuriranja (GitHub), AI objašnjenje (uz pristanak, anonimizirano) i mrežnu dijagnostiku (DNS/TCP probe ka javnom DNS-u).
  • AI ništa ne izvršava. Model objašnjava i predlaže; izvršava samo deterministički katalog akcija, uz tvoje odobrenje. Ako besplatni model nije dostupan, lanac iskreno pada na offline.
  • Radi samo na Windowsu (10 22H2+ / 11). Na drugim sistemima se scanneri iskreno preskaču (CLI se pokreće, ali nema šta da skenira).
  • Build nije potpisan — SmartScreen upozorenje je očekivano, ne bug.
  • Puna VM matrica (čist Win10/Win11) je otvorena. Sve što nije izvršeno na pravom Windowsu stoji označeno kao netestirano (docs/TESTING.md).

🤖 AI sloj

MujoFix koristi OpenCode (pinovana, testirana verzija, MIT licenca) kao AI motor — instalira se zajedno s aplikacijom, korisnik ne instalira ništa ručno (ni Node ni npm).

MujoFix UI → MujoFix Core (scanneri, katalog, executor, rollback)
                    │
                    └── OpenCode child proces (opencode run, bez servera/porta)
                              │
                              └── MujoFix MCP server (samo 5 alata, svi read-only + validator)
  • Izvršenje je ISKLJUČIVO u Coreu. OpenCode objašnjava i predlaže, validator provjerava (JSON schema + allowlista), korisnik odobrava, deterministički executor izvršava. OpenCode nikad ne izvršava komande.
  • Agent mujofix: svi ugrađeni alati zabranjeni (bash, edit, write, web…), dozvoljeni samo MujoFix MCP alati, deny po defaultu.
  • Fallback lanac: model A → B → C → OFFLINE mod. Offline objašnjenje je dvojezično i gradi se isključivo iz podataka koje je scanner prikupio (zašto, uticaj, rizik, dokaz, tehnički detalji + koja akcija postoji) — bez ijedne pretpostavke i bez AI-ja.
  • Živi model: uz pristanak MujoFix pokrene opencode run kao child proces i koristi besplatan Zen model (npr. opencode/beam-free). Nema lokalnog backend-a: ne diže se opencode serve, nema porta ni lozinke, ništa se ne izlaže na mrežu — MujoFix je isključivo instalabilna Windows aplikacija. Ako binary ili besplatni model nisu dostupni — tiho nazad na offline, uz iskrenu poruku o razlogu (bez lažne tvrdnje da je AI radio). netestirano: živi put još nije pokrenut na Windows VM-u (Issue #1).
  • Privatnost: prije prvog korištenja AI-ja — ekran pristanka (koji podaci idu, kome, primjer payload-a). Anonimizacija prije slanja; default je offline dok korisnik ne pristane. Besplatni Zen modeli nisu privatni (potvrđeno iz ToS i Zen docs, 2026-10-18): provajderi su uglavnom zero-retention, ali za neplaćene račune sadržaj se smije koristiti za unapređenje usluge, pojedini besplatni modeli tokom promo perioda mogu koristiti poslane podatke za poboljšanje modela, dio zahtjeva (OpenAI/Anthropic) čuva se 30 dana.

🛡️ Sigurnost i povratak stanja

  • Zaštićene zone (hard-coded crna lista u validatoru AI plana): System32, WinSxS, Program Files, korisnički Dokumenti/Slike/Desktop/Download, boot konfiguracija (BCD), BitLocker, Defender. Namjerno NIJE na listi cijeli C:\Windows — Windows\Temp i WU cache su legitimni ciljevi. Izvršni sloj ipak vrti samo akcije iz kataloga nad nalazima koje je korisnik odabrao.
  • Prije popravke: vlastiti manifest po akciji — snapshot vraća tačno stanje koje akcija mijenja (npr. prijašnja vrijednost registry unosa ili stanje servisa/taska) + karantin fajlova (ne trajno brisanje: u karantin idu fajlovi stariji od 30 dana). Dugme „Karantin" prikazuje šta je unutra i vraća pojedinačne fajlove (i one iz ranijih sesija — originalna putanja se čita iz manifesta; fajl bez manifesta se može samo obrisati). Dugme „Očisti karantin" jedino trajno briše — prikaže koliko fajlova i koliko GB, traži potvrdu i u izvještaj upiše oslobođeno. System Restore Point nije implementiran (traži admin/Checkpoint-Computer; vidi docs/STATUS.md) — sigurnosna mreža je snapshot + rollback po akciji.
  • Svaka akcija: precondition → snapshot → apply → verify → rollback ako zatreba. Akcija bez rollback() ne smije biti auto-fix.
  • Probni (dry-run) mod (checkbox u GUI-ju: ništa se ne mijenja) i čítljiv dnevnik svakog koraka u prozoru (precondition / snapshot / apply / verify / dry-run). Poslije svake popravke upisuje se i JSON dnevnik izvršavanja u %LOCALAPPDATA%\MujoFix\audit\audit-<vrijeme>.json (sve faze koraka + sažetak; putanja se ispiše u dnevniku).
  • Nikad: gašenje antivirusa/firewalla/Windows Update-a, mijenjanje zaštitnih politika.

🚦 Status projekta

FazaSadržajStanje
0 — SPIKEBundlovani OpenCode kao child, besplatni modeli, MCP alat, zabrana shell-a, offline🟢 kod + dokaz na hostu (1–2); 3–5 čekaju živi model
1Skeleton + CLI scanner (startup, disk, servisi) + model nalaza🟢 gotovo (Linux + host dokazi)
2Action katalog + runner (snapshot/verify/rollback)🟢 gotovo (katalog 10 akcija; 3 potvrđene host dokazom, ostale testovi — vidi TESTING)
3GUI (sažetak, plan, odobravanje, progres, izvještaj)🟢 gotovo (GUI smoke na hostu)
4Puni AI sloj (MCP, validator, fallback, pristanak, offline)🟢 kod gotov (offline default; Zen ToS neprovjeren)
5Preostali moduli (mreža, drajveri, duplikati, procesi, permisije…)🟢 gotovo (10 scannera; 9 potvrđeno host dokazom 2026-10-14, `tasks` dodat 2026-10-22)
6Installer, potpisivanje, auto-update, javni release🟡 kod gotov; build/release odluka otvorena (nepotpisan)

Validacija na pravom Windows 11 (2026-10-23, laptop, Enterprise N sa WDAC enforced): scan 11/11 scannera bez skipova, host_proof 12/12 PASS (apply → verify → rollback, uključujući nove akcije hosts/share/power), pinovani opencode prihvata naš config (agent `mujofix`, svih 11 alata `deny`), CLI bs/en + JSON nalaza + živa provjera update-a — dokazi u lab/results-win11-laptop/. Ranije: host-direct na drugom Win11 računaru (scan 9/9 u tom runu, 3 akcije uz identičan rollback, GUI smoke, spike 1–2). Puna VM matrica (Win10 + Win11, čist sistem) ostaje kao opciona, produžena validacija — vidi docs/TESTING.md.

Detalji po sesiji: docs/STATUS.md • Pravila za kodere: AGENTS.md

⬇️ Instalacija (Windows, EXE)

Preuzmi sa Releases stranice:

  1. MujoFix-Setup-<verzija>.exe — preporučeno (instalater), ili MujoFix-v<verzija>.zip — portabilna verzija (raspakuj i pokreni MujoFix.exe).
  2. Provjeri hash (opciono, ali preporučeno) — uz release ide SHA256SUMS.txt:
    # PowerShell, u folderu gdje si preuzeo fajlove:
    $a = (Get-FileHash .\MujoFix-Setup-0.4.1.exe -Algorithm SHA256).Hash.ToLower()
    $b = ((Select-String .\SHA256SUMS.txt -Pattern "MujoFix-Setup-0.4.1.exe").Line -split '\s+')[0]
    $a -eq $b   # mora vratiti True
    
  3. Pokreni MujoFix-Setup-0.4.1.exe. Instalira se u %LOCALAPPDATA%\MujoFix, bez administratorskih prava (samo za trenutnog korisnika).
  4. SmartScreen upozorenje je očekivano — build još nije potpisan. Klikni More info → Run anyway.
  5. Prečica ide u Start meni; desktop ikona je opciona (kućica u instalaciji, isključena po defaultu).
  6. Tiha instalacija (npr. više računara): MujoFix-Setup-0.4.1.exe /SILENT (ili /VERYSILENT).
  7. Deinstalacija: Apps & features → MujoFix. Uklanja i ugrađenu OpenCode kopiju i podatke aplikacije (%LOCALAPPDATA%\MujoFix).

Ažuriranje: MujoFixCLI.exe update provjeri ima li nova verzija; update --apply preuzme, provjeri sha256 i pokrene instalater. U GUI-ju isto radi dugme Provjeri ažuriranja.

Zahtjevi: Windows 10/11 (64-bit). Nema Node ni Python — OpenCode je ugrađen i pinovan na tačnu verziju.

netestirano: instalater se kompajlira u CI na svakom push-u, ali njegovo izvršavanje na čistom Win10/Win11 VM-u je još u toku (Issue #1).

Pokretanje (za developere)

# Skeniranje (engine radi i iz CLI-ja)
PYTHONPATH=mujofix python3 -m mujofix.cli scan --summary

# Provjera ažuriranja (--apply preuzme, provjeri sha256 i pokrene; Windows)
PYTHONPATH=mujofix python3 -m mujofix.cli update

# Faza 0 SPIKE (opciono, uz živi model)
python3 scripts/phase0_spike.py --model <provider/model>

# Dokaz akcija na pravom Windowsu (apply -> verify -> rollback)
python3 scripts/host_proof.py

⚠️ Disclaimer

Ovaj alat mijenja sistemske postavke računara i dolazi BEZ IKAKVE GARANCIJE. Prije korištenja se preporučuje backup važnih podataka. Promjene se mogu poništiti samo u okviru ugrađenog rollback-a (snapshot po akciji + karantin 30 dana) — System Restore Point nije implementiran, a oporavak izvan rollback-a nije zagarantovan. Ništa u ovoj aplikaciji nije "100% sigurno".


MujoFix je open source (MIT). Treće strane i licence: THIRD_PARTY_NOTICES.md.

part of xnet-ba matrix — open-source AI iz BiH

About

MujoFix: AI mehanicar za Windows racunar (open source)

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages