ДокументацияPi

Pi

Pi — минимальный расширяемый AI-агент для терминала: он проверяет файлы, запускает команды, правит контент и ведёт многошаговые задачи. Pi подключается к AI Chaos как совместимый endpoint в models.json — OpenAI-совместимый wire, оплата в Sparks.

Шаг 1. Установка

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

# или инсталлятором (macOS, Linux)
curl -fsSL https://pi.dev/install.sh | sh

Проверка: pi --version. Нужен Node.js 22.19+.

Windows: Pi требует bash-оболочку. Для большинства случаев достаточно установкиGit for Windows

Шаг 2. Папка конфигурации

# macOS / Linux
mkdir -p ~/.pi/agent

# Windows PowerShell
New-Item -ItemType Directory -Force "$HOME/.pi/agent"

На Windows папка обычно находится по пути C:\Users\ВАШЕ_ИМЯ\.pi\agent\.

Шаг 3. Подключение AI Chaos

Добавьте AI Chaos как совместимый endpoint в ~/.pi/agent/models.json:

{
  "providers": {
    "aichaos": {
      "baseUrl": "https://aichaos.ru/v1",
      "api": "openai-completions",
      "apiKey": "$AICHAOS_API_KEY",
      "models": [
        { "id": "chat-model" }
      ]
    }
  }
}

Замените chat-model на код модели изкаталога . Значения apiKey поддерживают интерполяцию $NAME / ${NAME} из переменных окружения, литеральное значение или !команда.

Шаг 4. Ключ API

Экспортируйте ключ в профиле оболочки — интерполяция из шага 3 читает его оттуда:

export AICHAOS_API_KEY="chaos-u-..."

Альтернатива: литеральное значение в apiKey в models.json — но не коммитьте этот файл в публичный репозиторий.

Шаг 5. AI Chaos как провайдер по умолчанию

В ~/.pi/agent/settings.json задайте провайдера и модель для старта:

{
  "defaultProvider": "aichaos",
  "defaultModel": "chat-model"
}

defaultModel должен совпадать с id модели из models.json. Можно задать уровень рассуждений для старта: "defaultThinkingLevel": "medium" (off … max).

Шаг 6. Запуск

cd /path/to/your/project
pi

Проверьте выбор модели через /model — модель AI Chaos должна быть в списке, а запросы появятся в панели активности AI Chaos. Если их нет, проверьте baseUrl и имя провайдера.

Полезные горячие клавиши

ДействиеУправление
Сменить модельCtrl+L или /model
Циклический выбор моделейCtrl+P
Уровень рассужденийShift+Tab
Продолжить последнюю сессиюpi -c
Обзор старых сессийpi -r

Устранение неполадок

  • Модель не появляется в /model. Откройте /model ещё раз — Pi перечитывает models.json при открытии; проверьте синтаксис JSON и совпадение defaultProvider с ключом провайдера.
  • 401 / Missing auth. Проверьте, что AICHAOS_API_KEY задана до запуска Pi, а ключ действует и имеет положительный баланс.
  • Model not found. Сверьте точный код модели вкаталоге моделей с id в models.json.

См. также