项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1430
技术标签
使用教程
⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。
⚠ 该项目 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
上一篇:openmcp-client
同类项目推荐
rustchain-bounties
开源
写代码、找 Bug 赚 RTC,新手也能参与开源赚钱
Bounties for real work on the RustChain ecosystem: code, tests, docs, tutorials, bug···
pilotfish
开源
让便宜模型干活,贵模型把关,省钱又保质量
Multi-model orchestration layer for Claude Code — the frontier model plans, cheaper···
dspy-compounding-engineering
开源
本地AI代理,从你的代码库学习,越用越懂你的项目。
A local-first AI engineering agent that learns from your codebase using DSPy.
Awesome-GPT-Agents
开源
网络安全 GPT 智能体大全,找工具不迷路
A curated list of GPT agents for cybersecurity
cadis
开源
本地多代理编码,策略门控,语音操控,安全可控
Rust-first, local-first multi-agent runtime with a desktop HUD, policy-gated tools, ···
Awesome-AGI-Agents
开源
一站式逛遍 AGI 智能体优质项目,快速上手不迷路
Awesome list of AGI Agents. Agents 精选资源合集.
crucible
开源
让AI多角度辩论,产出严谨研究报告,告别单次提示的片面。
AI-native multi-agent research workflow: parallel evidence gathering, 7-direction de···
awesome-ai-startups
开源
汇集独立AI创业项目,快速发现新工具和灵感。
A curated list of indie-built AI startups — bootstrapped, pre-seed, and angel-funde···
给旧硬件做数字档案,上链存证,让古董硬件有身份。
Digital archaeology skill for cataloging rare hardware, archiving software assets, a···
