pi-textbook

15 步手写代码，从零构建你的 AI Agent。

《动手学 Pi》是一本开源的中文技术教程，以 TypeScript 为语言，带领读者从零开始构建一个 Pi-style Agent。项目沿 15 个真实 checkpoint 循序渐进，覆盖 Agent 工程的核心环节，如工具调用、记忆管理、规划与执行等。它解决的是 AI Agent 开发中“纸上谈兵”的问题，通过手写代码让学习者深入理解 Agent 的内部机制，而非仅停留在 API 调用层面。核心能力包括：提供可运行的代码示例、清晰的步骤拆解、以及完整的项目演进路径。适合希望系统掌握 Agent 工程实践的开发者，作为从理论到实战的桥梁。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1366

维护状态维护中

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队hahhforest

所属国家

官网地址https://build-your-own-pi-cn.enochzhang.chatgpt.site

GitHubhttps://github.com/hahhforest/pi-textbook

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型agent-engineering,ai-agent,chinese,llm,textbook,typescript

GitHub 星标★ 1366

30天Star增速

HF 下载量

上线时间2026-07-21 00:00:00

最近更新2026-09-23 00:00:00

维护状态维护中

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：进阶约 10 分钟部署方式：本地安装 5 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

能访问在线阅读站点（README 提供的官网链接）
已安装 Git，用于获取课程代码仓库
具备 TypeScript / Node.js 运行环境（README 未给出具体版本）
了解基本的命令行操作

安装与启动步骤

1在线阅读教程

打开 README 给出的在线阅读网址，先读序章，了解一次 README 请求如何走完 Agent 闭环。
2获取课程代码

课程代码在 pi 仓库的 packages/pi-course 目录，README 链接指向 course/build-your-own-pi 分支。
```
git clone -b course/build-your-own-pi https://github.com/hahhforest/pi.git
```
3进入课程目录

克隆后进入课程代码所在路径，后续各章的运行与测试都在这个目录内进行。
```
cd pi/packages/pi-course
```
4逐章切换 checkpoint

课程由 15 个真实 commit 组成，按章节说明 checkout 对应提交并运行；README 未给出具体命令。
5按四步闭环学习

每章按「教材正文 + 真实 commit + 聚焦测试 + 故障实验」四部分推进，从 00 顺序学到 14。

如何确认成功

能打开在线阅读站点看到 Checkpoint 00–14 目录，并在本地 checkout 出某章代码跑通该章测试。

常见问题

Q：需要什么编程基础？

A：课程使用 TypeScript。若基础薄弱，可先看 Checkpoint 01 的「TypeScript 生存集」，用四个 DemoEvent 串起联合类型、运行时校验与 ESM 测试。

Q：必须配置模型 API Key 吗？

A：不必。课程从一条离线 Agent 轨迹出发，序章用一次 README 读取请求串起完整闭环，可在离线前提下理解 Agent 执行链，README 未要求任何 API Key。

Q：课程代码在哪里？

A：在 https://github.com/hahhforest/pi 仓库的 packages/pi-course 目录下（对应 course/build-your-own-pi 分支），不是伪代码演示，而是可 checkout、运行和验证的 Git 历史。

Q：一共多少章，需要按顺序学吗？

A：共 15 个 checkpoint（00–14），沿同一条 Agent 执行链逐层推进：先消息与模型协议，再工具与循环，随后状态与历史，最后 Runtime 与评测，建议按序号顺序学习。

Q：有中文版和英文版吗？

A：README 提供简体中文与 English 两个版本，默认为简体中文，英文版见 README_EN.md。

注意事项

README 未提供 npm / pnpm 安装与启动命令，各章具体运行方式请以对应 checkpoint 章节说明为准，不要自行套用其他项目的命令。
克隆所用分支 course/build-your-own-pi 依据 README 中的课程代码链接推断，若失效请以仓库实际分支为准。
学习节奏建议：先读教材正文，再对照真实 commit 看代码演进，然后跑聚焦测试，最后做故障实验加深理解。

核心亮点

以真实 checkpoint 驱动，学习路径清晰，每步都有可运行代码。
深入 Agent 内部机制，而非只调 API，能真正提升工程能力。
全中文教程，对中文开发者友好，降低学习门槛。

不足之处

项目早期，文档和社区支持有待完善。
仅覆盖 Pi-style Agent，可能不涉及其他 Agent 架构。

适用场景

想系统学习 Agent 工程原理的开发者。
需要从零搭建 Agent 的团队作为技术参考。
作为高校或培训机构的 AI 课程教材。

替代项目

smol-agent、AgentGPT、AutoGPT

项目介绍

pi-textbook 是智能体领域的开源项目，由 hahhforest 开发，是 2026 年新上线的项目。

在全站 13,109 个收录项目中，它的 GitHub 星标数（1,366）位列前 30%，在智能体分类中处于中上游。

项目仍在小幅维护中，最近一次代码更新于 2026-09-23。从国内网络环境看，当前已无法正常访问。

它主要面向的使用场景是：想系统学习Agent工程原理的开发者。同类可对比的替代方案包括 smol-agent、AgentGPT、AutoGPT。

上一篇：openmcp-client

下一篇：claude-code-skills-zh