Yuva

io.github.productdevbookv0.0.4更新于 Oct 9, 2026

Customer support inbox: search, read, triage and draft replies to e-mail and chat.

已验证Streamable HTTP可网页运行Business & CommerceCommunication & Collaboration

概览

AI 生成的概览

让助手在 Yuva 收件箱中搜索、阅读、分类客户支持邮件和聊天，并起草回复。

功能
将助手连接到 Yuva 客户消息收件箱，使其能够搜索和阅读支持邮件与实时聊天会话、进行分类，并撰写草稿回复供团队成员发送。Yuva 本身不运行任何模型；助手以用户身份登录工作，API 密钥的作用域和收件箱成员权限限制了它可访问的范围。清单未列出具体工具名称。
适用场景
适用于团队使用 Yuva 处理客户支持，并希望助手帮助整理来信会话和准备回复草稿的场景。它面向自托管的 Yuva 部署，而非通用收件箱。
运行要求
需要 Yuva 服务器地址（YUVA_URL）和 Yuva API 密钥（YUVA_API_KEY）；密钥的作用域和所属收件箱决定助手能做什么。可作为远程端点或本地进程运行，服务器本身需自托管（一个 Go 二进制文件加 Postgres，或 Docker 镜像）。
安装前请注意
项目自称处于 pre-alpha 阶段：API 和数据库结构可能变更且没有迁移路径，代码也未经过独立安全审计，因此应使用测试数据而非真实客户会话进行试用。API 密钥（YUVA_API_KEY）属于机密，助手可以读取客户会话并撰写草稿。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Yuva，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "yuva": {
      "type": "http",
      "url": "https://{yuva_host}/mcp"
    }
  }
}

README

[Yuva logo]

Yuva

One inbox for every product you run.

Open-source customer messaging: support e-mail, live chat and in-app conversations from all of your products in one shared inbox. Self-hosted, one Go binary with Postgres.

Website · Docs · API · Releases · Roadmap

[Release] [CI] [License: AGPL-3.0] [SDKs: MIT]

[The Yuva panel: conversations from three products in one list, an in-app conversation with a note and a reply, and the contact's details.]

[!WARNING] Pre-alpha. The API and database schema can change without migration paths, and the code has not had an independent security audit. Try it with test data, not real customer conversations.

Why Yuva

  • Every product, one inbox. Each product is an inbox with its own branding, language, hours and team. Members see only the inboxes they were given.
  • Every channel, one conversation. E-mail with proper threading, live chat with the <yuva-chat> web component, in-app messages and feedback through native iOS and Android SDKs, and an API for everything else.
  • Your users stay yours. Your backend signs a short-lived identity token; Yuva never sees your user database. Signed webhooks let your backend send its own push notifications.
  • Headless when you want it. Scoped API keys, bots that write drafts for a member to send, an event feed and a headless JS client let you build your own inbox, chat and automations.
  • Works with AI assistants. A built-in MCP server lets Claude, ChatGPT, Cursor and other assistants triage and draft replies, signed in as you with OAuth. Yuva runs no model itself.
  • Small to run. One Docker image and Postgres. No Redis, no separate workers.

Quick start

sh
docker pull ghcr.io/productdevbook/yuva:0.0.4
  1. Write compose.yaml and .env from the install guide.
  2. Start it: docker compose up -d.
  3. Create the first owner: docker compose exec yuva /yuva bootstrap --email [email protected] --workspace "Example".
  4. Put it behind HTTPS and sign in with the code that arrives by e-mail.

Documentation

Get startedChannelsIntegrateBuild on it
InstallE-mailIdentity tokensHeadless
ConfigurationWeb widgetWebhooksAI assistants (MCP)
OperationsMobile SDKsAPI contractExamples

How it is built: architecture. What is next: roadmap. What changed: changelog.

Repository

PathWhatLicense
api/Go server: API, realtime, e-mail, jobsAGPL-3.0
web/Team panel (React)AGPL-3.0
edge/Cloudflare Email Worker for inbound mailAGPL-3.0
site/Website and documentationAGPL-3.0
deploy/Docker and ComposeAGPL-3.0
openapi/API contractMIT
sdk/jsuseyuva: headless client, <yuva-chat>, React hooks, typed /v1 clientMIT
sdk/swift, sdk/kotliniOS and Android SDKsMIT
sdk/goTyped /v1 client, identity tokens and webhook verificationMIT
examples/Headless chat, event feed and draft botMIT

Contributing

Issues and pull requests are welcome; read CONTRIBUTING.md first. Contributions are made under the CLA. Report security issues privately as described in SECURITY.md.

License

The server and panel are AGPL-3.0; the SDKs and the API contract are MIT, so they ship inside closed-source apps without copyleft obligations. Details in LICENSING.md. The name and logo are covered by TRADEMARK.md.

“Yuva” is Turkish for nest, or home.

来源：README.md，提交 010591b

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v0.0.4最新Oct 9, 2026