rebuno

README

REB-yoo-noh

An open-source execution runtime for production agents.

Rebuno gives your agents durable execution (crash and resume without re-running side effects), an event-sourced record of everything they did, and optional governance over what they're allowed to do.

Quick Start

Prerequisites: Go 1.25+, Python 3.10+

Start the dev kernel (in-memory, no dependencies). With a terminal attached it drops you into a REPL:

go run ./cmd/rebuno dev --config examples/rebuno.dev.yaml

Start an agent in another terminal:

pip install rebuno
python examples/python/hello.py

Create an execution from the REPL and follow its event log:

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

Documentation

Start here:

• Getting Started — 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 — tools, step identity, and idempotency.
• LLM calls — intercepting LLM requests so they replay durably.
• Streaming — view streamed LLM outputs through clients.
• Policy — the YAML rule language for allow / deny / require-approval.
• Events — the event taxonomy and payloads.
• HTTP API — the /v0 client, agent, and admin endpoints.
• CLI — the built-in rebuno REPL.
• 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