pi

一套 TypeScript 工具包，快速搭出能写代码的 AI agent

pi 是一个 TypeScript 编写的 AI agent 开发工具包，把构建智能体所需的几块基础设施打包在一起：统一 LLM API（屏蔽不同模型供应商的接口差异）、agent loop（负责多轮推理、工具调用与状态管理）、TUI 终端界面，以及一个开箱即用的 coding agent CLI。它解决的是开发者在做 AI 编程助手或自动化 agent 时，需要反复拼装模型接入、循环调度、工具执行和交互界面这些重复劳动的问题。核心能力包括：用一套接口切换多家大模型，内置可扩展的 agent 循环与工具调用机制，提供终端交互界面方便调试和日常使用，并直接给出一个可运行的编码 agent 命令行工具作为参考实现。整体定位偏框架和脚手架，适合想快速搭建 coding agent 或自定义 agent 产品的团队，在 TypeScript 生态里减少从零造轮子的成本。

开源 free 开发框架

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 106243

维护状态活跃

是否开源是

定价模式 free

项目数据

分类开发框架

开发团队earendil-works

所属国家

官网地址

GitHubhttps://github.com/earendil-works/pi

定价模式free

价格说明开源免费，无在线服务

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型

GitHub 星标★ 106243

30天Star增速

HF 下载量

上线时间2025-08-09 00:00:00

最近更新2026-09-16 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-12

浏览次数9

使用教程

难度：入门约 10 分钟部署方式：命令行工具 4 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

Node.js 与 npm 环境（README 未指定所需版本）
可访问 npm 源，能安装 @earendil-works 作用域下的包
按需准备模型供应商密钥（README 提到支持 OpenAI、Anthropic、Google 等）

安装与启动步骤

1确认运行环境

pi 全部包都用 TypeScript 编写并以 npm 包形式发布，先确认本机已装好 Node.js 与 npm。README 未给出最低版本要求。
```
node -v
npm -v
```
2安装编码 Agent CLI

README 列出的交互式编码 agent 命令行包为 @earendil-works/pi-coding-agent，通过 npm 安装。README 未说明具体安装方式与命令名。
```
npm install -g @earendil-works/pi-coding-agent
```
3安装核心运行时

如需自己写 agent，可再装 agent 运行时与统一 LLM API 两个包，分别负责工具调用/状态管理和多供应商模型接入。
```
npm install @earendil-works/pi-agent-core @earendil-works/pi-ai
```
4查看官网与文档

README 建议访问 pi.dev 看演示，并阅读 pi.dev/docs/latest 文档；也可以直接让 agent 自己解释用法。

如何确认成功

README 未给出验证命令；可尝试运行刚安装的 CLI，或打开 pi.dev 查看演示与文档确认可用。

常见问题

Q：pi 到底包含哪些东西？

A：README 列出三个包：@earendil-works/pi-coding-agent（交互式编码 agent CLI）、@earendil-works/pi-agent-core（带工具调用和状态管理的 agent 运行时）、@earendil-works/pi-ai（统一多供应商 LLM API）。

Q：支持哪些模型供应商？

A：README 中 pi-ai 的描述写明统一多供应商 LLM API，括号里举例为 OpenAI、Anthropic、Google 等，未列出完整清单。

Q：我提的 issue 或 PR 为什么被自动关闭？

A：README 说明来自新贡献者的 issue 和 PR 默认会被自动关闭，维护者每天会审查这些自动关闭的内容。

Q：去哪里看用法和演示？

A：访问项目官网 pi.dev 查看演示，或阅读 pi.dev/docs/latest 文档；README 也提到可以直接让 agent 解释它自己。

注意事项

README 未提供安装步骤、配置项和端口等信息，上文命令是依据 npm 包名推断的，执行前请以官网文档为准。
除三个主要包外，README 还列出 @earendil-works/chord 与 @earendil-works/pi-telemetry 等其他包，按需选用。
新贡献者的 issue/PR 会被自动关闭，维护者每日集中审查，属正常流程。

核心亮点

统一 LLM API 屏蔽多供应商差异，切换模型不用改业务代码
内置 agent loop 和工具调用，省去自己实现多轮推理调度
自带 TUI 和 coding agent CLI，装完就能跑起来验证效果

不足之处

功能覆盖面广但每块深度有限，复杂生产场景可能仍需自行扩展
生态和文档相对新，长期维护与社区案例待观察

适用场景

快速搭建一个终端里的 AI 编程助手
为内部工具接入多模型并统一管理调用
作为教学或原型脚手架，验证 agent 循环与工具调用设计

替代项目

LangChain、Vercel AI SDK

项目介绍

pi 是一个开发框架领域的开源项目，官方简介：AI agent toolkit: unified LLM API, agent loop, TUI, coding agent CLI。项目使用 TypeScript 开发，在 GitHub 上获得 104149 星标。

上一篇：engrim

下一篇：ten-framework

pi