README
¶
Every agent is an ephemeral Pod.
Every policy is a CRD. Every execution is a Job.
Orchestrate multi-agent workflows and let agents diagnose, scale, and remediate your infrastructure.
Multi-tenant. Horizontally scalable. Safe by design.
From the creator of k8sgpt and llmfit
This project is under active development. API's will change, things will be break. Be brave.
Full documentation: deploy.sympozium.ai/docs
Quick Install (macOS / Linux)
Homebrew:
brew tap sympozium-ai/sympozium
brew install sympozium
Shell installer:
curl -fsSL https://deploy.sympozium.ai/install.sh | sh
Then deploy to your cluster and activate your first agents:
sympozium install # deploys CRDs, controllers, and built-in PersonaPacks
sympozium # launch the TUI — go to Personas tab, press Enter to onboard
sympozium serve # open the web dashboard (port-forwards to the in-cluster UI)
Advanced: Helm Chart
Prerequisites: cert-manager (for webhook TLS):
kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.17.1/cert-manager.yaml
Deploy the Sympozium control plane:
helm repo add sympozium https://deploy.sympozium.ai/charts
helm repo update
helm install sympozium sympozium/sympozium
See charts/sympozium/values.yaml for configuration options.
Why Sympozium?
Sympozium serves two powerful use cases on one Kubernetes-native platform:
- Orchestrate fleets of AI agents — customer support, code review, data pipelines, or any domain-specific workflow. Each agent gets its own pod, RBAC, and network policy with proper tenant isolation.
- Administer the cluster itself agentically — point agents inward to diagnose failures, scale deployments, triage alerts, and remediate issues, all with Kubernetes-native isolation, RBAC, and audit trails.
Key Features
| PersonaPacks | Helm-like bundles for AI agents — activate a pack and the controller stamps out a full agent team |
| Skill Sidecars | Every skill runs in its own sidecar with ephemeral least-privilege RBAC, garbage-collected on completion |
| Multi-Channel | Telegram, Slack, Discord, WhatsApp — each channel is a dedicated Deployment backed by NATS JetStream |
| Persistent Memory | SQLite + FTS5 on a PersistentVolume — memories survive across ephemeral pod runs |
| Scheduled Heartbeats | Cron-based recurring agent runs for health checks, alert triage, and resource right-sizing |
| Agent Sandbox | Kernel-level isolation via kubernetes-sigs/agent-sandbox — gVisor or Kata with warm pools for instant starts |
| MCP Servers | External tool providers via Model Context Protocol with auto-discovery and allow/deny filtering |
| TUI & Web UI | Terminal and browser dashboards, or skip the UI entirely with Helm and kubectl |
| Any AI Provider | OpenAI, Anthropic, Azure, Ollama, or any compatible endpoint — no vendor lock-in |
Documentation
Development
make test # run tests
make lint # run linter
make manifests # generate CRD manifests
make run # run controller locally (needs kubeconfig)
License
Apache License 2.0
Directories
¶
| Path | Synopsis |
|---|---|
|
api
|
|
|
v1alpha1
Package v1alpha1 contains API Schema definitions for the sympozium.ai v1alpha1 API group.
|
Package v1alpha1 contains API Schema definitions for the sympozium.ai v1alpha1 API group. |
|
channels
|
|
|
discord
command
Package main is the entry point for the Discord channel pod.
|
Package main is the entry point for the Discord channel pod. |
|
slack
command
Package main is the entry point for the Slack channel pod.
|
Package main is the entry point for the Slack channel pod. |
|
telegram
command
Package main is the entry point for the Telegram channel pod.
|
Package main is the entry point for the Telegram channel pod. |
|
whatsapp
command
Package main is the entry point for the WhatsApp channel pod.
|
Package main is the entry point for the WhatsApp channel pod. |
|
cmd
|
|
|
agent-runner
command
|
|
|
apiserver
command
Package main is the entry point for the Sympozium API server.
|
Package main is the entry point for the Sympozium API server. |
|
controller
command
Package main is the entry point for the Sympozium controller manager.
|
Package main is the entry point for the Sympozium controller manager. |
|
ipc-bridge
command
Package main is the entry point for the Sympozium IPC bridge sidecar.
|
Package main is the entry point for the Sympozium IPC bridge sidecar. |
|
mcp-bridge
command
Package main is the entry point for the Sympozium MCP bridge sidecar.
|
Package main is the entry point for the Sympozium MCP bridge sidecar. |
|
memory-server
command
memory-server runs as a standalone Deployment per SympoziumInstance.
|
memory-server runs as a standalone Deployment per SympoziumInstance. |
|
node-probe
command
Package main is the entry point for the Sympozium node-probe DaemonSet.
|
Package main is the entry point for the Sympozium node-probe DaemonSet. |
|
sympozium
command
Package main provides the sympozium CLI tool for managing Sympozium resources.
|
Package main provides the sympozium CLI tool for managing Sympozium resources. |
|
web-proxy
command
Package main is the entry point for the web-proxy that exposes Sympozium agents as OpenAI-compatible and MCP HTTP endpoints.
|
Package main is the entry point for the web-proxy that exposes Sympozium agents as OpenAI-compatible and MCP HTTP endpoints. |
|
webhook
command
Package main is the entry point for the Sympozium admission webhook server.
|
Package main is the entry point for the Sympozium admission webhook server. |
|
internal
|
|
|
apiserver
Package apiserver provides the HTTP + WebSocket API server for Sympozium.
|
Package apiserver provides the HTTP + WebSocket API server for Sympozium. |
|
channel
Package channel provides base types and interfaces for Sympozium channel implementations.
|
Package channel provides base types and interfaces for Sympozium channel implementations. |
|
controller
Package controller provides Agent Sandbox (kubernetes-sigs/agent-sandbox) CRD support for AgentRun reconciliation.
|
Package controller provides Agent Sandbox (kubernetes-sigs/agent-sandbox) CRD support for AgentRun reconciliation. |
|
eventbus
Package eventbus provides OTel trace context propagation over NATS headers.
|
Package eventbus provides OTel trace context propagation over NATS headers. |
|
ipc
Package ipc implements the IPC bridge sidecar that mediates communication between ephemeral agent pods and the durable Sympozium control plane.
|
Package ipc implements the IPC bridge sidecar that mediates communication between ephemeral agent pods and the durable Sympozium control plane. |
|
mcpbridge
Package mcpbridge implements the MCP bridge sidecar that translates between file-based IPC and remote MCP servers via JSON-RPC 2.0 Streamable HTTP.
|
Package mcpbridge implements the MCP bridge sidecar that translates between file-based IPC and remote MCP servers via JSON-RPC 2.0 Streamable HTTP. |
|
orchestrator
Package orchestrator handles the construction of Kubernetes Jobs/Pods for AgentRun executions and manages sub-agent spawning.
|
Package orchestrator handles the construction of Kubernetes Jobs/Pods for AgentRun executions and manages sub-agent spawning. |
|
session
Package session provides session persistence and transcript storage backed by PostgreSQL with pgvector for memory embeddings.
|
Package session provides session persistence and transcript storage backed by PostgreSQL with pgvector for memory embeddings. |
|
webhook
Package webhook provides validating and mutating admission webhooks for Sympozium.
|
Package webhook provides validating and mutating admission webhooks for Sympozium. |
|
webproxy
Package webproxy provides the HTTP proxy that exposes Sympozium agents as OpenAI-compatible and MCP endpoints.
|
Package webproxy provides the HTTP proxy that exposes Sympozium agents as OpenAI-compatible and MCP endpoints. |
|
pkg
|
|
|
telemetry
Package telemetry provides shared OpenTelemetry initialization for all Sympozium components.
|
Package telemetry provides shared OpenTelemetry initialization for all Sympozium components. |
Click to show internal directories.
Click to hide internal directories.