文章目录
- [1. 项目概述](#1. 项目概述)
- [2. 核心能力](#2. 核心能力)
-
- [2.1 应用开发与原型制作](#2.1 应用开发与原型制作)
- [2.2 快速搭建业务流程](#2.2 快速搭建业务流程)
- [2.3 实时调试流程](#2.3 实时调试流程)
- [2.4 灵活改造与丰富集成](#2.4 灵活改造与丰富集成)
-
- [2.4.1 智能体与 MCP 协议支持](#2.4.1 智能体与 MCP 协议支持)
- [2.4.2 高度可扩展](#2.4.2 高度可扩展)
- [3. 安装 Langflow](#3. 安装 Langflow)
-
- [3.1 Langflow 桌面端](#3.1 Langflow 桌面端)
- [3.2 使用 Docker 安装](#3.2 使用 Docker 安装)
- [3.3 开源 Python 包安装](#3.3 开源 Python 包安装)
- [3.4 源码安装](#3.4 源码安装)
- [4. 开源协议](#4. 开源协议)
1. 项目概述
Langflow 是一个可视化 AI 工作流构建平台 ，用于快速构建、部署和管理 AI 智能体与工作流。它提供可视化编辑器（拖拽式画布）、Python 自定义组件扩展、REST API 和 MCP Server 部署能力。
核心特性：
- 可视化搭建界面，快速上手并迭代优化
- 开放源代码，可通过
Python自定义所有组件 - 交互式调试环境，分步管控流程，即时测试打磨工作流
- 多智能体编排，搭配对话管理与检索能力
- 可部署为
API，或导出JSON适配Python程序 - 部署为
MCP服务端，将流程转化为MCP客户端可用工具 - 集成
LangSmith、LangFuse等工具实现可观测能力 - 适配企业场景的安全体系与弹性扩展能力
技术栈：
- 后端：
Python 3.10-3.13+FastAPI+SQLAlchemy+Alembic - 前端：
React 19+TypeScript+Vite+Tailwind CSS+Zustand - 图表可视化：
@xyflow/react UI组件：shadcn/ui+Radix UI+Lucide Icons- 数据库：
SQLite（开发）/PostgreSQL（生产） - 包管理：
uv（Python工作区）
2. 核心能力
2.1 应用开发与原型制作
Langflow 可开发多类型 AI 应用，包括聊天机器人、文档分析系统、内容生成工具、智能体应用等。
内置多款现成模板，可直接使用或按需修改。
2.2 快速搭建业务流程
Langflow 核心功能是创建与调度流程，流程本质是应用业务逻辑的可视化载体。搭建流程只需拼接、配置组件节点，每个组件对应工作流里一个执行步骤。依托可视化拖拽编辑器，快速搭建、调试可运行的 AI 业务链路。
2.3 实时调试流程
内置调试沙盒（Playground），无需搭建完整应用堆栈即可测试流程，可交互式运行流程，实时校验逻辑与回复生成效果。也可单独运行单个组件，隔离测试依赖关系。
流程运行与对外服务：
- 流程可作为正式开发的原型参考；
- 通过
Langflow API把流程嵌入自有业务代码； - 大型项目可将
Langflow作为项目依赖引入，或部署独立Langflow服务，公网对外提供流程能力。
2.4 灵活改造与丰富集成
Langflow 内置海量适配 AI 开发所需服务、工具与能力的组件：
- 通用组件：输入、输出、数据存储等基础模块；
- 专用组件：智能体、大模型、向量嵌入服务商等专项模块。
所有组件均可配置固定参数或动态变量；运行时还能通过临时微调参数覆盖原有流程配置。
2.4.1 智能体与 MCP 协议支持
- Langflow 智能体 ：可视化搭建、配置
AI智能体 - 智能体工具：把组件、完整流程封装成智能体可调用工具
- MCP 服务端 ：将 Langflow 对外暴露为
MCP服务 - MCP 客户端 ：对接第三方外部
MCP服务
2.4.2 高度可扩展
除官方核心组件外，框架支持自定义组件：
- 复用社区他人开发的自定义组件；
- 自行编写
Python组件自用，或分享给全体Langflow使用者。
3. 安装 Langflow
Langflow 提供多种安装方式：
Langflow桌面端：独立桌面应用，自动管理依赖，升级操作简便。Docker容器部署：在隔离容器环境中运行Langflow。Python软件包安装：可完全自主管控运行环境、依赖包与版本。- 源码编译安装适合参与项目开发，或是基于本地仓库副本进行二次开发。
3.1 Langflow 桌面端
Langflow 桌面版简化了依赖管理与版本升级流程，但部分功能暂不支持，例如可分享调试沙盒、语音模式。
macOS 要求系统版本 13 及以上：
- 进入 Langflow 桌面版下载页面
- 点击下载按钮，填写联系信息后开始下载
- 挂载安装包并完成程序安装
- 安装结束后打开
Langflow，跟随快速入门创建第一条流程
Windows 系统安装步骤：
- 进入
Langflow桌面版下载页面 - 点击「下载
Langflow」，填写联系信息后再次点击下载 - 打开文件资源管理器，切换到下载文件夹
- 双击下载好的
.msi安装包，依照安装向导完成Langflow桌面端安装 Windows环境安装Langflow桌面程序需要C++编译器，部分设备默认未预装。
升级详情可查阅版本发布日志。
如需在桌面端安装自定义依赖，请参考《在Langflow桌面端安装自定义依赖》文档。
提示
若弹出需要
C++生成工具的报错，按照页面提示安装微软C++生成工具，或直接安装Microsoft Visual Studio。
3.2 使用 Docker 安装
借助官方 Docker 镜像启动容器实例，详情参考《Docker部署Langflow》文档。
安装步骤：
- 安装并启动
Docker - 拉取最新镜像并启动容器：
docker run -p 7860:7860 langflowai/langflow:latest - 浏览器访问地址：
http://localhost:7860/ - 通过快速入门创建首个流程
3.3 开源 Python 包安装
前置环境要求：
Python版本：3.10 ~ 3.14- 工具：
uv - 硬件配置
最低：双核CPU、2GB内存
推荐：多核CPU、至少4GB内存 - 浏览器：推荐谷歌
Chrome，非强制
安装步骤：
- 使用
uv创建虚拟环境 - 在虚拟环境内安装
Langflow：uv pip install langflow - 启动服务（首次启动耗时约数分钟）：
uv run langflow run - 验证运行状态：打开默认地址
http://127.0.0.1:7860 - 跟随快速入门搭建第一条流程
开源包升级至最新版：
bash
uv pip install langflow -U官方建议升级前备份现有配置数据，详见《升级前准备》文档。
安装指定版本（示例 1.4.22）：
bash
uv pip install langflow==1.4.22强制重装程序及全部依赖：
bash
uv pip install langflow --force-reinstall3.4 源码安装
下篇单独介绍
4. 开源协议
Langflow 使用 MIT 协议， MIT商用全部许可项：
- ✅ 允许商业使用：免费商用，不用付费、不用提前申请授权
- ✅ 允许修改源码：可二次改写、自定义定制代码逻辑
- ✅ 允许私有/闭源使用：改动后的代码不用强制对外开源
- ✅ 允许分发、转售：能把该代码打包嵌入自有产品对外售卖交付
- ✅ 允许再许可：可将代码改用其他开源协议
强制约束条款：
- ⚠️ 必须保留原始许可声明 ：项目内完整留存原作者版权标注与
MIT协议文本 - ⚠️ 自带免责担保：软件以「原样状态」交付，原作者不对使用故障、业务损失承担法律责任