Workshop Agent Gateway
A lightweight, visual agent gateway for learning multi-agent patterns (OpenClaw concepts, A2A protocol, MCP tools). Build agents with SOUL.md personas, wire them together with A2A handoffs, and watch them communicate in real time on a live dashboard.
Full reference (architecture, API, directory structure, connecting real Gmail/Sheets/Telegram) lives in
docs/README.full.md. This README covers only what you need before the workshop.
Before the Workshop: Set This Up
Please do this ahead of time so we don't spend workshop time on downloads and installs.
1. Install Docker
Docker Desktop, or Colima if you prefer a lighter CLI-only setup. Make sure it's running before you start.
2. Have a Telegram account
No bot yet -- we'll create the bot token together during the workshop.
3. Have a Google account (Gmail + Sheets)
No OAuth setup yet -- we'll walk through enabling the Gmail/Sheets APIs and authorizing the app together during the workshop.
Verify Your Setup Works
Clone the repo and bring the gateway up once, ahead of time, to make sure Docker works.
git clone <this-repo-url>
cd sutradhaar
docker compose up -d --build
No .env file needed. Open http://localhost:8192 and confirm the dashboard loads.
If the dashboard loads, you're ready for the workshop.
docker compose down
(You can leave it running too -- either is fine, we'll bring it back up at the start of the workshop.)
See docs/README.full.md for the full architecture, API reference, and service-connection details -- useful during and after the workshop.