内容
align="center">
<img src="https://github.com/user-attachments/assets/4986c4b8-28fa-45ea-9be9-78c1c7133128" alt="Mosoo" width="96" height="96" />
</p>
# Mosoo
**一款用于编码代理的开源代理运行时。**
在隔离的AI代理沙盒中，通过API端点运行OpenAI Codex、Claude Agent SDK和OpenCode。
Mosoo提供了一个Cloudflare原生的控制平面，用于流式传输工具活动、检查运行历史记录，并跨执行保持线程和文件。它可以在您自己的账户中自行托管。
您的应用程序仍然属于您。其后端拥有产品行为和最终用户访问权限。Mosoo专注于代理执行和生命周期；应用程序部署是一个单独的Alpha表面，而不是核心产品合同。
```text
配置代理 + 技能 + MCP + 提供商
-> 预览和发布代理版本
-> 从后端或Mosoo控制台调用它
-> 流式传输处理权限请求、检查文件和使用情况
-> 在运行中继续线程
```
<p align="center">
<a href="https://try.mosoo.ai">试用 Mosoo</a> ·
href="https://mosoo.ai">官方网站</a> ·
<a href="https://mos/docs">API 文档</a> ·
<a href="https://github.com/langgenius/mosoo-connector">Mosoo 连接器</a>
</p>
## 和API：当前功能
- **代理运行时和控制平面。和运行OpenAI Codex、Claude Agent SDK和OpenCode一个标准化的运行时协议后面 **代理API。** 从的后端启动、跟随、停止、存档和删除代理工作。
- **AI代理。** 流式传输响应和工具活动，处理权限请求，取消工作，并在隔离的执行环境中检查诊断信息。
- **持久工作。** 在单个执行之间保持线程、运行、事件和管理的文件。
- **代理可观察性。** 检查运行状态、可重放的活动、诊断信息和使用情况估计操作可见性，而不是合规审计跟踪或提供商账单。
## 适用人群
Mosoo适用于通过Codex、Claude Agent SDK、OpenCode或其他编码代理扩展到产品和自动化的开发人员，他们不希望为每个集成运行单独的代理运行时、沙盒服务、会话存储、文件管道和代理API。
## 产品状态
Mosoo处于Alpha阶段。上述托管代理API表面已经发布并库测试的覆盖，但生产可靠性和外部采用尚未得到验证API和产品行为仍可能产品和工程参考：
- 规范产品合同：[docs/SPEC.md](./docs/SPEC.md)
- PRD索引和历史实现合同：[docs/prd/README.md](./docs/prd/README.md)
- 当前实现架构：[docs/architecture.md](./docs/architecture.md)
- 开发和贡献指南：[CONTRIBUTING.md](./CONTRIBUTING.md)
## 示例：构建Codex代理API
[Codex Pet](./examples/use-cases/codex-pet.md)展示了一个已发布的Mosoo代理，通过线程API集成到现有的产品后端。相同的API可以公开由Claude Agent SDK或OpenCode支持的代理。
https://github.com/user-attachments/assets/4a4bbaab-c192-4462-99e0-020eab966fff
## 本地开发
前提条件：
- `bun >= 1.4.0-canary.1`
- `just >= 1.51`
- 用于代理运行时和沙盒流程的Docker兼容守护进程
从干净的克隆开始：
```bash
git clone --recurse-submodules https://github.com/langgenius/mosoo.git
cd mosoo
just setup
just dev
```
`just setup`安装依赖项，初始化子模块，创建或完成`apps/api/.dev.vars`，安装Git钩子，并应用待处理的本地D1迁移。`just dev`在启动Web和API开发服务器之前重新应用待处理的迁移。
本地网址：
- Web：`http://localhost:5173`
- API：`http://localhost:8787`
最低烟雾测试：
```bash
curl http://localhost:5173/api/health
curl http://localhost:8787/api/health
```
API健康检查为`/api/health`，而非`/health`。Mosoo控制平面开发登录使用OTP；在本地环回源中，以`@mosoo.ai`结尾的地址跳过OTP并直接登录。
如果设置失败，请从专注的配方开始：子模块问题使用`git submodule update --init`，缺少本地机密使用`just env-init`，D1模式错误使用`just db-migrate`。有关完整的工作流程和验证期望，请参见[CONTRIBUTING.md](./CONTRIBUTING.md)。
公共登录页面和博客位于私有`langgenius/mosoo-website`存储库中，并在`mosoo.ai`上单独部署。
MCP 市场