Web UI

Soup includes a built-in web dashboard for managing experiments, training, and data.

Launch

bash
pip install 'soup-cli[ui]'
soup ui
# Opens http://127.0.0.1:7860 in your browser
# Prints auth token to console
bash
# Custom port, don't auto-open browser
soup ui --port 8080 --no-browser

Pages

  • Dashboard — view all experiment runs, loss charts, system info
  • New Training — create configs from templates, validate, and start training
  • Data Explorer — browse and inspect datasets (JSONL, JSON, CSV, Parquet)
  • Model Chat — chat with a running soup serve inference server

Security

The Web UI generates a random auth token at startup (printed to console). All mutating endpoints require Authorization: Bearer <token> header.

  • CORS is restricted to the served origin (not wildcard)
  • Data inspection is sandboxed to the working directory
  • Config validation before writing
  • HTTP error responses return generic messages (details logged server-side)