caspian-sdk
Agent communication SDK. The open-source agent communication layer for AI agents — email, WhatsApp, Slack, Discord, Telegram, SMS. Python & TypeScript.
What is caspian-sdk?
Agent communication SDK. The open-source agent communication layer for AI agents — email, WhatsApp, Slack, Discord, Telegram, SMS. Python & TypeScript.
Overview of caspian-sdk
What it is
Caspian is an agent communication SDK. It provides an open-source agent communication layer for AI agents to communicate via email, WhatsApp, Slack, Discord, Telegram, SMS, and other channels. It supports Python and TypeScript.
Key features
- Declarative rules:
@cx.on_message()filters for channel, chat kind, command, overlap, and instant ack. The bot's rules are inspectable data. - Webhook verification: Handles Slack signing secret, Meta X-Hub-Signature-256, Telegram secret header, X CRC, and signed email webhooks. Mismatches are rejected.
- Hosted or self-host:
via=hosteduses the Caspian gateway;via=self-hostruns adapters in your process with your platform tokens. Switch modes without rewriting handlers. - One handler for multiple channels: Add channels with
cx.channels.add()and handle messages with a single@cx.on_message()decorator. - Normalized Thread/Message model: Messages arrive as kernel events regardless of transport, with overlap policies (queue, debounce, drop, parallel) and
thread.post()/thread.reply()methods.
Use cases
- Connecting AI agents to human communication channels such as Slack, Discord, Telegram, email, WhatsApp, X, and Linear.
- Replacing per-channel adapter code with a single SDK integration.
- Allowing agents to decide which channel to use for communication based on context.
Getting started
bashpip install caspian-sdk # Python 3.10+npm install caspian-sdk # TypeScript / Node 18+ / BunGet an API key from dashboard.trycaspianai.com, then use the SDK as shown in the README examples.
License and pricing
Licensed under AGPL-3.0. Open source (free).
Based on the project's public README and repository metadata.