Skip to content

v0.1.0 — Initial release: programmatic inboxes for Python agents

Choose a tag to compare

@shanjairaj7 shanjairaj7 released this 01 Mar 05:26
· 19 commits to main since this release

First public release of commune-mail — the Python SDK for giving AI agents real email inboxes.

What's included

  • CommuneClient and AsyncCommuneClient for sync and async workflows
  • client.inboxes.create() — provision a real inbox in one line
  • client.messages.send() — send email or reply in existing thread
  • client.threads.list() and client.threads.messages() — read conversation history
  • client.search.threads() — semantic search across inbox history
  • Webhook verification with verify_signature()

Why this exists

AI agents need to communicate with the outside world asynchronously. Email is the universal protocol — every system, every user, every tool speaks SMTP. But raw SMTP requires DNS setup, deliverability management, and thread tracking. commune-mail gives your agent a production-grade inbox in one line of code.

Quickstart

pip install commune-mail
from commune import CommuneClient

client = CommuneClient(api_key="comm_...")
inbox = client.inboxes.create(local_part="support")
# → support@agents.commune.email — real, deliverable, webhook-ready

Framework integrations

Works with LangChain, CrewAI, OpenAI Agents SDK, Claude, and any Python agent framework. See the cookbook for examples.