← all repositories
TryCaspian/caspian-sdk

Your agent shouldn't need 25 Slack adapters to say hello

Caspian gives your AI agent one identity across email, Slack, Telegram, and the rest, so you stop maintaining channel plumbing and start letting the model decide where to reply.

846 stars Python AgentsCoding Assistants
caspian-sdk
Velocity · 7d
+34
★ / day
Trend
accelerating
star history

What it does

Caspian is a communication SDK that treats Slack, Discord, Telegram, email, and other human channels as interchangeable transports for an AI agent. You write one message handler; the SDK normalizes payloads, manages threading, and routes replies back through whatever service the human used. It is explicitly agent-to-human plumbing, not an agent-to-agent protocol like A2A.

The interesting bit

The SDK flips the usual integration model: instead of hardcoding per-channel bots, you register one identity and let the agent reason about how to talk on each platform. The hosted gateway handles webhook verification, signature checks, and restart-safe idempotency, while offline fakes let you test real platform payload shapes without network calls.

Key highlights

  • One handler receives messages from every connected channel in a normalized format
  • Built-in webhook verification for Slack, Meta, Telegram, X, and signed email
  • Cross-channel continuity: the same human on Instagram today and email tomorrow is one conversation thread
  • Serverless-ready with a webhook dispatch path for Lambda and Vercel
  • Pluggable provider registry and 131 offline tests across Python and TypeScript

Caveats

  • The README mentions self-hosting but is light on what running your own gateway actually entails
  • Free channels connect instantly, but paid ones such as X, WhatsApp, and iMessage require prepaid credit and a one-time developer sign-in
  • Google Meet voice participation is marked as Beta on the managed gateway

Verdict

Worth a look if you’re building an agent that needs to reach humans where they already hang out and you’re tired of maintaining five separate bot integrations. Skip it if your agent lives entirely inside a single chat UI or if you need deep, platform-native features that the normalized abstraction would flatten.

Frequently asked

What is TryCaspian/caspian-sdk?
Caspian gives your AI agent one identity across email, Slack, Telegram, and the rest, so you stop maintaining channel plumbing and start letting the model decide where to reply.
Is caspian-sdk open source?
Yes — TryCaspian/caspian-sdk is open source, released under the AGPL-3.0 license.
What language is caspian-sdk written in?
TryCaspian/caspian-sdk is primarily written in Python.
How popular is caspian-sdk?
TryCaspian/caspian-sdk has 846 stars on GitHub and is currently accelerating.
Where can I find caspian-sdk?
TryCaspian/caspian-sdk is on GitHub at https://github.com/TryCaspian/caspian-sdk.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.