CellaFlow SDKs

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.

---

📦 Available SDKs

Language	Package	Status	Documentation
Python	cellaflow	✅ v0.8.0 (Released)	Python SDK Guide
TypeScript	@cellaflow/sdk	✅ v0.8.0 (Released)	TypeScript SDK Guide

---

🏗️ Repository Structure

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
├── typescript/         # Official TypeScript SDK (npm install @cellaflow/sdk)
│   ├── src/            # gRPC client, connect-es definitions, MessagePack
│   └── README.md       # TypeScript SDK documentation & quickstarts
├── LICENSE             # Project license (Apache 2.0 or MIT)
└── buf.gen.yaml        # Buf code generation configuration

---

🚀 Getting Started

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 @tool decorators.
• 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.

---

📜 License

This repository is licensed under the Apache 2.0 or MIT License. See LICENSE for details.