Metadata-Version: 2.4
Name: mutbot
Version: 0.8.4
Summary: A Python AI Bot based on mutagent
Author: tiwb
License-Expression: MIT
Project-URL: Homepage, https://github.com/tiwb/mutbot
Project-URL: Repository, https://github.com/tiwb/mutbot
Keywords: ai,agent,llm,runtime,hot-reload
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mutagent[web-extract]~=0.6.0
Requires-Dist: pyte>=0.8.0
Requires-Dist: PyJWT[crypto]>=2.8.0
Requires-Dist: pywinpty>=2.0.0; sys_platform == "win32"
Dynamic: license-file

# mutbot

基于 [mutagent](https://github.com/tiwb/mutagent) 的 Web 应用，提供 Workspace/Session 管理、Agent 对话、终端集成、文件编辑等功能。

> **Note:** 早期开发阶段。

## 快速开始

```bash
pip install mutbot
python -m mutbot
```

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

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

## 前端开发

```bash
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/](docs/specifications/) 目录。

## 发布

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

```bash
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
