Deploy the Streaming Service in Two Commands
The FastAPI + WebSocket server ships with Ai|oS under aios/web/aios/web/. Run it locally or
push to any VPS. The dashboard below automatically connects to ws://localhost:8080/ws, but you can
point it at any reachable endpoint.
Local Launch (Dev)
cd aios/web/aios/web
python3 -m venv .venv
source .venv/bin/activate
pip install fastapi uvicorn psutil
uvicorn streaming_server:app --host 0.0.0.0 --port 8080
Keep the terminal open to watch connection logs. Set PORT to override the default.
Systemd Deployment (Prod)
# Copy files to /opt/aios-streaming
sudo cp streaming_server.py /opt/aios-streaming/
sudo cp streaming_dashboard.html /opt/aios-streaming/
# Register service
sudo tee /etc/systemd/system/aios-streaming.service <<'EOF'
[Unit]
Description=Ai|oS Streaming Dashboard
After=network.target
[Service]
WorkingDirectory=/opt/aios-streaming
ExecStart=/usr/bin/python3 streaming_server.py
Restart=always
Environment=PORT=8080
[Install]
WantedBy=multi-user.target
EOF
sudo systemctl enable --now aios-streaming
Reverse-proxy through Nginx or Caddy to serve wss:// in production.
Live Telemetry Console
Enter a WebSocket URL to connect to your own instance or stay in demo mode to preview the streaming UX. When a real stream is connected the simulator pauses automatically and the dashboard reflects true telemetry.
Telemetry Snapshot
Connect Your Stream
The simulator produces realistic telemetry every second. Press Connect after your server is live to switch to production data instantly.
Event Log
Why Operators Use the Ai|oS Streaming Interface
Unified Metrics Plane
Kernel, security, and application agents publish into the same socket so your dashboard mirrors the orchestration state machine in seconds.
Zero Install Operator Console
Serve the dashboard from any static host and connect over WebSockets. Perfect for remote trials, blue-team training, or audited customer walk-throughs.
Toggleable Simulation Mode
The built-in simulator mimics real metrics while your SOC considers connecting production systems, allowing instant on-site demonstrations that match the live UX.
Bring Your Own Events
Extend broadcast_event in streaming_server.py to push audit logs, trace
spans, or escalation alerts alongside baseline telemetry without rewriting the dashboard.