How kianandz/hyperionos works
HyperionOS is a browser-based system administration platform. An administrator accesses the FastAPI application, whose registered routes expose monitoring and operational controls; feature handlers use service modules to inspect or change host and application state. The repository also includes database, file, container, network, website, Samba, and tunnel-management capabilities. The graph follows documented router registration and sampled route-to-service calls; several feature internals are unsampled, so their deeper execution paths are not inferred.
Main entry points: __init__.py Route registry · security.py Session verification · websites Website management · files File manager
Components 25
Web entry and access
- FastAPI application
main.py - Route registry
app/routes/__init__.py - Session verification
app/core/security.py
Monitoring and host
- Metrics dashboard
app/routes/dashboard - System metrics
app/services/metrics - Node management
app/routes/node - Node operations
app/services/node - System settings
app/routes/settings - Settings operations
app/services/settings
Workload services
- Docker controls
app/routes/docker - Docker operations
app/services/docker - Website management
app/routes/websites - Web server operations
app/services/website - Web terminal
app/routes/terminal
Data and files
- Database console
app/routes/database - Database operations
app/services/database - File manager
app/routes/files - File operations
app/services/files
Network services
- Samba management
app/routes/samba - Samba operations
app/services/samba - Firewall controls
app/routes/firewall - Firewall operations
app/services/ufw - Cloudflared controls
app/routes/cloudflared - Cloudflared operations
app/services/cloudflared
Other components
- Administrator
Connections 27
- Administrator → FastAPI application: accesses
README.md - FastAPI application → Route registry: registers routes
main.py - Route registry → Metrics dashboard: registers
app/routes/__init__.py - Route registry → Node management: registers
app/routes/__init__.py - Route registry → System settings: registers
app/routes/__init__.py - Route registry → Database console: registers
app/routes/__init__.py - Route registry → File manager: registers
app/routes/__init__.py - Route registry → Docker controls: registers
app/routes/__init__.py - Route registry → Website management: registers
app/routes/__init__.py - Route registry → Samba management: registers
app/routes/__init__.py - Route registry → Firewall controls: registers
app/routes/__init__.py - Route registry → Cloudflared controls: registers
app/routes/__init__.py - Route registry → Web terminal: registers
app/routes/__init__.py - Metrics dashboard → System metrics: reads metrics
- Node management → Node operations: delegates
app/routes/node/project_route.py - System settings → Settings operations: delegates
app/routes/settings/system_route.py - Database console → Database operations: executes query
app/routes/database/query_route.py - File manager → File operations: transfers files
app/routes/files/transfer_route.py - Docker controls → Docker operations: manages containers
app/services/docker/client.py - Website management → Web server operations: controls services
app/routes/websites/service_route.py - Samba management → Samba operations: controls service
app/routes/samba/service_route.py - Firewall controls → Firewall operations: manages rules
- Cloudflared controls → Cloudflared operations: starts or stops
app/routes/cloudflared/service_route.py - File manager → Session verification: verifies session
app/routes/files/transfer_route.py - Website management → Session verification: verifies session
app/routes/websites/service_route.py - Samba management → Session verification: verifies session
app/routes/samba/service_route.py - Cloudflared controls → Session verification: verifies session
app/routes/cloudflared/service_route.py