Platform Architecture
This section documents the technical architecture of Swiss AI Hub. The content here is a deep dive — for the marketing-level platform overview, see Core Components and Infrastructure Layers under Vision & Positioning.
The architecture is modelled with LikeC4, rendered as interactive diagrams via web components. Source files live in docs/likec4/ and are regenerated automatically by the docs dev server. Use the C4 hierarchy to navigate:
- System Context — L1: people and external systems that interact with Swiss AI Hub
- Containers — L2: the platform's first-party packages, infrastructure, and how they connect; includes tier breakdowns
- Swiss AI Agent Protocol — Control / Display event model over NATS
- Network Isolation — Docker network zones and traffic policy
Coming soon as the LikeC4 model expands:
- Runtime Scenarios — dynamic views of chat streaming, document ingestion, bot-in-the-loop, agent discovery
- Deployment Topology — prod deployment with per-class agent instances, OIDC middleware, host-network OpenWebUI
- Component Internals — L3 component views for each first-party package (these will live on the per-package pages under Code Deep Dive)
