How charlymigenes-ux/nopal works
NOPAL is a self-hosted workshop control panel. A browser user enters through the FastAPI application, then uses its dashboard and APIs to monitor or control printers and GRBL machines, or to manage and preview model/G-code files. Distinct branches provide brand-specific printer drivers, laser/CNC control, plugins, AI, and the TUNA-Screen mobile API. Edges are limited to relationships shown in excerpts, the source index, or README; several README-described subsystems have directory-level paths because their implementation was not sampled.
Main entry points: main.py FastAPI application · dashboard_service.py Workshop status · tunascreen_service.py TUNA device facade · app.js Browser UI
Components 25
Application and access
- Browser UI
backend/static/js/app.js - FastAPI application
backend/main.py - Login API
backend/api/auth.py - Accounts and sessions
backend/services/auth_service.py - Access policy
backend/services/authorization_policy.py
Machine operations
- Dashboard API
backend/api/status.py - Workshop status
backend/services/dashboard_service.py - Klipper / Moonraker
backend/services/klipper_service.py - Marlin API
backend/api/marlin_printers.py - Marlin driver
backend/services/marlin_printer_service.py - Bambu driver
backend/services/bambu_service.py - Elegoo driver
backend/services/elegoo_service.py - FlashForge driver
backend/services/flashforge_service.py - Laser / CNC API
backend/api/laser.py - GRBL control
backend/services/laser_service.py
Model and G-code library
- Library and upload API
backend/api/upload.py - Model and G-code files
backend/services/file_service.py - 3D / toolpath preview
backend/static/js/visor/viewer.js
Plugins and AI
- Plugin loading
backend/services/plugin_loader_service.py - AI API
backend/api/ai.py - AI agent and tools
backend/services/ai_agent.py
TUNA-Screen
- TUNA-Screen API
backend/api/tunascreen.py - TUNA device facade
backend/services/tunascreen_service.py - TUNA-Screen client
Other components
- Workshop user
Connections 31
- Workshop user → Browser UI: uses
- Browser UI → FastAPI application: requests
- FastAPI application → Dashboard API: routes
backend/main.py - FastAPI application → Library and upload API: routes
backend/main.py - FastAPI application → Laser / CNC API: routes
backend/main.py - FastAPI application → Login API: routes
backend/main.py - Login API → Accounts and sessions: calls
backend/api/auth.py - FastAPI application → Plugin loading: loads
backend/main.py - Dashboard API → Workshop status: calls
backend/api/status.py - Workshop status → Klipper / Moonraker: queries
backend/services/dashboard_service.py - Workshop status → Marlin driver: queries
backend/services/dashboard_service.py - Workshop status → Bambu driver: queries
backend/services/dashboard_service.py - Workshop status → Elegoo driver: queries
backend/services/dashboard_service.py - Workshop status → FlashForge driver: queries
backend/services/dashboard_service.py - Workshop status → GRBL control: queries
backend/services/dashboard_service.py - Marlin API → Marlin driver: calls
backend/api/marlin_printers.py - Laser / CNC API → GRBL control: calls
backend/api/laser.py - FastAPI application → Access policy: enforces
- Library and upload API → Model and G-code files: manages
- Browser UI → 3D / toolpath preview: previews files
- FastAPI application → AI API: routes
backend/main.py - AI API → AI agent and tools: delegates
backend/api/ai.py - FastAPI application → TUNA-Screen API: routes
backend/main.py - TUNA-Screen client → TUNA-Screen API: requests
- TUNA-Screen API → TUNA device facade: calls
backend/api/tunascreen.py - TUNA device facade → Klipper / Moonraker: delegates
backend/services/tunascreen_service.py - TUNA device facade → Marlin driver: delegates
backend/services/tunascreen_service.py - TUNA device facade → Bambu driver: delegates
backend/services/tunascreen_service.py - TUNA device facade → Elegoo driver: delegates
backend/services/tunascreen_service.py - TUNA device facade → FlashForge driver: delegates
backend/services/tunascreen_service.py - TUNA device facade → GRBL control: delegates
backend/services/tunascreen_service.py