caspian-sdk
Unified agent communication SDK for Slack, Discord, Telegram, and email.
One handler layer to connect your AI agent to Slack, Discord, Telegram, WhatsApp, email, and X.
caspian-sdk is an open-source agent communication layer that replaces dozens of individual channel adapters with a single unified handler. It is built for developers embedding AI agents into messaging platforms who want to avoid maintaining custom bot lifecycles and webhook verification.
What it is
The SDK normalizes disparate messaging platforms into a consistent Thread and Message model, handling webhook verification, platform quirks, and concurrent chat overlaps. You write declarative routing rules for commands and events, allowing your agent to interact across channels without bespoke integration logic.
Who it's for
It suits developers building multi-channel AI assistants who are tired of maintaining separate Slack, Discord, and Telegram bot codebases. It does not suit teams looking for a low-code UI builder or conversational analytics dashboard.
Key features
Unified Channel Adapters
Connects your agent to Slack, Discord, Telegram, WhatsApp, email, and X through a single integration interface.
Declarative Routing Rules
Filters incoming messages by channel, command, and overlap policies using a clean decorator-based syntax.
Hosted or Self-Host
Run via Caspian's gateway polling or bring your own tokens and webhooks inside your own server process.
Built-in Webhook Security
Handles signature verification automatically for Slack, Meta, Telegram, X, and email webhooks.
Up and running in 3 steps
Our honest verdict
What's great
- Replaces dozens of individual platform adapters with one consistent API model.
- Supports both Python and TypeScript with matching developer contracts.
- Includes offline fakes for every channel to run extensive test suites without network calls.
- Provides advanced thread capabilities like typing indicators, streaming edits, and rich media sends.
Where it falls short
- Requires managing platform-specific bot tokens, rate limits, and webhook endpoints if self-hosting.
- Relying on the default hosted mode means depending on Caspian's gateway service and API keys.
- Built under the AGPL-3.0 license, which carries strict open-source distribution requirements for network services.
Pricing & license
Free under its AGPL-3.0 open-source licence, with a hosted gateway option available through their dashboard service.
Open remote AI-training roles
873 open remote AI-training roles, updated November 15, 2026; most pay $20–$170 an hour. Zekai lists them free; the application goes to the employer’s platform.
Alternatives
These reviewed AI tools do the same job instantly — from our scored directory.
Use it, or have us set it up
FAQ
Can I run this without Caspian's hosted gateway?
Yes, you can use via='self-host' to manage your own platform tokens, webhooks, and sockets directly in your process.
Which programming languages are supported?
The SDK natively supports Python (3.10+) and TypeScript / Node.js (18+) / Bun.
How does it handle concurrent messages in the same chat?
You can configure overlap policies such as queue, debounce, drop, or parallel to serialize incoming messages cleanly.
