免责声明
FLUJO 仍然处于早期预览阶段！这里有一个 30 秒的视频来展示它：
对于你遇到的任何问题（MCP 安装、应用程序问题、可用性问题、反馈）：请告诉我！ -> 创建一个 Github 问题或在 Discord（https://discord.gg/KPyrjTSSat）上留言，我会跟进！可能需要一天时间才能回复，但我会尽量回复每一位用户。
这里有一个视频指导你完成整个过程，从安装到输出！（15分钟） 很抱歉音频质量不佳，很快将发布新视频！
FLUJO 动画短片 #1 - "关于 MCP 的悲伤歌曲"
重要安全提示
FLUJO 默认启用了广泛的日志记录功能！这可能会将你的加密 API 密钥暴露在终端输出中！ 在抓取视频或进行流式传输并显示终端输出时要非常小心！
FLUJO
FLUJO 是一个开源平台，它连接了工作流编排、模型上下文协议 (MCP) 和AI 工具集成。它提供了一个统一的界面来管理 AI 模型、MCP 服务器和复杂的工作流——所有都在本地和开源。
FLUJO 由 PocketFlowFramework 支持，并使用 CLine 和大量的爱构建而成。
🌟 主要功能
🔑 环境和 API 密钥管理
- 安全存储：加密存储环境变量和 API 密钥
- 全局访问：在应用程序的整个范围内使用存储的密钥
- 集中管理：将所有凭证保存在一个安全的地方
🤖 模型管理
- 多个模型：同时配置和使用不同的 AI 模型
- 预定义提示：为每个模型创建自定义系统指令
- 提供商灵活性：连接到各种 API 提供商（OpenAI、Anthropic 等）
- 本地模型：与 Ollama 集成以执行本地模型
🔌 MCP 服务器集成
- 轻松安装：从 GitHub 或本地文件系统安装 MCP 服务器
- 服务器管理：管理 MCP 服务器的全面界面
- 工具检查：查看和管理 MCP 服务器提供的工具
- 环境绑定：将服务器环境变量连接到全局存储
- Docker 支持：在 Flujo 中运行基于 Docker 的 MCP 服务器
🔄 工作流编排
- 可视化流程构建器：创建和设计复杂的工作流
- 模型集成：在工作流中连接不同的模型
- 工具管理：允许或限制为每个模型使用特定工具
- 提示设计：在多个级别（模型、工作流、节点）配置系统提示
💬 聊天界面
- 工作流交互：通过聊天界面与你的工作流交互
- 消息管理：编辑或禁用消息或将对话拆分以减少上下文大小
- 文件附件：附加文档或音频以供 LLM 处理（目前很差，因为为此你应该使用 MCP！）
- 转录：使用自动转录处理音频输入（目前很差，请查看路线图）
🔄 外部工具集成
- OpenAI 兼容端点：与 CLine 或 Roo 等工具集成
- 无缝连接：使用 FLUJO 作为其他 AI 应用程序的后端
🚀 快速入门
手动安装：
前置条件
- Node.js（v18 或更高版本）
- npm 或 yarn
安装
-
克隆仓库：
git clone https://github.com/mario-andreschak/FLUJO.git cd FLUJO -
安装依赖：
npm install # 或 yarn install -
启动开发服务器：
npm run dev # 或 yarn dev -
在浏览器中打开并导航到：
http://localhost:4200 -
如果编译运行 FLUJO，效果最佳：
npm run build npm start -
以桌面应用程序方式运行：
npm run electron-dev # 开发模式 # 或 npm run electron-dist # 为你的平台构建和打包
📖 使用说明
设置常用 API 密钥
- 导航到设置
- 将你的 API 密钥全局保存以保护它们
设置模型
- 导航到模型页面
- 点击“添加模型”以创建新的模型配置
- 使用名称、提供商、API 密钥和系统提示配置你的模型
- 保存你的配置
管理 MCP 服务器
- 前往 MCP 页面
- 点击“添加服务器”以安装新的 MCP 服务器
- 从 GitHub 仓库或本地文件系统选择
- 配置服务器设置和环境变量
- 启动和管理你的服务器
使用 SSE MCP-Servers
- 前往 MCP 页面
- 点击“添加服务器”以安装新的 MCP 服务器
- 选择“本地服务器”
- 输入服务器名称，输入 "/" 作为服务器根路径
- 留空构建命令和安装命令
- 输入 "npx" 作为运行命令
- 添加第 1 个参数 "mcp-remote"
- 添加第 2 个参数 "(你的 MCP SSE-Url 这里)"
使用官方参考服务器
- 前往 MCP 页面
- 点击“添加服务器”以安装新的 MCP 服务器
- 前往“参考服务器”选项卡
- （首次执行时：）点击“刷新”并等等。
- 点击你选择的服务器，等待屏幕变化，在底部点击“保存”/“更新服务器”。
使用基于 Docker 的 MCP 服务器
在 Docker 中运行 FLUJO 时，你可以使用基于 Docker 的 MCP 服务器：
- 前往 MCP 页面
- 点击“添加服务器”以安装新的 MCP 服务器
- 选择“Docker”作为安装方法
- 提供 Docker 镜像名称和任何必需的环境变量
- 启动和管理你的服务器
创建工作流
- 访问 Flows 页面
- 点击“创建 Flow”以开始新的工作流
- 添加处理节点并将它们连接起来
- 配置每个节点使用模型和工具
- 保存你的工作流
分支
- 将一个 MCP 节点连接到多个后续节点
- 在“代理工具”选项卡中定义提示中的分支，使用“Agent Tools”选项卡上的代理工具
循环
- 与分支相同，但连接回先前的节点
编排
- 与循环相同，但使用多个
使用聊天界面
- 前往聊天页面
- 选择一个工作流进行交互
- 开始与你的配置工作流聊天
🔄 MCP 集成
FLUJO 提供了对模型上下文协议 (MCP) 的全面支持，允许你：
- 安装和管理 MCP 服务器
- 检查服务器工具
- 将 MCP 服务器连接到你的工作流
- 直接在提示中引用工具
- 将环境变量绑定到你的全局加密存储
Docker 安装
运行 FLUJO 最简单的方法是使用 Docker，它提供了始终如一的环境并支持运行基于 Docker 的 MCP 服务器。
前置条件
- 在你的系统上安装 Docker 和 Docker Compose
使用 Docker Compose
-
克隆仓库：
git clone https://github.com/mario-andreschak/FLUJO.git cd FLUJO -
构建并启动容器：
docker-compose up -d -
在浏览器中访问 FLUJO：
http://localhost:4200
使用 Docker 脚本
为了对 Docker 构建和运行过程有更多控制，你可以使用提供的脚本：
-
构建 Docker 镜像：
./scripts/build-docker.sh -
运行 Docker 容器：
./scripts/run-docker.sh
run-docker.sh 的选项：
--tag=<tag>：指定镜像标签（默认：latest）--detached：以分离模式运行--no-privileged：以无特权模式运行（不推荐）--port=<port>：指定主机端口（默认：4200）
有关 Docker 支持的更多详细信息，包括 Docker-in-Docker 功能、持久存储和故障排除，请参阅 DOCKER.md.
📄 许可证
FLUJO 在 MIT 许可证 下授权。
🚀 路线图
以下是即将推出的功能和改进的路线图：
- 实时语音功能：添加对 Whisper.js 或 OpenWhisper 的支持，以实现实时语音功能。
- 可视化调试器：引入一个可视化工具，以帮助更有效地调试和排错。
- MCP Roots 支持：在 MCP Roots 中实现 Checkpoints 和 Restore 功能，以提供更好的控制和恢复选项。
- MCP 提示：允许用户构建充分利用 MCP 服务器功能的自定义提示。
- MCP 代理 STDIO<>SSE：可能利用 SuperGateway 代理标准输入/输出与服务器发送事件，以增强通信：使用 FLUJo 管理的 MCP 服务器在任何 MCP 客户端中使用。
- 增强集成：提高与 Windsurf、Cursor 和 Cline 等工具的兼容性和功能。
- 高级编排：添加基于代理的编排、批量处理和受 Pocketflow 启发的功能。
- 在线模板仓库：创建一个平台，用于共享模型、工作流或完整的“包”，使其他人可以轻松地分发 FLUJO 工作流。
- 边缘设备优化：增强边缘设备上的性能和可用性。
🤝 贡献
欢迎贡献！随时可以打开问题或提交拉取请求。
- 分支仓库
- 创建你的功能分支 (
git checkout -b feature/amazing-feature) - 提交你的更改 (
git commit -m 'Add some amazing feature') - 推送到分支 (
git push origin feature/amazing-feature) - 打开拉取请求
📬 联系方式
- GitHub: mario-andreschak
- LinkedIn: https://www.linkedin.com/in/mario-andreschak-674033299/
注意事项：
- 你可以在消息中添加 ~FLUJO=HTML、~FLUJO=MARKDOWN、~FLUJO=JSON、~FLUJO=TEXT 来格式化响应，这将导致在不同工具中集成 FLUJO 时产生不同的结果。
- 你可以在消息中的某个位置添加 ~FLUJOEXPAND=1 或 ~FLUJODEBUG=1 来显示更多详细信息
- 在 config/features.ts 中，你可以更改整个应用程序的日志级别
- 在 config/features.ts 中，你可以启用 SSE 支持，该支持目前默认禁用