AgentFlow4J¶
Build governed, stateful multi-agent workflows in Java — orchestration, persistence, and runtime observability.
Spring AI gives you LLM primitives (ChatClient, tools). AgentFlow4J gives you a structured runtime for multi-step systems. Going from single prompts to multi-agent workflows makes execution stateful, failure-prone, and hard to inspect. AgentFlow4J provides the execution graph, durable state, and governance gates to run those workflows safely — all in idiomatic Java, no sidecar, no YAML.
Get started GitHub repo JitPack
What you get¶
| Spring AI | AgentFlow4J runtime |
|---|---|
Primitives (ChatClient, tools) |
Structured execution (AgentGraph, CoordinatorAgent) |
| Manual orchestration glue | Graph-based execution & dynamic routing |
| No durable state | Typed shared state (StateKey<T>) + checkpoints |
| Retry logic in user code | Built-in retry & circuit-breaker policies |
| No resume | Interrupt & resume from the last valid checkpoint |
| Agents fully trusted | Governed execution — tool, state-write, budget and approval gates |
Try it in 30 seconds¶
git clone https://github.com/datallmhub/agentflow4j.git
cd agentflow4j
mvn install -DskipTests -q
mvn -pl agentflow4j-samples exec:java
Runs SupportTriageDemo — a customer-support ticket flowing through a graph: triage → specialist → policy gate → reply. Falls back to deterministic stubs offline, or calls Mistral when MISTRAL_API_KEY is set.
Where to next¶
- First time? The Getting started guide takes you from
mvndependency to a running graph. - Want runnable examples? The Cookbook has five self-contained Java recipes — RAG, ticket triage, web research, Slack bot, batch processing.
- New here? Start with Two API levels — the Squad vs Graph distinction.
- Worried about cost or unsafe actions? Read the governance trilogy: tool, state and approval gates.
- Building for production? Durable runs shows how to survive a mid-workflow crash.
- Want the full story? The Stop your agent burning $1000 overnight tutorial walks through every governance piece end-to-end.
Scope
AgentFlow4J is an independent open-source project. It is not an official Spring project.