Repolode
提交项目
SaladDay

SaladDay/pi-from-scratch

一份从零手写 TypeScript 编程 Agent 的教程，实现读文件、改代码和执行命令的核心能力。

在 GitHub 查看官网
Star
1,303
Fork
108
未关闭 Issue
1
最近提交
14天前

这是什么？

PI from Scratch 是一份动手教程，用约 600 行 TypeScript 重新实现 pi 编程 Agent 的核心思路，产出的项目叫 nano-pi。它沿着 pi 的数据流逐个拆解组件，只保留理解原理所必需的部分，去掉了工程化细节。

项目以文章加源码的形式呈现。配套网站上，阅读时右侧编辑器会逐步补全代码，读完即可看到完整的 nano-pi 实现；同时提供 Trace 跟踪功能，可以打断点、逐行单步查看代码执行流程。

nano-pi 通过环境变量配置 API Key、模型名和接口地址，可接入任意 OpenAI 兼容接口。线上 Trace 为预先生成的静态数据，浏览网站不会发起模型请求；本地运行需要 Node.js 22 或更高版本。

核心功能

  • 01实现一个能读文件、改代码、执行命令的 coding agent。
  • 02沿 pi 的数据流拆解，只保留核心设计思想。
  • 03文章与源码同步呈现，阅读时编辑器逐步补全代码。
  • 04提供 Trace 跟踪，可打断点逐行查看执行流程。
  • 05通过环境变量接入任意 OpenAI 兼容接口。

适用场景

  • 理解 coding agent 的循环执行、工具调用和文件编辑等内部机制。
  • 在深入研究 pi 之前，先亲手搭建一个小型 agent 作为基础。
  • 在培训或课程中讲解 Agent 架构。

快速上手

  1. 1

    安装 Node.js 22 或更高版本，并获取一个 OpenAI 兼容 API 密钥

  2. 2

    安装依赖

    npm install
  3. 3

    设置 API 密钥

    export NANOPI_API_KEY=your-api-key
  4. 4

    启动项目

    npm run dev

使用前须知

  • 运行智能体需要一个 OpenAI 兼容的 API 密钥。

入选 Repolode 开源周刊

收录于专题

开源 AI Agent 框架与应用AI 编程助手与编码 Agent

标签

#ai-agent#coding-agent#llm#tool-calling#typescript#tutorial#agent-loop#llm-agent#pi#pi-agent

常见问题

pi-from-scratch 是什么？
一份从零手写 TypeScript 编程 Agent 的教程，实现读文件、改代码和执行命令的核心能力。 PI from Scratch 是一份动手教程，用约 600 行 TypeScript 重新实现 pi 编程 Agent 的核心思路，产出的项目叫 nano-pi。它沿着 pi 的数据流逐个拆解组件，只保留理解原理所必需的部分，去掉了工程化细节。
pi-from-scratch 可以免费使用吗？用的什么许可证？
pi-from-scratch 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
pi-from-scratch 还在维护吗？
活跃维护中。pi-from-scratch 最近一次提交是在 2026年10月24日。
pi-from-scratch 适合用来做什么？
理解 coding agent 的循环执行、工具调用和文件编辑等内部机制。 在深入研究 pi 之前，先亲手搭建一个小型 agent 作为基础。 在培训或课程中讲解 Agent 架构。
pi-from-scratch 怎么安装和运行？
安装 Node.js 22 或更高版本，并获取一个 OpenAI 兼容 API 密钥 安装依赖: npm install 设置 API 密钥: export NANOPI_API_KEY=your-api-key 启动项目: npm run dev
在哪里获取 pi-from-scratch？
源代码和安装说明在 GitHub 上：https://github.com/SaladDay/pi-from-scratch

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目