How light-heart-labs/dreamserver works
ODS is a cross-platform installer and local AI-server platform. The main user journey is: install and configure the stack, manage hardware/models and services in Portal, then use the web interfaces and agent workflows against local inference; optional remote providers and cloud APIs extend that runtime. The graph includes documented product capabilities whose implementation was not sampled, using supported enclosing paths. Source excerpts are partial, so uncertain internal wiring is omitted.
Main entry points: app/main.py Model router · dashboard-api/main.py Dashboard API · App.jsx Portal dashboard · pixel-agent Pixel agent
Components 21
Installation
- Setup wizard
installer/src/App.tsx - Platform setup
installer/src-tauri/src/installer.rs
Portal and API
- Portal dashboard
ods/extensions/services/dashboard/src/App.jsx - Dashboard API
ods/extensions/services/dashboard-api/main.py - Route evidence
ods/extensions/services/dashboard-api/routers/model_routes.py - Pixel API
ods/extensions/services/dashboard-api/routers/pixel.py - Extension catalog
ods/extensions/services/dashboard-api/routers/extensions.py
Models and Inference
- Model router
ods/extensions/services/model-router/app/main.py - Host agent
ods/bin/ods-host-agent.py - Model switchboard
ods/bin/model_switchboard
Pixel and Agents
- Pixel interface
ods/extensions/services/dashboard/src/components - Pixel agent
ods/extensions/services/pixel-agent - Agent policy
ods/extensions/services/ape/main.py - Extension lifecycle
ods/extensions/services/pixel-agent/host/extension_manager.py
Stack Capabilities
- AI and homelab services
ods/extensions - Token Spy
ods/extensions/services/token-spy/main.py - Inference sharing
ods/extensions/services/pixel-inference/app/main.py - Remote providers
ods/bin/remote_provider
Other components
- Operator
- Browser user
- Inference backend
Connections 20
- Operator → Setup wizard: starts setup
- Setup wizard → Platform setup: runs install
- Browser user → Portal dashboard: opens Portal
- Portal dashboard → Dashboard API: requests management
- Dashboard API → Host agent: checks host
- Dashboard API → Route evidence: serves route evidence
- Route evidence → Model router: fetches evidence
- Portal dashboard → Pixel interface: opens Pixel
- Pixel interface → Pixel API: requests Pixel services
- Pixel API → Pixel agent: exposes agent features
- Pixel agent → Agent policy: checks tool policy
- Pixel agent → Extension lifecycle: manages extensions
- Dashboard API → Extension catalog: serves extension management
- Model router → Host agent: reads model state
- Model router → Inference backend: forwards inference
- Host agent → Model switchboard: coordinates model state
- Browser user → AI and homelab services: uses installed services
- Token Spy → Inference backend: proxies API requests
- Inference sharing → Model router: forwards inference
- Remote providers → Model router: enables remote routes