Blaizzy
精选
nativ
Nativ is a native macOS app that lets you run AI models locally on Apple silicon, offering chat, model management, performance analytics, and an OpenAI/Anthropic-compatible API server.
为什么值得关注
基于真实的Git历史，每个checkpoint都有可运行的代码、聚焦测试和故障实验，让学习过程可验证、可追溯。
适合谁使用
- 希望从头构建AI Agent的开发者
- 对TypeScript和Agent架构感兴趣的工程师
- 喜欢通过Git增量式学习实践者
典型使用场景
- 自学Agent循环、工具调用和会话管理
- 作为实现TypeScript编码Agent的参考模板
- 用于技术培训或AI Agent工作坊
项目优势
- 15个递增式checkpoint，循序渐进
- 每章含真实commit、聚焦测试和故障实验
- 提供在线教材和可克隆运行的Git仓库
使用前须知
- 需要TypeScript基础和异步编程经验
- 依赖特定上游Pi提交，可能随时间过时
- 仅聚焦一种Agent架构（Pi风格），非通用教程
README 快速开始
简体中文 · English
动手学 Pi
沿 15 个 checkpoint，从一条离线轨迹开始，亲手实现一个 Pi-style coding agent。
在线阅读 · 课程代码
这是什么
沿 15 个可运行 checkpoint，从一条离线 Agent 轨迹出发，逐步实现：
TypeScript 协议 → 流式模型 → Provider → 工具 → Agent Loop → 会话树 → Context Compaction → 扩展 → Eval
每章由四部分闭环：教材正文 + 真实 commit + 聚焦测试 + 故障实验。课程代码不是伪代码演示，而是一条可以 checkout、运行和验证的 Git 历史。
内容速览（Checkpoint 00–14）
15 个 checkpoint 沿同一条 Agent 执行链逐层推进：先建立消息与模型协议，再接入工具和循环，随后保存状态与历史，最后组合 Runtime 并用独立评测验收。
| 部分 | Checkpoint | 章节 | 这一章完成什么 | 阅读 |
|---|---|---|---|---|
| 序章 | 00 | 一次 README 读取请求怎样走完 Agent 闭环 | 跟随一次 README 请求，把用户消息、两次模型调用、工具调用与结果、最终回答连成完整闭环。 | 打开 |
| I · 模型与协议 | 01 | TypeScript 生存集：四个 DemoEvent 怎样进入测试 | 用四个 DemoEvent 串起联合类型、运行时校验、Promise 与 ESM 测试。 | 打开 |
| I · 模型与协议 | 02 | EventStream：同一个对象怎样交付下一项和最终结果 | 实现 EventStream，让事件先到与消费者先等两种时序都能交付过程项和最终结果。 | 打开 |
| I · 模型与协议 | 03 | 保存一次完整的工具往返 | 把文本、工具调用和配对结果保存为统一消息，并从模型事件收束出完整 assistant message。 | 打开 |
| I · 模型与协议 | 04 | ScriptedModel：同一个实例怎样依次播放两个回合 | 实现可重复播放预设回合的 ScriptedModel，保存请求快照并投影稳定事件流。 | 打开 |
| I · 模型与协议 | 05 | 模型调用：在课程协议和 Provider API 之间转换 | 把课程消息写成 Provider 请求，再将 SSE 响应还原为统一模型事件。 | 打开 |
| II · 工具与循环 | 06 | 工具调用：一条 echo 请求怎样变成配对结果 | 让 echo 调用经过 schema、Registry 和 executor，返回沿用原 call id 的工具结果。 | 打开 |
| II · 工具与循环 | 07 | Agent Loop：一次 README 往返怎样调用模型两次 | 实现两轮 Agent Loop：模型提出 read，工具结果写回后再生成最终回答。 | 打开 |
| II · 工具与循环 | 08 | 四个工具怎样在同一个 workspace 里完成文件任务 | 让 read、write、edit、bash 在同一 workspace 内完成受控的文件与进程操作。 | 打开 |
| III · 状态与历史 | 09 | 从单次循环到有状态 Agent | 让同一个 Agent 保存跨运行消息，并管理订阅、取消、运行中指令、follow-up 与重入。 | 打开 |
| III · 状态 |
项目描述
《动手学 Pi》：沿 15 个真实 checkpoint 从零构建 Pi-style Agent
相关仓库与替代方案
根据分类、Topic 和编程语言匹配的相似项目。
mereyabdenbekuly-ctrl
精选
clodex-ide
Clodex is an open-source, local-first agentic IDE that combines persistent AI tasks, code, terminal, browser, Git, models, memory, and governed execution in one Electron workspace, currently in technical preview.
Jakubantalik
精选
thinking-orbs
A React component library that renders six hand-tuned animated thought orb loading indicators on a plain 2D canvas, with two purpose-tuned sizes and automatic theme detection for AI and agent UIs.