Web UI overview

The web UI is a Next.js application that connects to your Orchestrator over WebSocket and lets you query your mesh from any browser.

Features

  • Mesh canvas — Interactive visualization of your nodes. Click or lasso-select nodes to include in a query.
  • Streaming responses — Tokens stream in real time as the LLM synthesizes.
  • Source attribution — Every response shows which files and nodes contributed.
  • Voice input — Hold-to-record microphone with server-side Whisper transcription.
  • Persistent auth — JWT token is stored in localStorage and auto-reconnects on reload.

Connecting

Enter your Orchestrator URL (ngrok or direct) and your credentials on the login page. After connecting, you land on the dashboard.

Configuration

Set NEXT_PUBLIC_ORCHESTRATOR_URL in .env:

NEXT_PUBLIC_ORCHESTRATOR_URL=https://abc123.ngrok-free.app

Development

cd web-ui
npm install
npm run dev   # http://localhost:3000