WeaveFlowBuild inspectable agent workflows in Go

Build explicit graphs, constrain state access, inspect every run, and recover from checkpoints

Explicit graph topology

Define serializable nodes, edges, conditions, and entry points instead of hiding control flow in an agent loop

Contract-bound state

Bind State Ports to explicit paths and validate reads, writes, capabilities, and parallel merge behavior before execution

Inspectable runtime

Persist Runs, Events, Checkpoints, and Artifacts so execution can be inspected, paused, resumed, and recovered

What is WeaveFlow?

WeaveFlow is a graph runtime written in Go for building, executing, and inspecting LLM agent workflows. It combines a declarative Graph Definition with explicit execution, checkpointed state, and reusable nodes for model calls, tool use, planning, routing, and human approval.

The project is designed to run locally first: the runtime and Workbench can run on your own machine, while Graph Definitions remain portable JSON documents.

Choose a path

New to WeaveFlow? Start with Why WeaveFlow?, then follow the Quick Start.
Designing a workflow? Learn Graph Definitions, State Bindings, and Nodes and Tools.
Integrating a model or component? Read Model Providers and Custom Nodes.
Operating a workflow? Use the Workbench, Observability guide, and HTTP API reference.
Deploying it? Follow Deploy the Server, then review Configuration and Troubleshooting.