Skip to content

Web UI Overview

Saturn's Web UI is a browser-based dashboard for discovering AI services, managing server configurations, and chatting with models — all from a single interface.

Launch

saturn web

This starts a FastAPI server on port 3000. Open http://localhost:3000 in any browser.

# custom port
saturn web --port 8080

Tip

The Web UI works on any device on the same network. Share http://<your-ip>:3000 with others, or use Remote Access for access outside your LAN.

Architecture

BrowserDiscoverThree.js · mDNS scanChatSSE streaming · MCPSystemStatus · Remote · IntegratelocalStoragechat history (50 max)CRT terminal aestheticHTTPSSEFastAPI Server:3000Brutus auto-routerpriority sort · failoverCircuit breaker3 errors → 30s cooldownephemeral key rotationadmin auth · CORSmDNS discovery_saturn._tcp.local.admin_config.jsonsaturn.dbserver filesystemOllamalocal · :11434OpenRoutercloud · ephemeral keyLM Studionetwork · discovered via mDNSdeployment=localdeployment=clouddeployment=networkCloudflare Tunneloptional remote accessOpenAI-compatible

The server discovers Saturn-compatible AI services via mDNS, proxies chat requests through its Brutus auto-router, and streams responses back to the browser over SSE (Server-Sent Events). A circuit breaker protects against cascading failures — after 3 consecutive errors, a backend is taken out of rotation for 30 seconds.

Tabs

The UI has three top-level tabs:

Tab Purpose Audience
Discover Scan the network, view services, configure new backends Everyone / Admins
Chat AI conversations with model selection, streaming, file attachments, MCP tools Everyone
System Backend health, routing logs, usage metrics, remote access, integration guides Admins / Developers

Discover

The landing page. An animated 3D Saturn scene (rendered with Three.js) shows the network's state — each orbiting moon represents an online service. Press Discover to scan for services via mDNS. Administrators can authenticate and configure new services directly from this tab.

See Discover for details.

Chat

The primary interaction point. Select a service and model (or let Brutus auto-route), then chat with streaming responses. Supports thinking modes, file attachments, response styles, MCP tool calls, and up to 50 persistent conversations.

See Chat, Models & Parameters, and MCP Tools.

System

Three subtabs for operational visibility:

  • Status — health grid with circuit breaker state per service
  • Remote — Cloudflare tunnel management for external access, with QR codes
  • Integrate — pre-filled configuration snippets for OpenCode, Aider, Cursor, and other tools

See System & Monitoring, Remote Access, and Cost Tracking.

Visual Style

The Web UI uses a CRT terminal aesthetic — black background, scanline overlay, monospace fonts, and a golden Saturn accent color (#f0c040). A subtle grain filter and vignette effect complete the retro look. Three visual variants (Refined, DOS/BIOS, Swiss Brutalist) are available for customization.

Data Storage

Data Location Persistence
Chat history Browser localStorage Per-browser, max 50 conversations
Service configs ~/.saturn/services/*.toml Server filesystem
Admin settings data/admin_config.json Server filesystem
Usage tracking data/saturn.db (SQLite) Server filesystem

Note

Chat history lives in your browser's localStorage. Clearing browser data removes it. Use the JSON/Markdown export in the sidebar to save important conversations.