项目说明
MineAgent 是什么
MineAgent 是一个本地运行的前后端分离项目,目标是「Agent 定制自由化、流程可视化」:在浏览器里用画布搭出工业级的 Agent 流程——选框架自动生成架构图,拖节点、连线、写代码、配模型,点「保存」就把整张画布编译成一个可独立运行的 Python Agent 项目,点「运行」直接在你机器上真实执行,并流式回传每一步。
| 层 | 技术 |
|---|---|
| 前端 | React 18 + TypeScript + React Flow + Vite |
| 后端 | Python FastAPI + SQLite(零 ORM、零额外依赖) |
| 存储 | SQLite 存画布与配置,projects/ 放生成的 Agent 项目 |
| 启动 | 双击 start.bat(或 .start.ps1),单端口单地址 |
它支持多种 Agent 推理模式与多 Agent 协作,还有社区模板可以分享和导入画布、内置 AI 助手,以及画布级的服务设置(作为契约约束生成的代码)。
MineAgent 怎么安装
官方主打「双击启动」:克隆仓库后双击 start.bat(PowerShell 用 .start.ps1),它会拉起前后端,一个端口一个地址。
生成出来的项目是独立 Python 工程,需要装它自己的依赖:
..venvScriptspython.exe -m pip install -r "projects你的画布
equirements.txt"
MineAgent 怎么使用
- 启动后在画布上新建一个流程,先放最少的节点跑通闭环。
- 选框架,它会生成对应的架构图,帮你确认结构是否合理。
- 拖入节点、连线,需要写逻辑的节点直接写代码,模型参数按节点配。
- 用内置 AI 助手辅助生成节点代码,比手写快。
- 点「保存」把画布编译成 Python 项目,点「运行」在本机真实执行,看每一步的流式输出。
- 改画布和改代码要保持同步——注意它的「代码和画布怎么保持同步」一节。
MineAgent 适合谁用
- 想把 Agent 流程可视化、不想靠一堆 YAML 拼的人。
- 需要把搭好的流程交付成「可独立运行的代码」而不是绑定某个平台的团队。
- 教学或评审场景,需要一张图讲清 Agent 怎么流转。
- 要求本地运行、代码和数据都在自己机器上的场景。
- 只做简单单轮调用、不需要流程编排的需求,用它反而重。
MineAgent 项目地址
- GitHub 仓库:https://github.com/YT-Proteus-bot/MineAgent
- 快速开始:https://github.com/YT-Proteus-bot/MineAgent#快速开始
- 生成项目结构示例:https://github.com/YT-Proteus-bot/MineAgent#一个生成出来的项目长什么样