pi: подключение кастомного провайдера — инструкция

Что такое pi

pi — минималистичный кодинг-агент для терминала, который полностью ваш: open-source, расширяется пакетами, поддерживает кастомных провайдеров. С ключом LLMost агент работает на любой модели каталога.

Требования

Терминал (macOS, Linux или Windows)
Аккаунт LLMost с API-ключом

Установка

Официальный установщик:

curl -fsSL https://pi.dev/install.sh | sh

Альтернатива через npm:

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

Подключение LLMost

Создайте ключ на странице Ключи API (формат llmost_...) и добавьте его в переменную окружения:
```
export LLMOST_API_KEY="llmost_..."
```
Чтобы ключ не пропадал, добавьте эту строку в ~/.zshrc или ~/.bashrc.

Опишите LLMost в файле ~/.pi/agent/models.json:

{
  "providers": {
    "llmost": {
      "baseUrl": "https://llmost.ru/api/v1",
      "api": "openai-completions",
      "apiKey": "LLMOST_API_KEY",
      "models": [
        {
          "id": "~anthropic/claude-sonnet-latest",
          "name": "Claude Sonnet (LLMost)",
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 65536
        },
        {
          "id": "deepseek/deepseek-v3.2-20251201",
          "name": "DeepSeek V3.2 (LLMost)",
          "input": ["text"],
          "contextWindow": 163840,
          "maxTokens": 8192
        }
      ]
    }
  }
}

Обратите внимание: apiKey — это имя переменной окружения, а не сам ключ. Так ключ не попадает в конфиг.

Запустите pi и выберите модель LLMost в списке моделей.

Выбор модели

В списке появляются только модели, описанные в models.json. Для агентной работы модель должна поддерживать tool calling:

~anthropic/claude-sonnet-latest — лучший выбор для агентного кодинга;
~openai/gpt-latest — универсальная флагманская альтернатива;
deepseek/deepseek-v3.2-20251201 — бюджетный вариант.

Значения contextWindow и maxTokens берите со страницы модели в каталоге LLMost.

Проверка

Запустите pi в каталоге любого проекта и дайте простую задачу:

pi "Создай файл hello.txt с текстом Привет"

Агент создаст файл — значит, всё работает.

Чтобы проверить endpoint в обход pi, выполните запрос напрямую:

curl https://llmost.ru/api/v1/chat/completions \
  -H "Authorization: Bearer llmost_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "~google/gemini-flash-latest",
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

Частые проблемы

Моделей LLMost нет в списке. Проверьте ~/.pi/agent/models.json на синтаксические ошибки (валидный JSON) и путь к файлу.

Ошибка авторизации (401). В поле apiKey должно стоять имя переменной (LLMOST_API_KEY), а сама переменная — задана в окружении. Выполните echo $LLMOST_API_KEY, чтобы проверить.

Ошибка 402 «Недостаточно средств». Пополните баланс LLMost в личном кабинете.

Ошибки совместимости с отдельными параметрами. У pi есть флаги compat для провайдеров с неполной совместимостью (supportsDeveloperRole, supportsReasoningEffort и другие) — если сервер возвращает ошибку на специфичный параметр, выставьте соответствующий флаг в false в описании провайдера.

Ссылки

Официальный сайт: pi.dev
GitHub: badlogic/pi-mono
Другие приложения — в каталоге ИИ-агентов

pi + LLMost: установка и настройка