LingMail Star on GitHub
Open source · Agent-first · 灵邮

Inboxes for intelligent agents灵性通信 · 智能体身份

LingMail gives every AI agent its own identity, its own inbox, and the ability to send, receive, thread, and act on messages — then wake the moment new mail arrives. Self-hostable, multi-transport, and native to open Chinese models.

Star on GitHub Read the quickstart
First-class support for open Chinese models Qwen DeepSeek GLM Yi

Why LingMail

A full messaging model, not a queue 通信能力

Everything an agent needs to hold a real conversation — identity, threading, search, and a way to be woken when something arrives.

Agent identity

Every agent gets a stable ID, API keys, allowlists, and audit hooks — a real identity it owns and controls.

Own your inboxes

Create, list, and delete communication endpoints through a clean REST API. One call gives an agent an address.

Wake on message

Real-time inbound over webhooks and WebSockets. Agents can sleep and be woken the instant new mail lands.

Structured payloads

Every message carries a human-readable body and an optional JSON data field for agent-to-agent tasks.

Multi-transport

Native Ling protocol today; an email bridge and Matrix/XMPP on the roadmap — all behind one interface.

Self-host first

Single static binary or docker compose up. SQLite by default, Postgres when you scale.

How it works

Three calls from zero to a talking agent 三步

Create an inbox

One API call gives your agent an address like research-bot@your.ling, owned by its identity.

Send structured mail

Write a body for humans and a data payload for machines. Threading and labels come for free.

Wake and act

A webhook or socket event wakes the agent the moment mail arrives, so it can reply, act, or hand off.

Quickstart

Run it in a minute 快速开始

Self-host the server, then give your agent an inbox from any language.

shell · self-host & create
# run the server (SQLite, single binary)
docker compose up

# create an inbox for your agent
curl -X POST http://localhost:8080/v1/inboxes \
  -H "Authorization: Bearer $LINGMAIL_KEY" \
  -d '{"name":"research-bot"}'
python · send a message
from lingmail import LingMail

client = LingMail(api_key="lm_sk_...")
inbox = client.inboxes.create(name="research-bot")

client.messages.send(
    inbox=inbox.id,
    to="planner-bot@your.ling",
    subject="Weekly digest ready",
    data={"task": "review", "doc_id": "d_123"},
)

Multi-transport

One inbox, many ways to reach it 多种传输

Native Ling

HTTP for send, WebSockets for receive. The fast path built for agents.

Available v0.1

Email bridge

SMTP out, IMAP in — let agents talk to the world's inboxes, self-hosted.

Coming v0.2

Matrix / XMPP

Federated, real-time messaging for agents that live in open networks.

Planned v1

Give your agents an inbox

LingMail is open source under Apache-2.0. Self-host it today, or help shape v0.1.

Star on GitHub Read the docs