███████╗ █████╗ ███████╗██╗ ██╗ ██████╗ ██████╗ ██████╗██╗ ██╗███████╗████████╗
██╔════╝██╔══██╗██╔════╝╚██╗ ██╔╝ ██╔══██╗██╔═══██╗██╔════╝██║ ██╔╝██╔════╝╚══██╔══╝
█████╗ ███████║███████╗ ╚████╔╝ ██████╔╝██║ ██║██║ █████╔╝ █████╗ ██║
██╔══╝ ██╔══██║╚════██║ ╚██╔╝ ██╔═══╝ ██║ ██║██║ ██╔═██╗ ██╔══╝ ██║
███████╗██║ ██║███████╗ ██║ ██║ ╚██████╔╝╚██████╗██║ ██╗███████╗ ██║
╚══════╝╚═╝ ╚═╝╚══════╝ ╚═╝ ╚═╝ ╚═════╝ ╚═════╝╚═╝ ╚═╝╚══════╝ ╚═╝
[!CAUTION]
⚠️ Alpha内测版本警告：此为早期内部构建版本，尚不完整且可能存在错误，欢迎大家提Issue反馈问题或建议。
PocketFlow 官方仓库 · 内容导航 · 如何学习
100 行代码，零依赖，构建 LLM 应用的一切。
PocketFlow 是一个仅 100 行 Python 代码的极简 LLM 应用框架。它用 Node（节点）和 Flow（流程）两个核心抽象，让你可以构建聊天机器人、RAG、智能体、工作流等所有主流 LLM 应用。
Easy-Pocket 是 PocketFlow 的交互式中文教程，通过可视化演示和实战案例，带你从零理解框架原理、掌握应用开发。
PocketFlow 是一个纯编排框架（Orchestration Framework）—— 它只负责调度节点、管理流程、传递数据，不包含任何 LLM 调用、Embedding 计算或向量存储的实现。
基于 PocketFlow 构建的应用架构
| PocketFlow 负责 | 你来决定 | |
|---|---|---|
| LLM | 节点何时被调用、按什么顺序 | 用哪家 API（OpenAI / Claude / 本地模型） |
| Embedding | 批量处理的并行调度 | 用哪个模型和向量数据库 |
| Memory | shared 字典的读写传递 | 怎么持久化（文件 / Redis / 数据库） |
| 工具调用 | 智能体 循环的执行与分支 | 调用哪些外部 API 和工具 |
一句话定位：PocketFlow = 图的运行时。你把具体实现填进 Node 的
exec()方法，PocketFlow 负责把它们串成流程。
🔬 形式化视角：PocketFlow 即有限状态自动机（FSA）
如果你学过编译原理或形式语言，会发现 PocketFlow 的执行模型就是一台有限状态自动机（Finite State Automaton, FSA）：
| FSA 形式定义 | PocketFlow 对应 |
|---|---|
| 状态集 Q | Node 集合 |
| 字母表 Σ | Action 字符串集（"continue"、"retry"、"done" …） |
| 转移函数 δ(q, a) | node - "action" >> next_node |
| 初始状态 q₀ | Flow(start=node) |
| 终止 | post() 返回的 action 无后继节点 → 流程结束 |
不同 LLM 应用模式，对应不同的自动机拓扑：聊天机器人是带自环的单状态机，智能体 是有分支+环的自动机，结构化输出是带回退边的自动机。详见原理篇 §2.4。
其他框架给你预制组件（智能体类、RAG 管道、Memory 模块），PocketFlow 给你图论原语（Node + Flow），你用这两块积木自己搭建一切。
📊 详细对比表
| 框架 | 核心思路 | 代码量 | 依赖 | 厂商锁定 |
|---|---|---|---|---|
| PocketFlow | 最小有向图运行时：Node + Flow | 100 行 | 0 | 无 |
| Agno | 声明式智能体，内置 Memory / Knowledge | 数千行 | 少 | 低 |
| AutoGen | Actor 模型，智能体间异步消息传递 | 数万行 | 中 | 低-中 |
| CrewAI | 角色扮演团队，Manager 分配 Task | 数万行 | 中 | 低 |
| LangGraph | 有状态状态机 + 持久化检查点 | 数万行 | 多（LangChain 生态） | 中 |
| OpenAI Agents SDK | 轻量智能体 + Handoff + Guardrails | 数千行 | 少 | 中（OpenAI 优先） |
| PydanticAI | 类型安全的函数调用 + Pydantic 验证 | 数千行 | 少 | 很低 |
| SmolAgents | LLM 生成 Python 代码而非 JSON tool call | ~1000 行 | 少 | 很低 |
本教程分为三大板块，覆盖原理、实战与知识参考：
| 章节 | 关键内容 |
|---|---|
| 引言：为什么需要 LLM 框架 | 核心痛点与框架对比 |
| 快速上手 | 环境搭建、安装、第一个 Flow |
| 核心抽象：Node 与 Flow | 三阶段模型、图执行引擎、操作符重载、FSA 形式化视角 |
| 通信机制与设计模式 | Shared Store + Params + 六大设计模式 |
| 深入源码 | BaseNode、Node、Flow、BatchNode、BatchFlow、AsyncNode |
| 工具函数与开发范式 | 工具函数分类、Agentic Coding、名词速查表 |
案例篇：从入门到进阶（12 个案例）
| # | 案例 | 模式 | 难度 |
|---|---|---|---|
| 1 | 聊天机器人 | 链式 + 循环 | 入门 |
| 2 | 写作工作流 | 链式 | 入门 |
| 3 | RAG 检索增强 | 链式 + BatchNode | 入门 |
| 4 | 搜索智能体 | 循环 + 条件分支 | 中级 |
| 5 | 多智能体协作 | AsyncNode + 消息队列 | 中级 |
| 6 | Map-Reduce 批处理 | BatchNode | 入门 |
| 7 | 并行处理 (8x 加速) | AsyncParallelBatchNode | 中级 |
| 8 | 结构化输出 | 循环 + 重试 + 校验 | 中级 |
| 9 | 思维链推理 | 循环 + 自检 | 进阶 |
| 10 | MCP 工具集成 | 智能体 + 工具 | 进阶 |
| 11 | 智能体技能 | 链式 + 条件路由 | 中级 |
| 12 | 智能体编程 | 完整项目模板 | 进阶 |
📚 附录：软件工程知识参考（来自 Easy-Vibe）
来自 Datawhale Easy-Vibe 项目，涵盖九大领域基础知识。学习过程中遇到不熟悉的概念时可随时查阅。
| 领域 | 关键主题 |
|---|---|
| 计算机基础 | CPU、操作系统、数据编码、网络、数据结构与算法 |
| 开发工具 | IDE、命令行、Git、环境变量、包管理器、调试 |
| 浏览器与前端 | JavaScript/TypeScript、前端框架、渲染管线、状态管理 |
| 服务器与后端 | HTTP 协议、Web 框架、API 设计、认证授权、并发模式 |
| 数据 | 数据库基础、数据模型、数据分析、A/B 测试 |
| 架构与系统设计 | 单体到微服务、分布式系统、高可用设计 |
| 基础设施与运维 | Linux、Docker、CI/CD、DNS/HTTPS、云平台 |
| 人工智能 | AI 发展史、Transformer、LLM、Prompt 工程、RAG、AI Agent |
| 工程素养 | 代码质量、测试策略、设计模式、安全意识、开源协作 |
根据你的背景选择学习路径：
- 零基础：原理篇全篇 → 案例篇（聊天机器人 → 写作工作流 → RAG）
- 想做智能体：原理篇 → 案例篇（搜索智能体 → 多智能体 → 智能体技能 → MCP → 智能体编程）
- 关注性能：原理篇（BatchNode / AsyncNode）→ 案例篇（Map-Reduce → 并行处理）
- 输出质量：原理篇（循环/重试）→ 案例篇（结构化输出 → 思维链推理）
每篇教程都附带完整可运行的 Python 示例，无需 API 密钥，开箱即用。
⚡ 快速开始
# 1. 确认 Python 版本（需要 3.9+）
python --version
# 2. 创建虚拟环境
python -m venv .venv
# Windows:
.venv\Scripts\activate
# macOS / Linux:
source .venv/bin/activate
# 3. 安装依赖
pip install pocketflow| 教程 | 示例目录 | 内容 |
|---|---|---|
| 原理入门 | docs/zh-cn/pocketflow-intro/examples/ |
10 个脚本：Node 生命周期、Flow 图执行、条件分支、批处理、异步并发等 |
| 应用案例 | docs/zh-cn/pocketflow-cases/examples/ |
12 个案例：ChatBot、写作工作流、RAG、智能体、多智能体、Map-Reduce、结构化输出、MCP、智能体技能 等 |
所有示例使用模拟 LLM 实现，聚焦框架核心概念。如需接入真实 API，参见各目录下的 README 说明。
npm install
npm run dev
# 打开 http://localhost:5173/easy-pocket/zh-cn/📁 项目结构
easy-pocket/
├── docs/
│ ├── .vitepress/ # VitePress 配置 + 自定义主题
│ │ └── theme/
│ │ ├── Layout.vue # 自定义布局（打字机效果）
│ │ ├── custom.css # 全局样式
│ │ └── components/ # Vue 组件（门户页、打字机等）
│ ├── public/ # 静态资源
│ └── zh-cn/
│ ├── index.md # 门户首页
│ ├── pocketflow-intro/ # 原理入门教程（6 页）
│ │ ├── index.md # 引言：为什么需要 LLM 框架
│ │ ├── quickstart.md # 快速上手
│ │ ├── core-abstractions.md # 核心抽象：Node 与 Flow
│ │ ├── communication-and-patterns.md # 通信机制与设计模式
│ │ ├── source-code.md # 深入源码
│ │ ├── tools-and-dev.md # 工具函数与开发范式
│ │ └── examples/ # 10 个配套示例脚本
│ ├── pocketflow-cases/ # 应用案例教程（7 页）
│ │ ├── index.md # 案例地图与学习路径
│ │ ├── beginner.md # 入门：聊天机器人 / 写作 / RAG
│ │ ├── agents.md # 智能体：搜索 / 多智能体
│ │ ├── batch-and-parallel.md # 批处理与并行
│ │ ├── output-quality.md # 输出质量：结构化 / 思维链
│ │ ├── advanced-agents.md # 高级智能体：MCP / 技能
│ │ ├── agentic-coding.md # 智能体编程
│ │ └── examples/ # 12 个配套案例脚本 + 项目模板
│ └── appendix/ # 附录（索引页，链接至 Easy-Vibe）
│ └── index.md
├── package.json
└── README.md
| 姓名 | 职责 |
|---|---|
| @赵志民 | 主编 |
欢迎更多贡献者加入，提 Pull Request 即可参与
- 发现问题或有改进建议？欢迎 提 Issue
- 想参与内容贡献？欢迎 提 Pull Request
- 内容贡献请遵循现有的写作风格和文件组织方式
欢迎加入 Easy-Pocket 交流群，与其他开发者一起探讨学习：
扫描下方二维码关注公众号：Datawhale
- PocketFlow — 100 行极简 LLM 框架
- Easy-Vibe — 附录知识参考来源 & 门户页设计参考
本作品采用 CC BY-NC-SA 4.0 许可协议。