SamurAIGPT/Vibe-Workflow

Vibe Workflow – 开源、可自托管的节点式AI工作流构建器

是什么

• 一款免费、MIT许可证的Web应用程序，允许你通过可视化方式构建生成式图像和视频的流水线。它模仿了Weavy AI、Krea Nodes、Freepik Spaces和FloraFauna AI等商业工具的节点编辑器体验，但你可以在自己的硬件上运行它。

核心组件

• 前端 – 一个Next.js应用（client/），提供拖拽画布。
• 工作流构建库 – 一个可复用的UI包（packages/workflow-builder/），实现了节点系统。
• 后端 – 一个FastAPI服务（server/），将节点请求转发给生成模型提供商（MuAPI/Vadoo AI）并返回结果。

主要功能

功能	详情
节点式可视化编辑器	无需编写代码即可构建、连接和重新排序模块（例如，提示词、模型、后处理）。
生成式图像与视频	使用MuAPI的扩散模型和视频模型；你需要提供自己的API密钥。
可自托管	支持Docker Compose或手动设置；数据不会离开你的基础设施。
可扩展	可添加自定义节点，调用任何外部API或加载LoRA/自定义扩散模型。
API与嵌入支持	主机版本（muapi.ai/workflow）提供REST API和可嵌入的组件；开源仓库也可类似扩展。
MIT许可证	可自由修改、分发和集成到其他产品中。

典型使用场景

• 创意工作室 – 在内部保持品牌指南的同时，自动化大规模资产生成。
• 开发者 – 将现成的可视化工作流组件嵌入SaaS产品或内部工具中。
• 研究人员 – 在不被厂商锁定的情况下，实验新的扩散模型或视频生成器。
• 无代码创作者 – 通过UI而非脚本设计复杂的生成流水线。

快速入门

1. 克隆与安装

   git clone https://github.com/samuraigpt/vibe-workflow.git
   cd vibe-workflow
   npm install   # 通过workspaces安装client + library
   

2. 添加MuAPI密钥

   cd server
   cp .env.example .env
   # 编辑 .env → MU_API_KEY=your_key
   

3. 本地运行
   • 前端：npm run dev:app → http://localhost:3000
   • 后端：

     python -m venv venv && source venv/bin/activate
     pip install -r requirements.txt
     uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
     

4. 或使用Docker Compose

   cp .env.example .env   # 设置MU_API_KEY
   docker compose up --build
   

   前端在3000端口，API在8000端口。

扩展平台

• 在 packages/workflow-builder/ 中创建新节点，定义输入/输出端口及请求内容。
• 在后端注册该节点，使FastAPI服务器能处理该负载。
• 重新构建库（npm run build:lib）并重启客户端。

为何选择Vibe Workflow而非商业替代品？

• 开源且免费 – 无订阅费用。
• 数据完全自主控制 – 所有操作都在你的服务器上运行。
• 可与任意模型无缝对接 – 可将MuAPI替换为其他提供商，或托管自己的扩散模型。
• 可复用库 – 节点编辑器可导入到其他项目中使用。

资源

• 完整故事与动机：[Medium文章]
• 主机SaaS版本（若只想快速使用UI）：https://muapi.ai/workflow
• 贡献指南：CONTRIBUTING.md
• 许可证：MIT

---

Vibe Workflow 本质上是一个面向希望摆脱付费SaaS平台束缚、又想使用节点式编辑器强大功能的创作者的视觉化“流水线构建器”。