Назад к каталогу гайдов
Terminal Agent

Настройка Pi

Минималистичный терминальный агент (pi.dev). SacredGPT подключается через ~/.pi/agent/models.json.

Base URL: https://api.sacredgpt.ru/v1Key: $SACREDGPT_KEYПроверено

01 — Версия и UI

Версионность и расположение настроек

Замечание по версиям: Проверено на Pi v0.83.0+ (~/.pi/agent/models.json, api: openai-completions).

02 — Инструкция

Пошаговая настройка

1

1. Установите Pi

Поставьте @earendil-works/pi-coding-agent и создайте live-ключ в SacredGPT.

1. Установите Pi
npm i -g @earendil-works/pi-coding-agent@latest
pi --version
2

2. Добавьте SacredGPT в models.json

~/.pi/agent/models.json

Создайте или отредактируйте ~/.pi/agent/models.json: baseUrl SacredGPT, api openai-completions, ваш ключ и список моделей.

2. Добавьте SacredGPT в models.json
3

3. Выберите модель и работайте

Запустите pi, выберите sacredgpt/gpt-5.6-sol (или другую модель) и дайте задачу.

3. Выберите модель и работайте
pi --model sacredgpt/gpt-5.6-sol

03 — Конфигурация

Пример файла конфигурации

{
  "providers": {
    "sacredgpt": {
      "baseUrl": "https://api.sacredgpt.ru/v1",
      "api": "openai-completions",
      "apiKey": "sgpt_live_9a8b7c6d5e4f3a2b1c0d",
      "models": [
        {
          "id": "gpt-5.6-sol",
          "name": "GPT 5.6 Sol",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 200000,
          "maxTokens": 16384
        },
        {
          "id": "claude-sonnet-5",
          "name": "Claude Sonnet 5",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 200000,
          "maxTokens": 16384
        },
        {
          "id": "minimax-m3",
          "name": "MiniMax M3",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 1000000,
          "maxTokens": 16384
        }
      ]
    }
  }
}

04 — Решение проблем

Частые вопросы и ошибки

Модель видна в --list-models, но запросы висят

Проверьте baseUrl именно с /v1 и api: openai-completions. Обновите Pi до 0.83.0+.

Модели unavailable

Ключ должен быть в models.json, в auth.json или через --api-key. Без ключа модели грузятся, но недоступны.