Skip to content

System Architecture

Overview

This document describes the architecture of the AI Agent Orchestration Platform, including all major components and recommended open source tools.

Components

  • Frontend: React SPA, React Flow (visual builder), Material UI, Zustand, React Query, Axios, TypeScript
  • Backend: FastAPI (Python), SQLAlchemy ORM, Alembic, Pydantic, JWT/OAuth2/SAML
  • Orchestration: Temporal.io (Python SDK), Docker Engine, A2A protocol
  • Database: PostgreSQL (v15+)
  • Observability: Prometheus, Grafana, Loki, OpenTelemetry, Langfuse, Trulens, Arize, PromptLayer
  • Marketplace/Registry: Agent registry, public/private sharing
  • Infrastructure: Docker Compose, Kubernetes (future), GitHub Actions, Vault

Architecture Diagram (Text)

[User] -> [Frontend (React)] <-> [Backend API (FastAPI)] <-> [Temporal.io]
                                                |-> [PostgreSQL]
                                                |-> [Agent Runner: Docker/API/A2A]
                                                |-> [Observability: Prometheus/Grafana/etc.]
                                                |-> [Marketplace]

Open Source Tools Table

Layer Tools/Projects
Frontend React, React Flow, MUI, Zustand, React Query, Axios, TypeScript
Backend FastAPI, SQLAlchemy, Alembic, Pydantic, PyJWT, httpx
Orchestration Temporal.io, Docker Engine, docker-py, A2A protocol libs
Database PostgreSQL
Observability Prometheus, Grafana, Loki, OpenTelemetry, Langfuse, Trulens, Arize, PromptLayer
CI/CD GitHub Actions, pre-commit, Black, isort, flake8
Secrets HashiCorp Vault