Pocket Flow
用极简图式框架编排 LLM 工作流、智能体与 RAG 应用。
- Star 数
- ★ 11k
- 最近更新
- 3 个月前
- License
- MIT
- 主语言
- Python
- FA 评分
- 41/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 典型场景
- 希望用一个小型图式框架编排聊天历史的 Python 开发者，可参考 Chat 教程构建基础聊天机器人。
- 不适合
- 需要开箱即用托管服务或现成模型接入的团队
- 希望框架自带模型、向量库、搜索等供应商封装的团队
- 需要完整生产运维、持久化与安全边界文档的团队
这个 Agent 能做什么，适合哪些场景？
Pocket Flow 是一个以 Graph 为核心抽象的极简 LLM 框架，项目称核心实现位于 100 行的 pocketflow/__init__.py。它以 Python 包 pocketflow 提供，也支持直接复制该源文件使用。仓库通过 cookbook 展示聊天、结构化信息提取、写作工作流、研究智能体、RAG、批处理、流式输出、多智能体、监督、并行执行、MCP 和人机协作等模式。它是用于构建应用流程的库，而非一个开箱即用的托管智能体产品；README 未给出部署服务、命令行入口或统一模型供应商配置。项目宣称零依赖、无供应商锁定，因此采用者需要自行完成模型、搜索、语音或其他外部服务的接入。
核心代码 pocketflow/__init__.py 提供 Graph 抽象，用来组织 LLM 应用的流程。仓库中的 cookbook 演示可实现带会话历史的聊天、从简历提示提取结构化数据、依次生成大纲和内容并进行样式处理的写作流程、搜索网页后回答问题的研究智能体，以及检索增强生成流程。其他示例覆盖 Markdown 多语言翻译批处理、实时 LLM 流式响应与用户中断、聚合多次解答的多数投票、map-reduce、CLI 人机反馈、MCP 数值操作和 A2A 智能体通信。框架本身不在提供的材料中定义任何内置模型调用、供应商适配器或部署输出；这些示例描述的是可构建的应用流程。
- 希望用一个小型图式框架编排聊天历史的 Python 开发者，可参考 Chat 教程构建基础聊天机器人。
- 需要从简历文本中按提示抽取字段的开发者，可采用 Structured Output 示例的结构化提取流程。
- 要将选题、大纲、成文与样式处理串联起来的内容团队，可使用 Workflow 写作流程作为起点。
- 正在制作能搜索网页并回答问题的研究助手的团队，可参考 Agent 教程。
- 要实现文档检索后生成回答，或让流程自行决定读取哪些文档的开发者，可参考 RAG 与 Agentic RAG 示例。
- 需要把模型能力接入实时界面、后台任务或命令行人工反馈流程的开发者，可参考 FastAPI WebSocket、FastAPI Background 和 CLI HITL 示例。
如何安装或部署这个 Agent？
提供的安装命令为：pip install pocketflow。另一种方式是直接复制 pocketflow/__init__.py 源文件。材料未说明 Python 版本、虚拟环境步骤、模型供应商凭据、环境变量或额外依赖。
如何使用这个 Agent？
先执行 pip install pocketflow，然后选择与目标模式相符的 cookbook，例如 pocketflow-chat、pocketflow-rag 或 pocketflow-mcp。提供的材料没有给出 import 语句、类或函数调用、可运行的首个命令，也没有说明模型凭据和运行时配置；这些信息无法据此可靠补全。
这个 Agent 有哪些优点和局限？
- 核心抽象被限定为 Graph，适合希望直接控制流程结构而不引入大量框架层的开发者。
- 项目同时提供安装包和单文件复制两种采用方式，核心实现明确指向
pocketflow/__init__.py。 - cookbook 覆盖从聊天、RAG 到并行、流式、MCP、A2A 和人机协作的多种具体流程模式。
- README 明确声明零供应商锁定，且比较表将 PocketFlow 定位为不含供应商专用封装的框架。
- 提供的材料没有公开首个可运行的 API 示例、导入方式或类/函数参考，评估前需要查看代码或完整文档。
- 没有记录模型供应商、认证凭据、环境变量和依赖配置；接入实际 LLM 服务需要自行设计。
- README 未说明部署拓扑、生产运维、持久化、错误恢复或安全边界。
- 没有内置供应商封装意味着从其他框架迁移时，现有模型、向量库和工具集成不能假定可直接复用。
这个 Agent 与同类方案有什么区别？
Pocket Flow 将自身定位为仅保留 Graph 抽象的方案。README 的对比表列出 LangChain、CrewAI、SmolAgent、LangGraph 和 AutoGen，并将它们描述为包含不同程度的应用专用或供应商专用封装；Pocket Flow 则定位为不提供这两类封装。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Pocket Flow 当前 | 41 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 11k | 3 个月前 | Python | — |
| Dynamiq 智能体编排框架 | 61 · 存在缺口 | 代码库 / SDK免费 + 模型费 | ★ 1.1k | 1 天前 | Python | OpenAI API |
| Mastra | 52 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 29k | 今天 | TypeScript | OpenAI API · Claude API |
| BeeAI Framework | 51 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 3.5k | 3 天前 | Python | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示这是一个极简框架，核心代码仅100行，无内置权限管理、用户确认、数据流透明、敏感数据处理、依赖安全、外部效果控制、回滚或来源归属机制。这些方面在代码和文档中均未提及，因此得分为0。未发现恶意行为，但作为框架，这些安全特性完全缺失。
自一致性：代码和测试显示框架内部逻辑一致，节点和流程的异步实现相互匹配，得2分。依赖可用性：框架宣称零依赖，测试仅使用标准库，得2分。失败消息：测试中有错误处理测试，但框架本身未提供详细的错误消息或调试信息，得1分。
受众与场景：README列出了大量教程和用例，覆盖从简单到复杂的场景，得2分。能力边界：README明确说明框架是100行核心，不包含应用特定包装器，得2分。触发精度：框架通过条件字符串控制流程，但文档未详细说明如何精确控制触发，得1分。环境适配：支持Python和多种语言版本，但未说明特定环境要求，得2分。
信息架构：README结构清晰，有目录和教程列表，得2分。安装说明：提供pip安装和复制源码两种方式，得2分。命名稳定性：核心类名如Node、Flow等稳定，得2分。示例与FAQ：有大量示例，但无FAQ，得2分。已知限制：未明确列出，得1分。许可证：MIT许可证明确，得2分。版本与变更日志：无CHANGELOG，得1分。维护责任：有Discord和GitHub，但未明确维护者，得1分。
输出可用性：框架输出为共享存储中的状态，文档和示例展示了如何使用，得2分。边际价值：相比其他框架，100行核心提供了独特价值，得2分。成本效益：零依赖、轻量，成本低，得2分。
声明可追溯：README中的声明（如100行、零依赖）可直接从代码验证，得2分。跨来源佐证：有多个教程和外部链接，但未独立验证，得1分。事实与推断分离：README区分了事实和设计理念，但部分声明缺乏证据，得1分。
- 源码中未见：最小权限约束只授予完成任务所需的权限：用专用账号或只读令牌，并限定可访问的目录和仓库。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：数据流向说明运行时观察它连接了哪些外部服务（代理或防火墙日志）；弄清数据去向之前不要输入敏感数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：外部影响披露先弄清它会写入、发送或修改哪些外部系统，用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 源码中未见：来源归属可核验从官方仓库或包源安装，核对发布者和仓库地址，避免同名仿冒包。
- 框架本身不提供任何安全机制，如权限控制、用户确认或数据流透明，使用时需自行实现。
- 未发现恶意行为，但作为框架，安全特性完全缺失，需谨慎评估使用场景。
- 测试覆盖有限，部分测试被注释掉，且未提供独立验证。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v0.0.0 预发布
常见问题
使用 Pocket Flow 是否需要支付框架费用？
它是否自带 OpenAI、Anthropic 或其他模型供应商适配器？
是否支持 MCP？
pocketflow-mcp cookbook，描述为使用 Model Context Protocol 执行数值操作的智能体示例。材料没有给出该示例的配置细节。