Official client SDKs and protocol definitions for the CellaFlow Engine — a high-performance, deterministic execution runtime and cognitive state machine for autonomous AI agents and swarms.
| Language | Package | Status | Documentation |
|---|---|---|---|
| Python | cellaflow |
✅ v0.4.0 (Released) | Python SDK Guide |
| TypeScript | @cellaflow/sdk |
🚧 In Development | Coming Soon |
cellaflow-sdks/
├── proto/ # Shared Protocol Buffer definitions (v1)
│ └── cellaflow/v1/ # Core gRPC services (WorkflowEngineService, Idempotency, etc.)
├── python/ # Official Python SDK (pip install cellaflow)
│ ├── src/cellaflow/ # Decorators, contextvars isolation, gRPC client, MessagePack
│ ├── tests/ # Comprehensive test suite (pytest)
│ └── README.md # Python SDK documentation & quickstarts
├── LICENSE # Project license (Apache 2.0 or MIT)
└── buf.gen.yaml # Buf code generation configuration
To get started with the Python SDK:
# Core SDK for durable workflows and decorators:
pip install cellaflow
# With drop-in LangGraph checkpointer support:
pip install "cellaflow[langgraph]"Check out the full Python SDK Quickstart & Architecture Guide to learn about:
- Zero-friction
@workflow,@step, and@tooldecorators. - Transparent replay recovery from engine crashes.
- Drop-in LangGraph checkpointer integration (
CellaflowSaver). - Cross-agent idempotency key derivation with RFC 8785 Canonical JSON and SHA-256.
- Background lease management with fencing tokens.
This repository is licensed under the Apache 2.0 or MIT License. See LICENSE for details.