Mu – Micro 个人助理的运行时

Mu 是一个自托管运行时，为开源个人助理 Micro 提供支持。它提供了一个统一收件箱、Web UI、CLI 客户端和 HTTP API，让你能够与 AI 驱动的代理进行交互。代理被赋予指令和一系列服务工具（邮件、日历、搜索、天气、shell 等），它们会选择合适的工具来满足你的请求。

核心概念

概念	是什么	如何使用
Home	Web 仪表板 (http://localhost:8080)，用于创建账户、选择 LLM 提供商并查看正在进行的对话。	启动服务器后在浏览器中打开该 URL。
Inbox	来自 HTTP、SMTP、SMS 或 XMPP 的消息的单一入口点。所有入站通信都以线程形式存储在此处。	发送电子邮件至 `agent@your-domain`，向配置的号码发送短信，或 POST 到 `/agent`。
Agents	AI “大脑”。默认代理是 Micro；可以通过自定义指令和工具集添加额外的代理。	通过 UI、CLI (`mu ask …`) 或 API 提问；代理决定调用哪些服务工具。
Services	向代理公开工具的独立后端（邮件客户端/服务器、网络搜索、RSS 新闻、YouTube 搜索、天气、shell 命令等）。	代理会自动调用这些服务；你也可以直接浏览它们。

安装（快速入门）

# 下载并运行安装脚本
curl -fsSL https://raw.githubusercontent.com/micro/mu/main/install.sh | sh

# 启动服务器（监听 localhost:8080）
~/.local/bin/mu --serve --address 127.0.0.1:8080

在浏览器中打开 http://localhost:8080。
创建账户并选择一个 AI 提供商（例如 OpenAI、Anthropic 等）。
按照可选文档进行更深入的配置（托管、邮件、开发）。

命令行客户端

mu 二进制文件作为一个轻量级客户端，与本地（或远程）服务器通信。

# 向助理提问
mu ask "What needs my attention?"

# 列出收件箱中的线程
mu inbox list

# 显示帮助
mu help

设置 MU_URL 指向自定义服务器，或使用 mu login https://your.host 登录一次。

HTTP API

所有交互都可以通过简单的 REST 端点进行脚本化。

curl "$MU_URL/agent" \
  -H "Authorization: Bearer $MU_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"prompt":"What needs my attention?"}'

响应包含：

text – 助理的回复。
thread – 你发回以继续同一对话的标识符。

身份验证通过持有者令牌 (MU_TOKEN) 处理。可以配置单独的 x402 主机用于付费服务调用（例如，更高级别的 LLM 使用）。

Mu 有何不同？

统一收件箱 – 来自电子邮件、SMS、XMPP 或直接 HTTP 的消息都显示为线程。
可插拔服务 – 代理可以在无需你编写代码的情况下调用丰富的工具集。
自托管 – 在你自己的机器或服务器上运行整个堆栈，保持数据私密。
多协议入口点 – 使用最方便的渠道与助理进行交互。

接下来做什么？

阅读完整的安装指南：docs/INSTALL.md。
在 docs/README.md 中探索服务配置和自定义代理。
通过仓库的贡献指南贡献新的服务或代理。

Mu 本质上是一个个人助理平台，让 LLM 能够作为一个高效的、使用工具的代理，一切尽在你的掌控之中。

micro/mu