Arjunsharma5767/mulecube-os
🛠️ Build your offline world with MuleCube OS, a self-contained knowledge server featuring local AI, offline Wikipedia, mesh communication, and battery backup.
What's novel
🛠️ Build your offline world with MuleCube OS, a self-contained knowledge server featuring local AI, offline Wikipedia, mesh communication, and battery backup.
Code Analysis
11 files read · 3 roundsA Docker Compose-based offline server stack for Raspberry Pi 5 that bundles ~20 services (Kiwix, Open WebUI, Meshtastic, PiHole, etc.) with custom FastAPI microservices for hardware monitoring (I2C battery/temperature), self-healing watchdog with thermal/battery shedding, WiFi AP management, backup/
Strengths
The watchdog's thermal/battery shedding with hysteresis and the hw-monitor's direct I2C MAX17048 register reading show genuine hardware-specific engineering. The two-tier control panel (user vs admin) with proper service tiering, memory limits, and healthchecks demonstrates thoughtful system design for a constrained embedded platform.
Weaknesses
Zero test coverage across all 9 Python services. The backup restore extracts tar to / with no path-traversal protection, and the battery time-remaining uses a hardcoded 500mA draw that won't reflect actual load. The README describes a downloadable .img file and 'on-screen instructions' that don't match the actual curl-pipe-bash installer and Docker-based setup.
Score Breakdown
Signal breakdown
Innovation
Craft
Traction
Scope
Evidence
Commits
10
Contributors
2
Files
77
Active weeks
4
Repository
Language
Python
Stars
1
Forks
0
License
GPL-3.0