Pi Agent Installation

Dieses Kapitel erklärt, wie Sie Pi Agent auf verschiedenen Plattformen installieren und die grundlegende Umgebungskonfiguration abschließen.


Umgebungsanforderungen

Bevor Sie Pi Agent installieren, stellen Sie bitte sicher, dass Ihr System die folgenden Anforderungen erfüllt:

AbhängigkeitMindestversionBeschreibung
Node.js18 LTS oder höher empfohlenPi Agent läuft auf Node.js und erfordert eine Laufzeitumgebung, die moderne JavaScript-Funktionen unterstützt
npmMit Node.js mitgeliefertWird verwendet, um Pi Agent und Erweiterungspakete zu installieren
TerminalUnterstützt True ColorEmpfohlen: iTerm2 (macOS), Windows Terminal, Kitty, WezTerm

Prüfen Sie, ob Node.js installiert ist:

node --version

Ausgabe ähnelt:

v20.11.0

Prüfen Sie, ob npm zusammen damit installiert wurde (es wird mit Node.js mitgeliefert):

npm --version

Ausgabe ähnelt:

10.2.4

Wenn Ihre Node.js-Version niedriger als 18 ist, führen Sie bitte zuerst ein Upgrade durch. Sie können nvm (Node Version Manager) verwenden, um mehrere Node.js-Versionen zu verwalten.


Installation

Methode 1: Globale Installation über npm

Dies ist die gebräuchlichste und einfachste Installationsmethode, geeignet für macOS, Linux und Windows:

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

Überprüfen Sie die Version nach der Installation:

pi --version

Nach der Installation kannpider Befehl direkt im Terminal verwendet werden.

Methode 2: Ein-Klick-Skript über curl

Unter Linux oder macOS können Sie auch das offizielle Installationsskript verwenden:

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

Dieses Skript erkennt Ihr System automatisch und schließt die Installation ab. Im Wesentlichen installiert es ebenfalls global über npm.

Methode 3: Andere Paketmanager

Wenn Sie pnpm, Yarn oder Bun verwenden, können Sie auch mit dem entsprechenden Befehl installieren:

# 使用 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

Deinstallationsmethoden

Wenn Sie Pi Agent deinstallieren, verwenden Sie denselben Paketmanager, den Sie für die Installation verwendet haben:

# 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

Durch die Deinstallation von Pi Agent werden Ihre Konfiguration, Anmeldeinformationen oder Sitzungsaufzeichnungen nicht gelöscht. Diese Daten werden im Verzeichnis~/.pi/agent/gespeichert. Um sie vollständig zu entfernen, können Sie dieses Verzeichnis manuell löschen.


Terminal-Empfehlungen

Pi Agent verwendet 24-Bit-RGB-Farben, um die Terminal-Oberfläche darzustellen. Für die beste Erfahrung werden die folgenden Terminals empfohlen:

PlattformEmpfohlenes TerminalBeschreibung
macOSiTerm2、Kitty、WarpNative True-Color-Unterstützung mit guter Anzeige eingebetteter Bilder
WindowsWindows Terminal、WezTermWindows Terminal ist das offiziell empfohlene moderne Terminal
LinuxKitty、WezTerm、AlacrittyBeide unterstützen True Color und GPU-Beschleunigung

Weitere Terminal-Tools finden Sie unter:https://www.example.com/w3cnote/terminal-tools.html

Prüfen Sie, ob Ihr Terminal True Color unterstützt:

$ echo $COLORTERM
truecolor

Wenn die Ausgabetruecoloroder24bitist, unterstützt Ihr Terminal die vollständige Farbdarstellung.


Erster Start

Wechseln Sie nach der Installation in ein Projektverzeichnis und starten Sie Pi Agent:

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

Beim ersten Start sehen Sie den Willkommensbildschirm von Pi Agent.

Zu diesem Zeitpunkt wurde noch kein KI-Anbieter konfiguriert. Sie müssen zuerst die Authentifizierung abschließen—dies wird im nächsten Kapitel ausführlich erläutert.

Wenn Pi Agent startet, verwendet es das aktuelle Arbeitsverzeichnis (cwd) als Projektstamm. Es verfügt über Lese- und Schreibberechtigungen für Dateien in diesem Verzeichnis. Es wird empfohlen, es unter Git-Versionskontrolle zu verwenden, damit Änderungen leicht rückgängig gemacht werden können.


Pi Agent aktualisieren

Halten Sie Pi Agent auf dem neuesten Stand:

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

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

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

Die Verwendung von--self --forceerzwingt eine Neuinstallation von Pi Agent, selbst wenn bereits die neueste Version installiert ist:

$ pi update --self --force

Beachten Sie, dass von Installationsskripten wie install.sh verwaltete Installationen--force nicht unterstützen。

Wenn eine solche verwaltete Installation repariert werden muss, führen Sie einfach das Installationsskript erneut aus.

Andere Erweiterungen