Pi Desktop + Pi Agent Bundle

一个可直接克隆的独立公开仓库，同时包含 Pi Desktop（pi-gui）与 Pi Agent 完整源码。

pi-desktop-agent/
├── pi-desktop/       # Electron 桌面客户端（macOS）
├── pi-agent/         # Pi Agent runtime、CLI、TUI 与相关 packages
├── scripts/          # 本仓库辅助脚本
└── UPSTREAMS.md      # 上游来源与快照版本

本仓库不是 Git submodule 集合。普通 git clone 一次即可获得两个项目的全部源码。

获取仓库

git clone https://github.com/PLA-yi/pi-desktop-agent.git
cd pi-desktop-agent

环境要求

• macOS
• Node.js 22.19.0 或更高版本
• npm 与 Corepack
• Pi Desktop 官方构建目前以 Apple Silicon Mac 为主要支持目标

初始化依赖

在仓库根目录执行：

./scripts/setup-macos.sh

该脚本分别使用 Pi Agent 的 npm 锁文件和 Pi Desktop 的 pnpm 锁文件安装依赖，不读取或写入 API Key。

启动 Pi Agent

cd pi-agent
npm run build:offline
./pi-test.sh

Pi 默认使用当前用户与当前进程的文件系统、网络和凭据权限。需要更强隔离时，请参考 pi-agent/packages/coding-agent/docs/containerization.md。

启动 Pi Desktop

cd pi-desktop
corepack pnpm dev

在 macOS 上生成本地应用包：

cd pi-desktop
corepack pnpm --filter @pi-gui/desktop run package

生成结果位于 Pi Desktop 的构建输出目录。自行构建的应用默认不等同于上游签名、公证后的官方发布包。

项目关系

Pi Desktop 是 Pi Agent 的桌面 UI 外壳，运行时通过 @earendil-works/pi-coding-agent 使用 Pi 的会话、模型认证和 Agent 执行能力。本仓库将两套源码放在一起，方便统一下载、阅读和二次开发，但没有修改二者原有依赖关系。

来源与许可证

• Pi Desktop 上游：https://github.com/minghinmatthewlam/pi-gui
• Pi Agent 上游：https://github.com/earendil-works/pi
• 两个上游项目均采用 MIT License，各自的版权与许可文件完整保留在对应目录中。
• 精确快照提交见 UPSTREAMS.md。

本仓库是独立的源码集合仓库，不代表上游项目的官方发行渠道。