sutradhaar

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 11 Open GitHub ↗

Sutradhaar - agent gateway: SOUL.md agents, SKILL.md skills, MCP servers, A2A handoff, pipeline canvas. Docker one-command deploy.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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`](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](https://www.docker.com/products/docker-desktop/), or [Colima](https://github.com/abiosoft/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.

```bash
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.

```bash
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`](docs/README.full.md) for the full architecture, API reference, and service-connection details -- useful during and after the workshop.

sutradhaar

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README