Distributed Agents Lab

Professional multi-microservice demo showing distributed agents implemented in Python (FastAPI), demonstrating three communication transports:

• Messaging (RabbitMQ)
• MCP (Model Context Protocol - simulated)
• WebSockets (real-time)

Includes a small Next.js dashboard to monitor events and submit transactions.

How it's organized

distributed-agents-lab/
 ├── services/
 │    ├── messaging/      # RabbitMQ-based services
 │    ├── websocket/      # WebSocket orchestrator + agents
 │    └── mcp/            # MCP-simulated orchestrator + agents
 ├── orchestrator/        # API gateway (FastAPI) used by Next.js client
 ├── client/              # Next.js dashboard
 └── docker-compose.yml

Quick start (local)

Make sure you have Docker and Docker Compose v2 installed.

Run:

docker compose up --build

This will start:

• RabbitMQ (if messaging mode used)
• All Python services and the Next.js client

Open Next.js UI at http://localhost:3000 API gateway at http://localhost:8000

-- End of README