5分钟上手 pi-mono

快速安装并运行一个AI智能体,体验pi-mono的核心功能

环境要求

支持的操作系统

macOS Windows Linux

运行环境

Node.js >= 18.0 必需

所需工具

Git

克隆项目代码

必需

操作步骤

1

克隆项目

获取pi-mono源代码到本地

克隆主仓库
git clone https://github.com/badlogic/pi-mono.git
进入项目目录
cd pi-mono

预期结果:项目目录结构包含packages文件夹和package.json文件

确保网络连接正常,Git已正确安装

2

安装依赖

安装项目所需的所有npm包

安装项目依赖
npm install

预期结果:看到大量npm包被下载和安装,最后显示'added X packages'

首次安装可能需要几分钟,取决于网络速度

3

构建项目

编译TypeScript代码

构建所有包
npm run build

预期结果:看到编译过程输出,最后显示构建成功信息

如果遇到TypeScript错误,确保所有依赖已正确安装

4

运行编码智能体

启动交互式编码助手,这是最直观的体验方式

进入编码智能体目录
cd packages/coding-agent
启动编码智能体
npm start

预期结果:看到终端界面显示编码智能体的欢迎信息和交互提示

首次运行可能需要配置API密钥,可以按提示跳过或配置

验证成功

成功启动编码智能体并能够进行交互

看到终端显示编码智能体的欢迎界面
可以输入问题并获得AI响应
智能体能够理解并执行编码任务

快速提示

配置

如果遇到API密钥错误,可以先跳过配置,体验基础功能

其他

使用Ctrl+C退出智能体交互界面

配置

项目使用workspace模式,所有包在根目录统一管理

常见问题

1

npm install 失败,显示权限错误

使用 nvm 管理Node.js版本,或尝试 sudo npm install(不推荐)

2

npm run build 失败,显示TypeScript错误

确保先运行 npm install 安装所有依赖,然后重试

3

编码智能体启动后立即退出

检查是否缺少必要的环境变量,尝试在根目录运行 npm run check 诊断问题

4

内存不足或构建缓慢

可以单独构建特定包,如 cd packages/coding-agent && npm run build

下一步

配置API密钥

设置OpenAI、Anthropic等LLM提供商密钥以使用完整功能

探索其他包

尝试pi-tui终端UI库或pi-pods GPU部署管理工具

查看示例代码

参考packages目录下的示例了解各模块用法

助手