BubuStack is an open-source, Kubernetes-native workflow runtime. Define workflows as CRDs, review and promote them via pull requests, and run them with a production runtime that handles retries, artifacts, observability, and RBAC out of the box. The same platform powers batch automations, AI pipelines, and realtime voice/data streaming.
- GitOps-native — Workflows are CRDs. Version, review, and promote them through PRs like any other infrastructure.
- Production runtime — StoryRun/StepRun lifecycle with retries, timeouts, artifacts, tracing, and multi-namespace RBAC.
- Composable building blocks — Reusable Engrams (tasks) and Impulses (triggers) with templates for packaging, defaults, and catalog distribution.
- Batch + streaming in one graph — Orchestrate containers for batch DAGs and wire realtime gRPC streams between steps with the same Story abstraction.
# Install the operator
helm install bubustack oci://ghcr.io/bubustack/charts/bubustack
# Deploy a hello-world Story
kubectl apply -f https://raw.githubusercontent.com/bubustack/bubustack/main/examples/batch/hello-world/bootstrap.yaml
kubectl apply -f https://raw.githubusercontent.com/bubustack/bubustack/main/examples/batch/hello-world/engrams.yaml
kubectl apply -f https://raw.githubusercontent.com/bubustack/bubustack/main/examples/batch/hello-world/story.yaml
# Trigger a run and watch it execute
kubectl apply -f https://raw.githubusercontent.com/bubustack/bubustack/main/examples/batch/hello-world/storyrun.yaml
kubectl get storyruns,stepruns -n hello-world -w| Repository | Description |
|---|---|
bobrapet |
Story, StoryRun, Engram, and Impulse controllers — the core operator |
core |
Shared contracts, templating engine, transport runtime, and identity helpers |
bobravoz-grpc |
Transport operator with hub and peer-to-peer topologies for realtime streaming |
bubu-sdk-go |
Go SDK for building Engrams and Impulses with streaming, retries, and observability |
tractatus |
Canonical protobuf definitions and multi-language transport artifacts |
bubuilder |
Web console and API server for monitoring runs, stories, and engrams |
bubu-registry |
Git-backed component registry and CLI for sharing Engrams and Impulses |
helm-charts |
Helm charts for bobrapet, bobravoz-grpc, and bubuilder |
engrams/* |
First-party Engrams — HTTP, OpenAI, LiveKit, MCP, VAD, and more |
impulses/* |
First-party Impulses — Cron, GitHub webhooks, Kubernetes events, LiveKit webhooks |
| Example | Pattern | What it shows |
|---|---|---|
| Hello World | Batch | Zero-dependency quickstart — parallel steps, DAG dependencies, template expressions |
| Scheduled Health Check | Batch | Cron triggers, parallel fan-out, allowFailure, AI-powered summarization |
| Map-Reduce Summarizer | Batch | Dynamic parallelism with sub-stories, map-reduce adapter, result aggregation |
| Content Digest (Simple) | Batch | RSS → AI extraction → newsletter → Discord via MCP adapter |
| Content Digest (Advanced) | Batch | Multi-feed fan-out with map-reduce, combined digest, Discord notification |
| Multi-Model Consensus | Batch | Same template / different configs, fan-in judge pattern, structured output |
| GitHub PR Review | Batch | AI-powered PR review — GitHub webhooks, diff analysis, automated comments |
| Materialize Demo | Batch | Offloaded data handling — storage refs, materialization, controller-mode resolution |
| Pod Crash Notifier | Streaming | Kubernetes event watch, AI crash analysis, Discord alerts |
| LiveKit Voice Assistant | Streaming | Voice + chat dual-mode — VAD, STT, LLM, TTS with parallel chat path |
| LiveKit Text Chat | Streaming | Text-only chat assistant via LiveKit data channels |
We welcome contributions of all kinds — bug fixes, new Engrams, documentation, and feature proposals.
- Star the repos and watch releases
- Build an Engram or Impulse using the Go SDK
- Report bugs and request features via GitHub Issues
- Pick up a
good first issueorhelp wanted - Discuss architecture and roadmap in Discussions
Read the full Contributing Guide to get started.
- Documentation — Guides, API reference, and architecture deep dives
- GitHub Discussions — Questions, proposals, and community conversations
- Security Policy — Responsible disclosure process
- Code of Conduct — Contributor Covenant 3.0
Apache 2.0 Licensed. Built for platform engineers, AI/ML teams, and anyone who believes workflows belong in Git.