Skip to content

Architecture

TBD Agents is a distributed system designed to run custom AI agents at scale.

  • System Overview

    Components, request flow, and how the pieces connect.

    System Overview

  • Data Model

    Entity relationships and document schemas.

    Data Model

  • Scaling

    Horizontal scaling strategies for workers, API, and infrastructure.

    Scaling

System at a Glance

graph LR
    Client([Client / Dashboard]) -->|HTTP| API[FastAPI API]
    API -->|Enqueue| Redis[(Redis)]
    Redis -->|Task| Worker[Celery Workers]
    Worker -->|SDK Session| SDK[Copilot SDK]
    SDK --> Models[Copilot Models API]
    SDK --> MCP[MCP Servers]
    Worker -->|Publish Events| Redis
    Redis -->|Subscribe| API
    API -->|SSE Stream| Client
    Worker -->|Persist| Mongo[(MongoDB)]
    API -->|Read/Write| Mongo