swarmstate¶

Drop-in state backend for LangGraph, CrewAI & custom agent loops - Rust core, framework-agnostic, built for production.

pip install swarmstate uv add swarmstate

Isometric architecture: orchestration frameworks (LangGraph, CrewAI, custom loops) on top; the swarmstate Python API (Store, HandoffGraph, SwarmStateSaver) in the middle; the Rust core (persistent store, msgpack codec, snapshot/diff, condition evaluator) over memory/redis/disk cylinders at the bottom.

Where swarmstate sits: underneath your orchestration framework, as the fast state & checkpointing engine.

No state lock-in¶

A framework-agnostic store with a stable, language-neutral (msgpack) format. Migrate between frameworks without losing accumulated state.

Fast checkpointing¶

A Rust core with fast serialization, O(1) immutable snapshots and incremental diffs. The GIL is released on the hot paths.

Deterministic routing¶

Rule-based "which agent is next" decisions resolved natively in Rust - no LLM tokens spent on transitions you can express as rules.

swarmstate does not compete with visible agent frameworks; it acts as low-level infrastructure, much like engines such as DuckDB, ClickHouse, Arrow, or Polars can sit underneath data applications without replacing them.

See the Guide to get started, or the API reference for the full surface.