caspian-sdk 0.1.0

One identity for your AI agent across every channel — email, Slack, Discord, WhatsApp, SMS, X, Telegram, iMessage — behind a single on_message handler.

caspian-sdk

Give your AI agent one identity that reaches any human, on whatever app they already use — email, Slack, Discord, WhatsApp, SMS, X, Telegram, iMessage — all behind a single on_message handler.

You write the handler once. Caspian handles the provider quirks, threading, delivery, and dedup for every channel.

pip install caspian-sdk

Quickstart

from caspian_sdk import CommClient

client = CommClient(api_key="YOUR_KEY")

# Connect any channel — email needs nothing; others take a token or one-click OAuth.
inbox = client.connect_email()
print("Agent address:", inbox["address"])

@client.on_message
def handle(message):
    # The same handler answers every channel you connect.
    message.reply(f"Thanks! You said: {message.text}")

client.listen()  # one loop, every channel

Channels

	Connect
Email	connect_email() — default domain or your own
Slack	install_slack() (one-click) or connect_slack(...)
Discord	install_discord() (one-click) or connect_discord(...)
X / Twitter	install_x() (one-click) or connect_x(...)
WhatsApp	connect_whatsapp(...) (Twilio or Meta)
SMS / phone	connect_phone(...) — bring your own Twilio/Telnyx number
Telegram	connect_telegram(bot_token=...)
iMessage	connect_imessage()

How it works

• One handler, every channel. Adding a channel is another connect_*() call — never new handler code.
• message.reply() answers in the right thread on the right channel automatically.
• message.typing() shows a "typing…" indicator while your agent thinks (where the platform supports it).
• client.listen() is resilient — a handler error or a dropped poll won't stop the loop.

Docs

Point your coding agent at the setup guide and it does the whole integration for you. Full docs and your API key: trycaspianai.com.

License

MIT