loonflow 3.0 - 智能化、可视化的流程自动化系统

致力于提供企业级的统一工作流解决方案

English | 简体中文

全新出发的 Loonflow 3.0

Loonflow 是一个基于 Django 开发的开源流程自动化平台。历经多个版本的迭代与重构，我们自豪地推出 Loonflow 3.0 —— 一个在可视化、灵活性和扩展性上都实现质的飞跃的版本。

3.0 版本的核心是 「让复杂的业务流程变得简单可视，让个性化的定制需求触手可及」。不仅重铸了流程与表单设计器，更构建了一套强大的扩展框架，旨在成为企业数字化转型中最核心的流程引擎。

SaaS 云服务

我们在 https://www.loonflow.com/ 提供 SaaS 托管版，新用户可享 两周免费试用，无需自建部署。注册与方案说明请见官网。

功能演示

MCP 演示

核心特性

革命性的可视化设计

• 拖拽式流程设计器：无需繁杂的配置，通过直观的拖拽连线即可完成复杂业务流程的建模。支持条件分支、并行任务、hook等高级节点。
• 智能表单设计器：强大的可视化表单构建工具，提供丰富的字段类型（文本、数字、下拉框、人员选择、附件等），布局随心所欲。
• 实时预览与验证：设计流程时实时预览效果，内置流程逻辑校验，提前规避设计错误。
• 流程配置支持多版本: 你可以配置多个版本的流程，并轻松测试和切换版本。

极致的灵活性与扩展性

• 插件化架构：我们为几乎所有关键节点都提供了插件扩展能力（如自定义动作、权限验证、通知方式等）。您的独特业务逻辑可以像搭积木一样轻松接入。
• 强大的 API 体系：提供全面、清晰的 RESTful API，便于与您的客服系统、CMDB、监控系统、CI/CD、OA 等第三方系统无缝集成。
• 高度可定制的权限模型：支持基于角色、部门、甚至特定业务条件的精细权限控制，满足企业复杂的权限管控需求。

开箱即用的企业级功能

• 多类型工单支持：轻松管理 IT 运维、人事审批、财务报销、客户服务等各类流程。
• 自动化与智能路由：支持基于表单数据的条件路由，自动指派处理人，实现工单的智能化流转。
• 详尽的审计日志：完整记录工单从创建到关闭的每一个操作，满足合规与审计要求。
• 登录认证功能: 支持本地用户密码登录、微软OIDC登录
• 多租户支持（可选）：为 SaaS 服务商或大型集团企业提供数据隔离能力(需要额外授权)。

模型上下文协议（MCP）

Loonflow 提供面向工单的 模型上下文协议（Model Context Protocol） 服务，兼容的客户端（例如带 AI 能力的编辑器）可在认证后通过工具查询与处理工单。对客户端展示的服务名称为 loonflow-ticket，工具内部与 Web 界面使用一致的权限校验与工单服务。

• 认证：推荐使用 个人访问令牌（值以 lfpat. 开头），或使用 Loonflow 签发的 JWT。在产品的 个人信息 → 个人访问令牌 中创建并妥善保管令牌。
• SaaS 端点：https://mcp.loonflow.com/mcp
• 自建部署：MCP 进程默认以 Streamable HTTP 提供 /mcp 路径（主机、端口与传输方式可通过文档中的环境变量调整）。

当前注册的工具包括 ticket_list、ticket_detail、ticket_prepare_handle、ticket_handle（支持 dry_run 仅校验不写库）以及 user_list（在认证用户所属租户内分页查询用户）。JSON 配置示例、参数说明与运维注意事项见完整文档：MCP — 工单服务。

安装与部署

1. 下载docker-compose相关文件

wget https://raw.githubusercontent.com/blackholll/loonflow/refs/heads/master/docker_compose_deploy/docker-compose.yml
wget https://raw.githubusercontent.com/blackholll/loonflow/refs/heads/master/docker_compose_deploy/.env

1. 修改.env文件 请至少修改password部分
2. 启动docker-compose 进入docker-compose.yml所在目录下执行：

docker-compose up -d

1. 访问loonflow 使用你在.env配置的admin用户登录loonflow

深入探索

• 完整文档 - 了解安装、配置、使用和开发的全部细节. https://loonflow.readthedocs.io
• MCP（模型上下文协议）- 面向 AI 助手等客户端的工单服务说明：https://loonflow.readthedocs.io/zh_CN/latest/mcp/index.html
• hook开发指南 - 学习如何为 Loonflow 开发自定义插件（编写中）。
• API 参考 - 查看完整的 API 接口文档. https://documenter.getpostman.com/view/15031929/2sB3WyJbap

项目规划

项目规划

参与贡献

热烈欢迎社区的贡献！无论您是修复错别字、改进文档、报告 Bug 还是开发新功能。

请先 Fork 本仓库，然后提交 Pull Request。

获取帮助

• GitHub Issues - 提交 Bug 报告和功能请求。
• 讨论区 - 与社区和其他用户交流 Discord。
• 商业支持与定制：如有企业级深度定制、技术培训或部署支持需求，请通过 [blackholll@163.com;blackholll.cn@gmail.com] 联系我。
• 会员权益

会员权益(可单次支持以享受月度权益)

因国内没有合适靠谱的平台，故依旧采用支付宝付款码的形式.国外用户可以点击github项目首页上的"sponsor"按钮进行赞助。

社区伙伴 - 5元/月

适合所有欣赏我的工作并希望它蓬勃发展的人。 - 在我的官方Discord社区获得专属身份组

核心贡献者 - 10元/月

适合依赖本项目并希望更深入参与的重度用户。

• 享有上一层级所有权益。
• 入门及年度通话：首次赞助可获得30分钟语音/视频答疑，之后每年还可获得一次60分钟答疑。

项目协作者 - 50元/月

适合其工作流程与本项目的健康发展息息相关的专业人士和小型团队。 - 享有上一层级所有权益。 - 优先处理：您提交的 Bug 报告或功能请求将被移至优先开发队列。 - 增强年度支持：每年共计享有3次 60分钟语音/视频答疑，用于深度探讨问题或制定策略。

战略赞助商 - 100元/月

为希望确保项目成功并获得显著品牌曝光的企业量身定制。

• 享有上一层级所有权益。
• 显著位置展示：您公司的 Logo 将作为关键支持者，展示在项目 GitHub 主页的显著位置。
• 专属年度支持：每年共计享有10次 60分钟语音/视频答疑，获得持续的专属技术支持。

致谢

感谢所有为 Loonflow 贡献代码、提交 Issue、以及帮助改进文档的 贡献者们。

如果 Loonflow 对您有帮助，请给我们一个 ⭐️ Star 支持！

欢迎捐助

您的支持是我最大的动力,欢迎支付宝扫码捐助

许可证与法律声明

本项目基于AGPLv3协议开源。您可以自由地查看、修改和分发代码，但请注意：

如果您将本项目作为SaaS服务对外提供，根据AGPLv3，您必须开源您的所有修改。

如果您希望在不开源修改的前提下将本项目用于SaaS服务，或者您需要在企业内部使用其多租户功能，您需要从我们这里获取商业许可。请联系 [blackholll@163.com;blackholll.cn@gmail.com]。