pi-from-scratch
活跃·★ 1.3k·MIT·更新于 2026-10-24
PI from Scratch 是一篇中文文章，而不是框架。它沿着 pi 编程智能体的数据流，重新实现一个精简版 nano-pi，能读文件、改代码、执行命令，保留 pi 的核心思想，删去工程细节。
配套网站把文章和源码放在一起：随着阅读推进，右侧编辑器逐步补全代码，读完时 nano-pi 的代码全部呈现。Trace 功能可以打断点、逐行走查执行流程；线上 trace 是预先生成的静态数据，浏览网站不会发起模型请求。作者说明文章为手写。
自己运行 nano-pi 需要 Node.js 22 以上和一个 OpenAI 兼容接口，通过 NANOPI_API_KEY 配置，可选 NANOPI_MODEL 和 NANOPI_BASE_URL。教学网站也可在 web 目录本地运行。项目采用 MIT 许可。
#编程智能体#教程#TypeScript#智能体循环#pi 智能体#大语言模型
01
功能特性
01一步步从零实现一个可运行的编程智能体
02网站在阅读时同步在编辑器中补全代码
03Trace 视图可逐行查看智能体的执行流程
04nano-pi 可接入任意 OpenAI 兼容接口运行
02
为什么选择它
+代码随文字同步出现在编辑器中，每一步讲到哪写到哪。
+可逐行走查的 Trace 展示智能体循环的实际执行过程。
+篇幅小，一次读完，并可接入任意 OpenAI 兼容接口运行。
03
权衡点
!文章为中文。
!nano-pi 是教学版本，不能替代日常使用的 pi。
!本地运行需要自备 OpenAI 兼容接口的密钥。
04
维护状况检查
活跃检查日期: 2026-10-25
- 最近提交
- 2026-10-24
- 近 90 天提交数
- 23
- 近 90 天发布数
- 0
- 最新发布
- —
- 未关闭 issue
- 0
- 近期 issue 至少有一条评论的比例
- 2/4
近 12 周每周提交数
最早的一周在左边，最近 4 周为橙色。数据来源：GitHub 提交统计。
状态规则：GitHub 上已归档 = 已归档；最近提交在 90 天内 = 活跃；91 到 365 天 = 放缓；更久 = 停滞。所有数字来自所示日期的 GitHub API。
05
兼容性
Node.js 22+
运行时
已通过文档验证
OpenAI-compatible APIs
模型接口
已通过文档验证
06
快速开始
1
$ npm install
2
$ npm run dev
07
使用场景
↳学习编程智能体的工具调用循环如何运作
↳以 nano-pi 为基础做自己的智能体实验
↳为阅读完整的 pi 代码库打基础
08
同类工具
Open Interpreter★ 68.7k
面向终端的编程 Agent，针对低成本和开源模型优化。基于 OpenAI Codex 分叉，可以模拟其他 Agent 运行框架，并在原生沙箱中执行命令。
Codewhale★ 41.1k
用 Rust 编写的开源终端编码智能体，支持 40 多家模型服务商和本地模型，默认 DeepSeek；/receipts 列出改过的文件、运行的命令和调用记录，可撤销。
评论
登录后发表评论
暂无评论，来发表第一条吧