langflow-ai/langflow

Langflow

用 Python 组件和 React 画布学习可视化 Agent 的建模与部署

难度
较难
适合
进阶
主要语言
Python
GitHub
153.0k
许可证
MIT
快照日期
2026年8月9日

先判断要不要学

这个项目值得拆什么?

Langflow 是一个可视化 AI Agent/工作流平台,同时提供 Python/FastAPI 后端、React/TypeScript 画布、组件框架和轻量 lfx 执行器。每条 flow 可在 playground 调试,并可暴露为 API 或 MCP 工具。官方 AGENTS.md 对包边界、服务层和组件契约描述很清楚。

  1. 01

    官方架构指南能将大型仓库压缩成 backend/frontend/lfx 三层。

  2. 02

    自定义 Component 契约适合学习插件式 AI 能力。

  3. 03

    从画布到 API/MCP 的交付路径完整。

可以学什么

不只是看代码,而是找到产品的骨架

  • 学 Agent 工作流
  • 学 AI 接入
  • 学产品结构
  • 学完整项目组织
  • 学部署
01

组件契约

从 Component 类的 inputs、outputs 和 process 方法,理解可视化节点的稳定身份。

src/backend/base/langflow/components · src/backend/base/langflow/custom · src/backend/tests/unit/components
02

图执行与服务层

对照 graph、api 和 services,学习如何将交互式画布变成可测试后端任务。

src/backend/base/langflow/graph · src/backend/base/langflow/api · src/backend/base/langflow/services
03

一条 flow 的多交付形态

将同一 flow 在 playground、API、JSON 与 MCP 服务中的表达对齐。

src/frontend/src · src/backend/base/langflow/api · src/lfx

三段学习路径

从理解、修改到做出你的版本

0130 分钟先跑通

建立仓库三层地图

  1. 读 README 与 AGENTS.md Architecture
  2. 标出 frontend/backend/lfx
  3. 选一个无 API 组件追踪

完成标志:一张组件到画布再到执行的地图。

022 小时动手改

完成一个纯文本自定义组件设计

  1. 定义一进一出 Component
  2. 模仿现有元数据与 process
  3. 设计正常、空值和错误用例
  4. 与前端节点显示契约对照

完成标志:一份可实现的组件规格与测试表。

031 天做变体

构建可 API 调用的三节点 flow

  1. 用输入、纯函数、输出组件组图
  2. 在 playground 检查中间步骤
  3. 暴露为 API 并校验输入
  4. 测试超时、环依赖与未授权访问

完成标志:一个可视化、可调试、可以 API 交付的最小 flow。

评分解释

每一分都要说清楚为什么

可复刻性15 / 25
15 / 25

安装包容易,源码复制成本高。

文档与代码清晰度18 / 20
18 / 20

AGENTS.md 的架构导航出色。

新手学习价值12 / 20
12 / 20

适合进阶者做小切片。

产品完整度15 / 15
15 / 15

编辑、调试、执行与交付完整。

vibe coding 代表性9 / 10
9 / 10

可视化 Agent 工作流高度相关。

活跃度5 / 5
5 / 5

仓库与发布持续活跃。

新颖性4 / 5
4 / 5

flow 直接变 API/MCP 具有辨识度。