Getting started

Let your agent talk to any human

Caspian gives your AI agent one identity that reaches people wherever they already are (email, Slack, Discord, WhatsApp, SMS, X, Telegram, iMessage), all behind a single on_message handler. You write the handler once; Caspian handles every provider's quirks, threading, delivery, and dedup.

New here? Jump straight to the Quickstart and have your agent replying on a real channel in about two minutes.

The one-handler model

Every channel (a Slack thread, an SMS, a WhatsApp chat, an email) arrives at the same handler. You reply with message.reply(), and Caspian sends it back on the right channel, in the right thread, formatted the way that platform expects.

agent.py
from caspian_sdk import CommClient

client = CommClient()               # reads COMM_API_KEY from env / .env

client.connect_email()              # one line per channel, no handler changes

@client.on_message
def handle(message):
    message.reply(f"You said: {message.text}")

client.listen()                     # one loop, every channel
agent.ts
import { CommClient } from "caspian-sdk";

const client = new CommClient();           // reads COMM_API_KEY from env / .env

await client.connectEmail();               // one line per channel

client.onMessage(async (message) => {
  await message.reply(`You said: ${message.text}`);
});

await client.listen();                     // one loop, every channel

Adding a channel is another connect_*() call, never new handler code.

Channels

Free channels cost nothing and need no signup. Paid channels run on Caspian's own network and unlock after a one-time sign-in.

Email free
A real inbox on our domain or yours.
Slack free
One-click app or bring your own.
Discord free
Shared bot or your own bot token.
Telegram free
Bring a @BotFather token.
WhatsApp
Twilio or Meta Cloud API.
SMS & phone free
Your own Twilio/Telnyx number.
X (Twitter)
Reactive DM bot.
iMessage
Blue-bubble messaging.

How it fits together

Next steps

Quickstart →
Install, get a key, send your first message.
Authentication →
Keys, sign-in, and free vs paid.
Core concepts →
Connections, conversations, threading.
SDK reference →
Every method, Python and JS.