rebuno

README

Rebuno is an open-source execution runtime for production agents.

It records every tool call and LLM call as a durable step. Interrupted runs resume from the last recorded step instead of starting over. Any step can be allowed, denied, or held for human approval.

Quick Start

Prerequisites: Go 1.26+, Python 3.11+ / Node 22+

Install the CLI and clone the repo for the examples:

go install github.com/rebuno/rebuno/cmd/rebuno@latest
git clone https://github.com/rebuno/rebuno && cd rebuno

Start the dev kernel:

rebuno dev --config examples/rebuno.dev.yaml

Start an agent in another terminal:

Python

pip install rebuno
python examples/python/hello.py

TypeScript

npm install rebuno
npx tsx examples/typescript/hello.ts

Create an execution and follow its event log:

rebuno exec create hello '{"query": "hello world"}'
rebuno exec watch <id>

Documentation

Start here:

• Quickstart: run the kernel and your first agent.
• Architecture: the domain model, state machines, and how durability works.

Reference:

• Agents: how an agent process receives work and drives its effects.
• Tools: effects, step identity, and idempotency.
• LLM calls: intercepting LLM requests so they replay durably.
• Streaming: live token deltas while a step is running.
• Policy: the YAML rule language for allow / deny / require-approval.
• Events: the event types and their payloads.
• HTTP API: the kernel's HTTP endpoints under /v0.
• CLI: the rebuno binary and its commands.
• Deployment: running the production kernel, config, and Docker.
• Python SDK: building with Python
• TypeScript SDK: building with TypeScript
• Dashboard: web UI to view executions, steps, events, and agent activity.

License

MIT