Skip to content

Demo UI Example

This page explains how to run the local React UI with the Python FastAPI swarm backend.

Use this when you want to:

  • present a code-defined multi-agent swarm from a browser
  • inspect runtime events and checkpoints
  • create sessions and send messages against the typed FastAPI routes

Start backend and frontend in separate terminals:

bash
python examples/fastapi_swarm.py
npm -C demo-ui run dev

The demo UI reads root .env defaults:

  • MODEL_PROVIDER optional, defaults selected provider
  • LLM_MODEL optional, defaults selected model
  • SWARMFORGE_HOST optional, defaults to 127.0.0.1
  • SWARMFORGE_PORT optional, defaults to 8000

Related source pages:

Released as open source.