sente-sdk 0.1.0

Managed email identities for AI agents — the Python client for Sente (import sente).

sente-sdk

Managed email identities for AI agents — the Python client for Sente. Give your agent a real, reusable email address it owns: send, receive, and react to mail.

Dependency-free (stdlib only). The PyPI distribution is sente-sdk; the import is sente.

pip install sente-sdk

from sente import Sente

sente = Sente(api_key="sk_sente_...")              # get a key with the `sente` CLI: `sente login`

idt = sente.identities.create(name="support-bot")  # -> [e-mail]
sente.messages.send(idt.id, to="[e-mail]", subject="hi", text="from your agent")

# React to inbound mail (a long-running consumer; for production prefer a webhook):
for msg in sente.messages.stream(idt.id):
    if msg.direction != "outbound":
        body = (msg.parsed or {}).get("text", "")
        # ... handle msg.from_addr / msg.subject / body

Webhook handlers receive a thin event { "type": "message.received", "message": { "id": ... } } with an x-sente-secret header; fetch the full message with sente.messages.get(message_id).

Full onboarding playbook (CLI + framework templates): https://sente.run/skill.md.