Skip to main content

​
Before you begin

Install Go 1.26+, plus Python 3.11+ or Node 22+ to run the agent.
1

Start the dev kernel

Point the dev kernel at a config to register agents on boot:
Each entry gives an agent’s webhook_url, its HMAC secret, and optionally a policy block or a policy_file path.
Without a policy, an agent runs unrestricted. See Policy for the rule language.
2

Run an agent

An agent is an HTTP service that speaks the kernel’s protocol. The hello example listens on :5000 and calls back to the kernel on :8080. In a second terminal, start it:
3

Create an execution

In a third terminal:
exec watch tails events until the run finishes. exec events prints the whole log with payloads. See CLI.

​
Where to go next

Architecture

The domain model, state machines, and how durability works.

Agents

The webhook protocol and the dispatch and replay lifecycle.

Policy

Allow, deny, or hold a step for human approval.

HTTP API

The /v0 client, agent, and admin endpoints.

Python SDK

Build agents and clients in Python.

TypeScript SDK

Build agents and clients in TypeScript.

Deployment

Running the production kernel, its config, and Docker.