Установка Pi Agent

В этой главе объясняется, как установить Pi Agent на разных платформах и выполнить базовую настройку окружения.

Требования к окружению

Перед установкой Pi Agent убедитесь, что ваша система соответствует следующим требованиям:

Зависимость	Минимальная версия	Описание
Node.js	Рекомендуется 18 LTS или выше	Pi Agent работает на Node.js и требует среды выполнения, поддерживающей современные возможности JavaScript
npm	Поставляется вместе с Node.js	Используется для установки Pi Agent и пакетов расширений
Терминал	Поддержка True Color	Рекомендуется: iTerm2 (macOS), Windows Terminal, Kitty, WezTerm

Проверьте, установлен ли Node.js:

node --version

Вывод, похожий на:

v20.11.0

Проверьте, установлен ли npm вместе с ним (он поставляется с Node.js):

npm --version

Вывод, похожий на:

10.2.4

Если ваша версия Node.js ниже 18, сначала обновите её. Вы можете использовать nvm (Node Version Manager) для управления несколькими версиями Node.js.

Установка

Способ 1: Глобальная установка через npm

Это самый распространённый и простой способ установки, подходящий для macOS, Linux и Windows:

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

Проверьте версию после установки:

pi --version

После установки командуpiможно использовать прямо в терминале.

Способ 2: Скрипт в один клик через curl

В Linux или macOS также можно использовать официальный установочный скрипт:

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

Этот скрипт автоматически определяет вашу систему и завершает установку. По сути, он также устанавливает глобально через npm.

Способ 3: Другие менеджеры пакетов

Если вы используете pnpm, Yarn или Bun, вы также можете установить с помощью соответствующей команды:

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

Способы удаления

При удалении Pi Agent используйте тот же менеджер пакетов, который вы использовали для установки:

# 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

Удаление Pi Agent не удалит вашу конфигурацию, учётные данные или записи сеансов. Эти данные хранятся в~/.pi/agent/каталоге. Чтобы полностью удалить их, можно вручную удалить этот каталог.

Платформа	Рекомендуемый терминал	Описание
macOS	iTerm2, Kitty, Warp	Нативная поддержка True Color с хорошим отображением встроенных изображений
Windows	Windows Terminal, WezTerm	Windows Terminal — официально рекомендуемый современный терминал
Linux	Kitty, WezTerm, Alacritty	Оба поддерживают True Color и GPU-ускорение

Первый запуск

После установки перейдите в каталог проекта и запустите Pi Agent:

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

При первом запуске вы увидите приветственный экран Pi Agent.

На данный момент ни один поставщик ИИ ещё не настроен. Сначала нужно пройти аутентификацию — это будет подробно объяснено в следующей главе.

При запуске Pi Agent использует текущий рабочий каталог (cwd) в качестве корня проекта. У него есть права на чтение и запись файлов в этом каталоге. Рекомендуется использовать его под контролем версий git, чтобы изменения можно было легко откатить.

Обновление Pi Agent

Обновляйте Pi Agent до последней версии:

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

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

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

Использование--self --forceпринудительно переустанавливает Pi Agent, даже если у вас уже последняя версия:

$ pi update --self --force

Обратите внимание, что установки, управляемые скриптами установки, такими как install.sh, не поддерживают--force。

Когда такую управляемую установку нужно восстановить, просто запустите скрипт установки снова.

Другие расширения

Избранное в справочнике