Architecture
OMD Cleo is composed of several components — deployed together on Kubernetes.
High-level component map
┌─────────────────────────────────────────────────────────────┐
│ Communication Channels │
│ Matrix · Microsoft Teams · Email · WhatsApp · (future) │
└──────────────────────────┬──────────────────────────────────┘
│
┌──────────────────────────▼──────────────────────────────────┐
│ omd-agents │
│ │
│ FastAPI HTTP API ←→ Agentic Loop ←→ LLM Provider │
│ │
│ Channel clients: Matrix · Teams · Email · WhatsApp · API │
│ │
│ Tools: OData · Superset · Document Hub · Memory · │
│ Code execution · Web search · Email send │
│ │
│ Memory: PostgreSQL · ChromaDB · mem0 / Memgraph │
│ │
│ Temporal worker: scheduled / ad-hoc code execution │
└──────────────────────────┬──────────────────────────────────┘
│ MCP (Streamable HTTP + JWT)
┌──────────────────────────▼──────────────────────────────────┐
│ omd-mcp │
│ │
│ omd-go-service – OData entity query, CRUD │
│ powerhouse-service – Superset BI dashboards, SQL Lab │
│ auth-server – JWKS / JWT issuance (dev / internal) │
│ docs-service – Document Hub (in development) │
└──────────────────────────┬──────────────────────────────────┘
│ REST / OData / SQL
┌──────────────────────────▼──────────────────────────────────┐
│ OMD Back-end Services │
│ OMD Go · OMD Powerhouse (StarRocks + Superset) │
│ OMD Document Hub · OMD Auth (OAuth 2 / OIDC) │
└─────────────────────────────────────────────────────────────┘