Instalación de Pi Agent
Este capítulo explica cómo instalar Pi Agent en diferentes plataformas y completar la configuración básica del entorno.
Requisitos del entorno
Antes de instalar Pi Agent, asegúrate de que tu sistema cumpla los siguientes requisitos:
| Dependencia | Versión mínima | Descripción |
|---|---|---|
| Node.js | Se recomienda 18 LTS o superior. | Pi Agent se ejecuta sobre Node.js y requiere un entorno de ejecución que admita las características modernas de JavaScript. |
| npm | Se incluye con Node.js. | Se utiliza para instalar Pi Agent y paquetes de extensión. |
| Terminal | Soporte para True Color | Recomendados: iTerm2 (macOS), Windows Terminal, Kitty, WezTerm. |
Comprueba si Node.js está instalado:
node --version
La salida debería ser similar a:
v20.11.0
Comprueba si npm se instaló junto con Node.js (se incluye al instalar Node.js):
npm --version
La salida debería ser similar a:
10.2.4
Si tu versión de Node.js es inferior a 18, actualízala primero. Puedes usar nvm (Node Version Manager) para gestionar varias versiones de Node.js.
Instalación
Método 1: Instalación global con npm
Esta es la forma más común y sencilla de instalar, compatible con macOS, Linux y Windows:
# 全局安装 Pi Agent # --ignore-scripts 禁用依赖包的生命周期脚本，提高安装安全性 npm install -g --ignore-scripts @earendil-works/pi-coding-agent
Tras la instalación, verifica la versión:
pi --version
Después de la instalación,piel comando estará disponible directamente en la terminal.
Método 2: Script de un solo clic con curl
En Linux o macOS, también puedes usar el script de instalación oficial:
# 使用 curl 下载并执行安装脚本 curl -fsSL https://pi.dev/install.sh | sh
Este script detecta automáticamente tu sistema y completa la instalación; en esencia, también instala globalmente a través de npm.
Método 3: Otros gestores de paquetes
Si usas pnpm, Yarn o Bun, también puedes instalar con el comando correspondiente:
# 使用 pnpm 安装 pnpm add -g @earendil-works/pi-coding-agent # 使用 Yarn 安装 yarn global add @earendil-works/pi-coding-agent # 使用 Bun 安装 bun install -g @earendil-works/pi-coding-agent
Método de desinstalación
Al desinstalar Pi Agent, usa el mismo gestor de paquetes que utilizaste para instalarlo:
# npm o curl 安装的用 npm 卸载 npm uninstall -g @earendil-works/pi-coding-agent # pnpm 安装的 pnpm remove -g @earendil-works/pi-coding-agent # Yarn 安装的 yarn global remove @earendil-works/pi-coding-agent # Bun 安装的 bun uninstall -g @earendil-works/pi-coding-agent
Desinstalar Pi Agent no elimina tu configuración, credenciales ni registros de sesión. Estos datos se guardan en el directorio~/.pi/agent/. Si deseas eliminarlos por completo, puedes borrar ese directorio manualmente.
Recomendaciones de terminal
Pi Agent utiliza color RGB de 24 bits para renderizar la interfaz de terminal. Se recomiendan los siguientes terminales para obtener la mejor experiencia:
| Plataforma | Terminal recomendado | Descripción |
|---|---|---|
| macOS | iTerm2、Kitty、Warp | Compatibilidad nativa con True Color y buena visualización de imágenes incrustadas. |
| Windows | Windows Terminal、WezTerm | Windows Terminal es el terminal moderno recomendado oficialmente. |
| Linux | Kitty、WezTerm、Alacritty | Todos son compatibles con True Color y aceleración por GPU. |
Consulta más herramientas de terminal en:https://www.example.com/w3cnote/terminal-tools.html
Comprueba si tu terminal es compatible con True Color:
$ echo $COLORTERM truecolor
Si la salida estruecoloro24bit, significa que tu terminal admite la representación completa del color.
Primera ejecución
Una vez completada la instalación, entra en un directorio de proyecto e inicia Pi Agent:
$ cd /path/to/your-project $ pi
Al iniciar por primera vez, verás la pantalla de bienvenida de Pi Agent.
Aún no hay un proveedor de IA configurado; primero debes completar la autenticación, lo cual se explicará en detalle en el próximo capítulo.
Al iniciarse, Pi Agent usa el directorio de trabajo actual (cwd) como directorio raíz del proyecto. Tiene permisos de lectura y escritura sobre los archivos de ese directorio; se recomienda usarlo bajo control de versiones con git para poder revertir los cambios fácilmente.
Actualizar Pi Agent
Mantén Pi Agent actualizado a la última versión:
# 仅更新 Pi Agent 本身 pi update --self # 更新 Pi Agent 和所有已安装的扩展包 pi update --all # 更新模型目录（获取最新的可用模型列表） pi update --models
Usa--self --forcepuedes forzar la reinstalación de Pi Agent, incluso si ya está en la última versión:
$ pi update --self --force
Ten en cuenta que las instalaciones gestionadas mediante scripts como install.sh no son compatibles con--force。
Cuando este tipo de instalación gestionada necesite repararse, basta con volver a ejecutar el script de instalación.
Otras extensiones