v0.1.0 — Initial release: programmatic inboxes for Python agents
First public release of commune-mail — the Python SDK for giving AI agents real email inboxes.
What's included
CommuneClientandAsyncCommuneClientfor sync and async workflowsclient.inboxes.create()— provision a real inbox in one lineclient.messages.send()— send email or reply in existing threadclient.threads.list()andclient.threads.messages()— read conversation historyclient.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-mailfrom commune import CommuneClient
client = CommuneClient(api_key="comm_...")
inbox = client.inboxes.create(local_part="support")
# → support@agents.commune.email — real, deliverable, webhook-readyFramework integrations
Works with LangChain, CrewAI, OpenAI Agents SDK, Claude, and any Python agent framework. See the cookbook for examples.