1. 快速上手

title: '快速上手'
description: '环境搭建、安装 PocketFlow 并运行你的第一个 Flow。'​

1. 快速上手

先跑起来，再理解原理。如果你更喜欢看视频，可以先看 ，配合 官方文档 一起学习。

1.1 环境配置

Python 版本

PocketFlow 需要 Python 3.9+（推荐 3.10 或更高版本）：

python --version
​

创建虚拟环境（推荐）

::: code-group

python -m venv .venv
.venv\Scripts\activate
​

python -m venv .venv
source .venv/bin/activate
​

:::

1.2 安装 PocketFlow

::: code-group

pip install pocketflow
​

# 如需锁定版本（教程编写时为 0.0.3）
pip install pocketflow==0.0.3
​

# PocketFlow 只有 100 行，也可以直接复制到项目中
# https://github.com/The-Pocket/PocketFlow/blob/main/pocketflow/__init__.py
​

:::

::: tip 零依赖
PocketFlow 没有任何第三方依赖，安装后即可直接使用，不会影响你现有的项目环境。
:::

1.3 第一个 Flow：Hello PocketFlow

from pocketflow import Node, Flow

class GreetNode(Node):
    def prep(self, shared):
        return shared.get("name", "World")

    def exec(self, name):
        return f"Hello, {name}! Welcome to PocketFlow."

    def post(self, shared, prep_res, exec_res):
        shared["greeting"] = exec_res
        print(exec_res)

# 构建并运行
greet = GreetNode()
flow = Flow(start=greet)
flow.run({"name": "小明"})
# 输出：Hello, 小明! Welcome to PocketFlow.
​

1.4 配套示例代码

本教程的所有代码示例都已整理为完整可运行的 Python 脚本，存放在 examples/ 文件夹中：

::: info 关于示例代码

• 所有示例自包含，不需要 API 密钥或外部服务
• LLM 调用使用模拟逻辑代替，便于理解核心机制
• 如需接入真实 LLM，只需替换 exec() 中的模拟逻辑即可
  :::