Skip to content

Build agents and workflows that survive

Durable runtime documentation

Build agents and workflows
that survive.

Ironflow is a durable runtime for AI agents and event-driven systems. Resume completed work after crashes, wait safely for external input, and derive state from events, all in one binary.

Start with the workload you are building

Both paths use the same events, durable steps, waits, and projections.

Durable agents

Protect model and tool work

Use the native Node or Go agent API for registered tools, durable model calls, approvals, child agents, and MCP exposure. Or persist LangGraph checkpoints with the shipped saver.

Build an agent →See framework fit →

Run the local runtime

Start with SQLite and embedded NATS. No account or Cloud access required.

$brew install sahina/tap/ironflow
$ironflow serve --dev
# open localhost:9123
$docker pull ghcr.io/sahina/ironflow-releases:latest
$docker run -p 9123:9123 ghcr.io/sahina/ironflow-releases:latest serve --dev
# open localhost:9123
# download the release for your platform
$./ironflow serve --dev
# open localhost:9123
All installation options →

Four primitives behind both paths

Events

Append domain facts to an ordered stream. Functions and projections can react to the same event.

Durable steps

Memoize completed results so a restarted run skips finished work and continues from what remains.

Waits

Suspend for an event or approval without holding a worker. Resume when the external input arrives.

Projections

Derive read models from event history and rebuild them when the view or schema changes.

Understand the runtime →

Keep the history behind the result

Events + recorded execution

Append, inspect, replay, rebuild

Events and recorded execution steps form an append-only history. Inspect what happened, replay when needed, and rebuild derived state without guesswork.

Event history is inherent to entity streams. Execution recording is opt-in today, so enable recording when you need an inspectable function-step history.

Learn from a runnable path

Start with a tutorial, then move into a complete example.

TUTORIAL · AGENT

Survive a worker crash

Build a document-processing agent, stop its worker mid-run, and resume from completed durable steps.

Run the agent tutorial →
TUTORIAL · WORKFLOW

Emit, react, and derive

Start the server, emit events, run a durable function, and build a projection from event history.

Run the workflow tutorial →
EXAMPLE · AGENT

Code review with approval

See native agent APIs, durable model calls, registered tools, and a human approval wait in one example.

Open the code-review agent →
EXAMPLE · WORKFLOW

CQRS order flow

Follow commands into events and projections with a complete event-driven application example.

Open the CQRS example →

Go directly to the surface you need