Tutorials

End-to-end walkthroughs that show swarmstate in real workflows. Each is runnable and builds on the Guide.

LangGraph: resumable agents

Swap in SwarmStateSaver, persist and resume threads, and time-travel across the whole checkpoint DB with store snapshots.

Custom multi-agent loop

Build a triage system with deterministic HandoffGraph routing and a shared Store - no orchestration framework required.

State portability across frameworks

Write state from one system, read it from another - the anti-lock-in story, using the stable msgpack format.

CrewAI: shared, portable memory

Durable, portable keyword recall around a CrewAI crew with SwarmStateStorage, in a store shared with your other agents (optionally on Redis/disk).

Prerequisites

pip install swarmstate                 # core (Store, HandoffGraph)
pip install "swarmstate[langgraph]"    # + LangGraph checkpointer

# or with uv
uv add swarmstate
uv add "swarmstate[langgraph]"

Runnable examples

Prefer to read code? The repo ships self-contained, offline, deterministic scripts in examples/:

• support_triage.py
• a LangGraph workflow combining HandoffGraph routing, SwarmStateSaver checkpointing and snapshot/restore time-travel.
• state_portability.py
• state as standard msgpack, read back and cross-checked.