mutbot

基于 mutagent 的 Web 应用，提供 Workspace/Session 管理、Agent 对话、终端集成、文件编辑等功能。

Note: 早期开发阶段。

快速开始

pip install mutbot
python -m mutbot

启动后访问 http://localhost:8741。

python -m mutbot --host 0.0.0.0 --port 8741   # 远程访问模式

前端开发

cd frontend && npm install && npm run dev      # HMR 开发
npm run build                                   # 生产构建 → src/mutbot/web/frontend_dist/

技术栈

• 后端：FastAPI + uvicorn
• 前端：React 19 + flexlayout-react + xterm.js + Monaco Editor
• 通信：WebSocket（Agent 事件流 + 终端 I/O）

设计文档

详见 docs/specifications/ 目录。

Pysandbox namespace sharing

mutbot 的 /mcp 端点在标准 MCP 之上额外声明 capabilities.pysandbox， 允许另一个 mutagent / mutbot 实例通过 mcp_sources 配置将本实例的 namespaces（mutbot.* 等）平铺融合进其 sandbox。标准 MCP 客户端 （Claude Code）不受影响，仍只看到一个 pysandbox tool。

协议详情：mutagent/docs/specifications/feature-pysandbox-namespace-sharing.md。

发布

Tag 触发自动发布（PyPI Trusted Publishers，无需 token）：

git tag v0.2.x
git push origin v0.2.x

CI 自动执行：PyPI 发布 → 构建前端 → 推送到 mutbot.ai（public/v<version>/ + 更新 versions.json）。

源码版本保持 x.y.999，CI 从 tag 提取正式版本号替换后构建发布。

License

MIT