Opta Local Web

Opta Local Web is a browser-based React dashboard that provides real-time monitoring, model management, and a streaming chat interface for your Opta LMX inference server.

What is Opta Local Web?

Opta Local Web is the visual companion to the Opta CLI. While the CLI gives you terminal-native access to the Opta stack, the web dashboard offers the same capabilities through a modern browser interface. It connects directly to your LMX inference server as a thin client -- there is no intermediate backend or server-side rendering layer between the dashboard and your hardware.

The dashboard is designed for monitoring and interactive use. You can watch VRAM utilization in real time, see which models are loaded, track inference throughput, and start chat sessions -- all from any browser on your network.

Thin Client Architecture

Unlike traditional web applications that require a backend server to process requests, Opta Local Web communicates directly with the LMX API from the browser. The React app is served as static files (from a Next.js dev server or a static export) and makes client-side HTTP and SSE requests to the LMX endpoints.

Connection Architecture

Browser (Opta Local Web)
    |
    |  HTTP requests to /v1/chat/completions
    |  SSE connection to /admin/events
    v
Opta LMX  192.168.188.11:1234
    |
    |  MLX inference on Apple Silicon
    v
Loaded Models (GPU memory)

This architecture means zero additional infrastructure. The web dashboard adds no server processes, no databases, and no state management layers. It reads directly from the same API that the CLI daemon consumes.

Dual-Mode Access

Opta Local Web operates in two distinct modes depending on how you access it.

LAN Mode

When accessed from a device on your local network, the dashboard connects directly to LMX by IP address. No authentication is required -- LAN access is trusted by default. This is the recommended mode for development workstations on the same network as your inference server.

WAN Mode

For remote access outside your LAN, the dashboard can be served through a Cloudflare Tunnel. In this mode, Supabase authentication is enforced -- users must sign in before they can interact with the dashboard. This lets you access your local stack from a phone, a laptop at a coffee shop, or any remote device with a browser.

Authentication is context-dependent

The dashboard detects its access mode automatically. On LAN, auth controls are hidden and all endpoints are open. Through the Cloudflare Tunnel, the sign-in page appears and a valid Supabase session is required for all operations.

Premium Glass UI

The interface follows the Opta design system: an OLED-optimized dark theme with obsidian glass panels, violet accent colors, and the Sora typeface. Interactive elements use the .glass-subtle and .glass-strong CSS classes for layered translucency effects. All colors are defined through CSS custom properties, and animations use Framer Motion spring physics.

Real-Time Monitoring

The dashboard maintains a persistent SSE (Server-Sent Events) connection to the LMX /admin/events endpoint. This provides continuous updates for:

VRAM utilization (current and peak usage)
Active model list with memory footprint per model
Token throughput (tokens per second, rolling history)
Server health status with heartbeat monitoring
Active inference request count

Data is buffered in a 300-entry circular buffer on the client side, giving you a scrollable history of throughput and utilization without any server-side persistence.

Getting Started

To run the Opta Local Web dashboard locally:

Terminal

cd optalocal/1L-Opta-Local/web
npm install
npm run dev    # starts on http://localhost:3004

Ensure your LMX server is running on the expected address (default: 192.168.188.11:1234). The dashboard will connect automatically and begin streaming status data.

Monitoring

Dashboard