Skip to main content
Start the Starlette web interface. Provides a live debate view with WebSocket streaming, a transcript dashboard, and a settings page for provider and model configuration.

​
Usage

dissent serve [OPTIONS]

​
Options

OptionDefaultDescription
--port8080Port to bind to (1–65535)
--host127.0.0.1Host address to bind to
--no-openoffSuppress automatic browser launch

​
Examples

# Default — binds to localhost:8080 and opens browser
dissent serve

# Custom port
dissent serve --port 9000

# Bind to all interfaces (e.g. for remote access)
dissent serve --host 0.0.0.0 --port 8080 --no-open

​
Web UI Features

Debate view — run debates from the browser with live streaming. Each model’s response appears as it arrives via WebSocket. Research dashboard — browse saved transcripts, view convergence and influence charts, inspect cost breakdowns per model. Config panel — view and edit provider keys and routing configuration from the UI.

​
Notes

  • dissent serve blocks until the server is stopped (Ctrl+C)
  • Navigating away from an in-progress debate will orphan the running asyncio task — results will not be recoverable. Stay on the debate page until synthesis completes.
  • The web UI reads transcripts from ~/.mutual-dissent/transcripts/ — transcripts from CLI debates appear in the dashboard automatically