pi

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署开发框架 🍴 复刻 15343 🐛 待处理 315 👀 关注 340

GitHub ↗

GitHub 星标 ★ 119520

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源免费，无在线服务

项目预览

项目数据

分类开发框架

开发团队earendil-works

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

定价模式🏷️完全免费

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

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言TypeScript

GitHub 星标★ 119520

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

代码更新2026-11-02

仓库体积92.4 MB

本站数据更新2026-11-02

维护状态活跃

收录时间2026-09-12

浏览次数26

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-12 · 当前星标 ★ 119520

使用教程

⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。

难度：入门约 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 会被自动关闭，维护者每日集中审查，属正常流程。