Skip to content

The kaboo stack

kaboo is a small stack for building multi-agent apps with live, inspectable agent activity: define agents in YAML and serve them as AG-UI SSE (kaboo-workflows), persist and replay the full event log inside a CopilotKit runtime (kaboo-runtime), and render hierarchical agent activity with drill-down and human-in-the-loop in React (kaboo-react). The kaboo-workflows-demo assembles all three into a runnable reference.

flowchart LR
  subgraph Python
    W[kaboo-workflows<br/>YAML agents → AG-UI SSE]
  end
  subgraph Node
    R[kaboo-runtime<br/>CopilotKit AgentRunner + ThreadStore]
  end
  subgraph Browser
    C[kaboo-react<br/>agent-activity UI]
  end
  DB[(Postgres)]
  C -->|/api/copilotkit| R
  R -->|HttpAgent /invocations| W
  R <-->|persist / replay| DB
  W -->|AG-UI events| R
  R -->|streamed events| C

New here? Start here to pick a path, or follow the full-stack tutorial to wire all three together.

Libraries

  • kaboo-workflows — YAML multi-agent orchestration → AG-UI SSE (Python / PyPI).

    Docs · Repo

  • kaboo-runtime — CopilotKit runtime persistence: a custom AgentRunner + pluggable ThreadStore that replays the full event log.

    Docs · Repo

  • kaboo-react — React components + hooks for live, hierarchical agent activity inside a CopilotKit chat.

    Docs · Repo

  • kaboo-workflows-demo — the Kaboo lab: a runnable mini-Kaboo wiring the three libraries together, with a scenario for each pattern, shipped as an example in this repo.

    Example

Run the demo

The fastest way to see the whole stack in action is the lab — a chat beside a dashboard canvas, with sub-agents, questions, approvals, generative UI and replay across reloads, each in a scenario that replays without a model.

  1. Clone this repo and open the examples/kaboo-workflows-demo directory.
  2. Follow its Run it steps: yarn install, uv sync in pipeline-service, yarn db:up, then yarn dev.
  3. Open http://localhost:3100, pick a scenario in the header, and click its turns at the bottom of the chat.

Contributing

One shared model spans every repo — see Contributing to the kaboo stack.