YT-Proteus-bot/MineAgent

项目介绍

MineAgent 是一个本地运行的前后端分离应用：在浏览器画布上选择框架、拖拽节点、连线、编辑节点 Python 代码并配置模型，点「保存」后把整张画布编译成 projects/<画布名>/ 下的独立 Python Agent 项目；点「运行」会在本机执行该生成项目，并把节点事件和模型 token 流式回传画布（README）。

后端使用 FastAPI 与 SQLite，前端使用 React 18、TypeScript、React Flow 和 Vite（README）。画布内置 110 种节点，覆盖 RAG 检索、工具、记忆、流程控制、多智能体协作和框架专有节点等类别（节点清单）。生成的项目包含 agent.py、agent.json、runner.py、runtime_sdk.py、运行脚本和 skills/；其中 agent.py 是对应框架的原生实现，保存采用增量生成，并保留用户手动改过的节点代码（生成项目结构、同步机制）。

支持的框架与模式

LangChain/LangGraph、AutoGen、CrewAI 标注为可运行；MetaGPT、Agno、SmolAgents、Semantic Kernel、OpenAI Agents SDK、Dify Workflow 只会生成对应风格的架构图与代码骨架，暂不接原生执行（框架支持表）。选择 ReAct、Plan-and-Execute、主管调度、辩论等推理或协作模式时，会直接生成一套该模式的最小可用画布，而不是只改一个设置值（模式模板）。

快速使用

Windows 下双击 start.bat，或在仓库根目录执行：

.\start.ps1
.\start.ps1 -Port 8080
.\start.ps1 -Dev

脚本会依次创建 Python 虚拟环境、安装前后端依赖、构建前端、启动服务并打开 http://127.0.0.1:8000（启动说明）。首次启动且没有任何画布时，会自动创建一张 LangChain 架构图。

没有 API Key 时，另开终端启动内置 mock 模型：

.\.venv\Scripts\python.exe tools\mock_llm.py --port 8012

然后在「用户中心 → 模型配置」把 Base URL 填为 http://127.0.0.1:8012/v1、模型填 mock-model、Key 随意填写，即可跑通画布 → 代码 → 运行 → 事件流的完整链路（mock 用法）。对生成出来的项目，可执行 run.ps1 <输入> 走零依赖预览，或安装框架依赖后执行 run.ps1 -UseFramework 运行 agent.py（独立运行）。

使用约束

• 启动方式偏 Windows： 文档中的一键入口是 start.bat/start.ps1；生成的项目同时带 run.ps1 和 run.sh。
• 原生执行依赖框架包： 如果所选框架的依赖未安装，运行会降级到零依赖预览执行器，运行面板会标明当前不是真实执行 agent.py（运行行为）。
• 只有三个框架可原生运行： 其余框架只生成架构图和代码骨架（框架支持表）。
• 部分节点依赖可选库： pdf_parser、ocr_extract、speech_to_text、image_analyzer 等文档与多模态节点在缺少依赖时只返回安装提示（节点清单）。
• 数据与密钥留在本机： 画布、配置和运行记录存在本地 SQLite；API Key 加密存本地数据库，运行时通过环境变量注入子进程，不写进项目文件（模型配置）。
• 上传社区模板需配置 GitHub： 需要公开的模板仓库和 GitHub OAuth App，回调地址填 http://127.0.0.1:8000/api/github/callback（模板分享）。
• 仓库元数据未声明许可证， 复用与商用条款无法从现有资料确定。

HotRepo 点评

MineAgent 在 2026-11-05 进入 Python 新项目榜记录，统计窗口从 06:01 UTC 开始、截至 15:45 UTC，约 9.7 小时内新增 104 Star；目前没有记录到 GitHub 全部语言日榜名次。单条快照只能说明这次早期增长，不足以判断趋势。按文档描述，它的差异点在于生成物不只停留在架构图：保存后得到带框架原生 agent.py 的项目，同时带零依赖预览执行器和缺少框架依赖时的降级路径。范围广也带来对应限制——列出的框架中只有三个能原生执行，其余框架上的画布应先按骨架对待。