Installation de Pi Agent

Ce chapitre explique comment installer Pi Agent sur différentes plateformes et effectuer la configuration de base de l'environnement.


Exigences d'environnement

Avant d'installer Pi Agent, veuillez vous assurer que votre système répond aux exigences suivantes :

DépendanceVersion minimaleDescription
Node.js18 LTS ou version ultérieure recommandéePi Agent fonctionne sur Node.js et nécessite un environnement d'exécution qui prend en charge les fonctionnalités modernes de JavaScript
npmInclus avec Node.jsUtilisé pour installer Pi Agent et des paquets d'extension
TerminalPrend en charge True ColorRecommandé : iTerm2 (macOS), Windows Terminal, Kitty, WezTerm

Vérifiez si Node.js est installé :

node --version

Sortie similaire à :

v20.11.0

Vérifiez si npm a été installé en même temps (il est fourni avec Node.js) :

npm --version

Sortie similaire à :

10.2.4

Si votre version de Node.js est inférieure à 18, veuillez d'abord la mettre à niveau. Vous pouvez utiliser nvm (Node Version Manager) pour gérer plusieurs versions de Node.js.


Installation

Méthode 1 : Installation globale via npm

C'est la méthode d'installation la plus courante et la plus simple, adaptée à macOS, Linux et Windows :

# 全局安装 Pi Agent
# --ignore-scripts 禁用依赖包的生命周期脚本,提高安装安全性
npm install -g --ignore-scripts @earendil-works/pi-coding-agent

Vérifiez la version après l'installation :

pi --version

Après l'installation, la commandepipeut être utilisée directement dans le terminal.

Méthode 2 : Script en un clic via curl

Sous Linux ou macOS, vous pouvez également utiliser le script d'installation officiel :

# 使用 curl 下载并执行安装脚本
curl -fsSL https://pi.dev/install.sh | sh

Ce script détecte automatiquement votre système et termine l'installation. Essentiellement, il installe aussi globalement via npm.

Méthode 3 : Autres gestionnaires de paquets

Si vous utilisez pnpm, Yarn ou Bun, vous pouvez également installer avec la commande correspondante :

# 使用 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éthodes de désinstallation

Lors de la désinstallation de Pi Agent, utilisez le même gestionnaire de paquets que celui utilisé pour l'installation :

# npm 或 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

La désinstallation de Pi Agent ne supprimera pas votre configuration, vos identifiants ou vos enregistrements de session. Ces données sont stockées dans le répertoire~/.pi/agent/. Pour tout supprimer complètement, vous pouvez supprimer manuellement ce répertoire.


Recommandations de terminaux

Pi Agent utilise la couleur RVB 24 bits pour afficher l'interface du terminal. Les terminaux suivants sont recommandés pour une expérience optimale :

PlateformeTerminal recommandéDescription
macOSiTerm2、Kitty、WarpPrise en charge native de True Color avec un bon affichage des images intégrées
WindowsWindows Terminal、WezTermWindows Terminal est le terminal moderne officiellement recommandé
LinuxKitty、WezTerm、AlacrittyLes deux prennent en charge True Color et l'accélération GPU

Pour plus d'outils de terminal, voir :https://www.example.com/w3cnote/terminal-tools.html

Vérifiez si votre terminal prend en charge True Color :

$ echo $COLORTERM
truecolor

Si la sortie esttruecolorou24bit, votre terminal prend en charge le rendu complet des couleurs.


Premier lancement

Après l'installation, entrez dans un répertoire de projet et lancez Pi Agent :

$ cd /path/to/your-project
$ pi

Au premier lancement, vous verrez l'écran d'accueil de Pi Agent.

À ce stade, aucun fournisseur d'IA n'a encore été configuré. Vous devez d'abord terminer l'authentification — cela sera expliqué en détail dans le chapitre suivant.

Lorsque Pi Agent démarre, il utilise le répertoire de travail actuel (cwd) comme racine du projet. Il dispose des permissions de lecture et d'écriture sur les fichiers du répertoire. Il est recommandé de l'utiliser sous contrôle de version git afin que les modifications puissent être facilement annulées.


Mise à jour de Pi Agent

Maintenez Pi Agent à jour avec la dernière version :

# 仅更新 Pi Agent 本身
pi update --self

# 更新 Pi Agent 和所有已安装的扩展包
pi update --all

# 更新模型目录(获取最新的可用模型列表)
pi update --models

L'utilisation de--self --forceforce une réinstallation de Pi Agent, même s'il s'agit déjà de la dernière version :

$ pi update --self --force

Notez que les installations gérées par des scripts d'installation tels que install.sh ne prennent pas en charge--force。

Lorsqu'une telle installation gérée doit être réparée, exécutez simplement à nouveau le script d'installation.

Autres extensions