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=hosted uses the Caspian gateway; via=self-host runs 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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/trycaspiancaspian-sdk.svg)](https://yunodb.com/tools/trycaspiancaspian-sdk?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/trycaspiancaspian-sdk?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/trycaspiancaspian-sdk.svg" alt="Featured on YunoDB" height="20"></a>