pi-from-scratch

SaladDayMIT活跃维护

用 600 行 TypeScript 从零实现一个迷你 pi-agent，帮你搞懂 agent 循环、工具调用和 LLM 编排的底层原理，适合边看边动手写自己的编码 Agent。

600 行 TypeScript 写成的超级迷你版 pi，让你轻松从 0 写出属于你的 pi-agent

暂无版本1,306star +2 / 7 天109fork同步于 2026-11-10 17:51 UTC

编码 Agent Agent 循环工具调用 TypeScript LLM Agent

对比 GitHub 官网 agent-loop ai-agent coding-agent llm llm-agent

怎么上手

由 README 提炼，执行前请确认

原文

npm install
export NANOPI_API_KEY=your-api-key
npm run dev

硬件要求按 README 说明

README 未说明，仅要求 Node.js 22 或更高版本，并需要一个 OpenAI 兼容 API

下载：源码 zip·GitHub Releases（安装包）本站不镜像安装包

项目说明

由 README 自动翻译提炼

没人工点评？写下你的经验

600 行 TypeScript 手写迷你 coding agent，跟着文章从零理解 pi 的数据流

用 600 行 TypeScript 从零实现一个迷你 pi-agent，帮你搞懂 agent 循环、工具调用和 LLM 编排的底层原理，适合边看边动手写自己的编码 Agent。

核心能力

按 pi 的数据流拆解，需要什么造什么
边读文章边补全源码，读完即得完整 nano-pi
内置 Trace 跟踪，可打断点逐行过代码
实现读文件、改代码、执行命令的 agent 能力

容易踩的坑

需要 Node.js 22 及以上版本；必须自备 OpenAI 兼容 API Key，否则无法运行；默认请求 https://api.openai.com/v1，用第三方中转需设 NANOPI_BASE_URL；教学网站需单独进 web 目录安装运行

内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README

用户点评

登录用户的真实使用记录，可按版本和硬件筛选

共 0 条

还没有人点评。第一个说出真实体验的人最有价值。

README 原文

未翻译

在 GitHub 打开

PI from Scratch

从零手写一个能读文件、改代码、执行命令的 TypeScript coding agent。

项目沿着 pi 的数据流拆解，需要什么、我们造什么，所有组件都是符合直觉的。

删除 pi 的工程细节，留下 pi 的核心思想。

放轻松，这是一篇文章，不是一本书，你会很容易看懂。

网站把文章和源码放在一起。阅读推进时，右侧编辑器会逐步补全代码，当你看完的时候，nano-pi 的代码也会全部呈现在编辑器中。

同时设计了一个 Trace 跟踪，可以打断点逐行过代码，希望能帮助大家理解代码执行流。

在线阅读 PI from Scratch

文章保留古法手敲，尽可能没有ai味，希望大家读的开心。

运行 nano-pi

需要 Node.js 22 或更高版本，以及一个 OpenAI 兼容 API。

npm install
export NANOPI_API_KEY=your-api-key
npm run dev

可选环境变量：

NANOPI_MODEL：模型名
NANOPI_BASE_URL：OpenAI 兼容接口地址，默认 https://api.openai.com/v1

线上 trace 是预先生成的静态数据，浏览网站不会发起模型请求。

本地运行教学网站

cd web
npm install
npm run dev

Thanks

感谢 OpenModel 为本项目提供 API 测试支持。OpenModel 提供稳定可靠的 AI API 和生产级 SLA 保障，一个接口即可调用 50+ 主流模型，并可直接用于 Claude Code、Codex，以及你刚刚亲手做好的 nano-pi 😈。
感谢 Cubence 对本项目的赞助。Cubence 自 2025 年 9 月起提供稳定高效的 API 中转服务，兼容 OpenAI 与 Anthropic 协议，可直接接入 Codex、Claude Code、pi 和 oh-my-pi 等主流编程工具。
感谢 pi-book 带来的启发，为本项目从零实现 nano-pi 提供了不少思路和参考。如果你想在完成 nano-pi 后继续深入理解 pi，这本书很值得读。

Star History

License

MIT