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épendance | Version minimale | Description |
|---|---|---|
| Node.js | 18 LTS ou version ultérieure recommandée | Pi Agent fonctionne sur Node.js et nécessite un environnement d'exécution qui prend en charge les fonctionnalités modernes de JavaScript |
| npm | Inclus avec Node.js | Utilisé pour installer Pi Agent et des paquets d'extension |
| Terminal | Prend en charge True Color | Recommandé : 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 :
| Plateforme | Terminal recommandé | Description |
|---|---|---|
| macOS | iTerm2、Kitty、Warp | Prise en charge native de True Color avec un bon affichage des images intégrées |
| Windows | Windows Terminal、WezTerm | Windows Terminal est le terminal moderne officiellement recommandé |
| Linux | Kitty、WezTerm、Alacritty | Les 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