Pi Mono 中文教程：统一 LLM、Coding Agent 和 TUI
Pi Mono 是一个 Agent 工具箱 monorepo，包含统一多提供商 LLM API、Agent runtime、coding agent CLI、终端 UI、Web UI、Slack bot 和 vLLM pods。搜索结果里的 badlogic/pi-mono 当前重定向到 earendil-works/pi，教程先把仓库变化讲清楚。
pi-ai、pi-agent-core、pi-coding-agent、pi-tui 和 pi-web-ui 等包；不同 package 的安装方式和 provider 登录方式不要混写。1. 从源码开始
git clone https://github.com/earendil-works/pi.git && cd pi && npm install && npm run build
源码 README 还提供 npm run check 和 ./test.sh。先固定 commit，再在测试目录运行 coding agent；没有 API key 的 LLM 相关测试可能会跳过。
2. coding agent 与 provider
使用 coding-agent package 的当前文档选择启动命令和登录方式。统一 API 的价值在于上层 Agent 不必为每家模型重写接口，但上下文窗口、工具调用、费用和安全策略仍由 provider 决定。
3. 只读任务验证
选择无敏感数据目录 → 配置一个 provider → 让 Agent 读取两个文件并给出修改计划 → 不执行写入 → 检查退出和日志
确认 provider、工具和配置目录都按预期后，再开放写入。Slack bot、Web UI 和 vLLM pods 属于不同运行面，应单独测试，不要因为 monorepo 能编译就默认全部可用。
4. 适用边界
Pi Mono 适合想组合 Agent runtime、模型适配和自定义 TUI 的开发者；只想快速用一个 coding agent 的用户，直接安装对应 package 通常更省事。维护 monorepo 也意味着要关注依赖、构建和多个包的兼容性。
同类对比
相比单一 coding agent 应用，Pi Mono 更像可组合的 Agent 工具箱；相比直接调用 provider SDK，它额外提供 runtime、CLI 和 UI，但需要维护更多包。
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
原教程未展开的系统信息
架构与数据流
monorepo 把 provider 适配、Agent state/tool calling、coding agent CLI 和 UI/deployment package 分层；应用按 package 组合，不应把整个仓库当成一个单一桌面产品。
官方与对比资料
以下链接用于核对版本、安装方式、功能边界和同类差异。
常见问题
Pi Mono 是模型吗？
不是，它是包含模型 API、Agent runtime、CLI 和 UI 库的 monorepo。
badlogic/pi-mono 现在去哪了？
官方地址当前重定向到 earendil-works/pi，安装前按当前仓库 README 重新核对。
支持哪些模型？
官方 README 列出 OpenAI、Anthropic、Google 等 provider，具体认证和能力按 package 文档验证。
怎样减少升级风险？
固定 commit 或包版本，先跑 build、check 和测试，再在隔离目录升级 provider。