https://github.com/AlexsJones/sympozium
Run a fleet of AI agents on Kubernetes. Administer your cluster agentically
https://github.com/AlexsJones/sympozium
agentic agentic-ai kubeclaw openclaw
Last synced: 4 months ago
JSON representation
Run a fleet of AI agents on Kubernetes. Administer your cluster agentically
- Host: GitHub
- URL: https://github.com/AlexsJones/sympozium
- Owner: AlexsJones
- License: mit
- Created: 2026-02-23T09:53:24.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-12T22:18:15.000Z (4 months ago)
- Last Synced: 2026-03-13T03:49:59.415Z (4 months ago)
- Topics: agentic, agentic-ai, kubeclaw, openclaw
- Language: Go
- Homepage: https://sympozium.ai/
- Size: 21 MB
- Stars: 250
- Watchers: 4
- Forks: 34
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Roadmap: docs/roadmap.md
- Agents: AGENTS.md
Awesome Lists containing this project
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](https://deploy.sympozium.ai/docs/)
---
### Quick Install (macOS / Linux)
**Homebrew:**
```bash
brew tap AlexsJones/sympozium
brew install sympozium
```
**Shell installer:**
```bash
curl -fsSL https://deploy.sympozium.ai/install.sh | sh
```
Then deploy to your cluster and activate your first agents:
```bash
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](https://cert-manager.io/) (for webhook TLS):
```bash
kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.17.1/cert-manager.yaml
```
Deploy the Sympozium control plane:
```bash
helm install sympozium ./charts/sympozium
```
See [`charts/sympozium/values.yaml`](charts/sympozium/values.yaml) for configuration options.
---
## Why Sympozium?
Sympozium serves **two powerful use cases** on one Kubernetes-native platform:
1. **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.
2. **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.
### Isolated Skill Sidecars
**Every skill runs in its own sidecar container** — a separate, isolated process injected into the agent pod at runtime with ephemeral least-privilege RBAC that's garbage-collected when the run finishes.
> _"Give the agent tools, not trust."_
---
## Documentation
| Topic | Link |
|-------|------|
| Getting Started | [deploy.sympozium.ai/docs/getting-started](https://deploy.sympozium.ai/docs/getting-started/) |
| Architecture | [deploy.sympozium.ai/docs/architecture](https://deploy.sympozium.ai/docs/architecture/) |
| Custom Resources | [deploy.sympozium.ai/docs/concepts/custom-resources](https://deploy.sympozium.ai/docs/concepts/custom-resources/) |
| PersonaPacks | [deploy.sympozium.ai/docs/concepts/personapacks](https://deploy.sympozium.ai/docs/concepts/personapacks/) |
| Skills & Sidecars | [deploy.sympozium.ai/docs/concepts/skills](https://deploy.sympozium.ai/docs/concepts/skills/) |
| Channels | [deploy.sympozium.ai/docs/concepts/channels](https://deploy.sympozium.ai/docs/concepts/channels/) |
| Security | [deploy.sympozium.ai/docs/concepts/security](https://deploy.sympozium.ai/docs/concepts/security/) |
| CLI & TUI Reference | [deploy.sympozium.ai/docs/reference/cli](https://deploy.sympozium.ai/docs/reference/cli/) |
| Helm Chart | [deploy.sympozium.ai/docs/reference/helm](https://deploy.sympozium.ai/docs/reference/helm/) |
| Ollama & Local Inference | [deploy.sympozium.ai/docs/guides/ollama](https://deploy.sympozium.ai/docs/guides/ollama/) |
| Writing Skills | [deploy.sympozium.ai/docs/guides/writing-skills](https://deploy.sympozium.ai/docs/guides/writing-skills/) |
| Writing Tools | [deploy.sympozium.ai/docs/guides/writing-tools](https://deploy.sympozium.ai/docs/guides/writing-tools/) |
---
## Development
```bash
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