makecindy
精选
cindy
Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.
AI 仓库情报摘要
FR-AI / ANALYSIS为什么值得关注
基于真实的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 和编程语言匹配的相似项目。
deerwork-ai
精选
deer-workflow
An open-source Dynamic Workflow runtime that combines deterministic TypeScript orchestration with replaceable Agent runtimes.
uzairansaruzi
精选
hermex
Hermex is a native SwiftUI iPhone app that lets you control a self-hosted Hermes AI agent directly from your phone, with no subscriptions, tracking, or third-party relay.