Goose

Goose — агент от Block: работает в терминале и десктопным приложением, правит файлы, запускает команды, подключает расширения и MCP-серверы. Ставится локально, ключ от модели свой.

Hubris подключается как пользовательский провайдер типа OpenAI Compatible — пересобирать Goose не нужно.

Требования

• Установленный Goose (CLI или десктоп)
• Аккаунт на hubris.pw и API-ключ

Подключение через десктоп

1. Откройте боковую панель → Settings → вкладка Models.
2. Нажмите Configure providers, затем Add Custom Provider внизу окна.
3. Заполните:

4. Нажмите Create Provider. Hubris появится в общем списке провайдеров и будет выбираться как любой другой.

Подключение через CLI

goose configure

В меню выберите Custom Providers → Add A Custom Provider. Мастер спросит по очереди: тип API (OpenAI Compatible), имя провайдера (Hubris), адрес (https://api.hubris.pw/v1), нужна ли аутентификация (да, Static API key — вставьте ключ), список моделей через запятую и поддержку стриминга (да).

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

Мастер сохраняет провайдера отдельным JSON-файлом в каталоге custom_providers — на Linux и macOS это ~/.config/goose/custom_providers/, на Windows %APPDATA%\Block\goose\config\custom_providers\ (точный путь к каталогу конфигурации показывает goose info). Такой файл можно написать руками и положить в репозиторий, чтобы у всей команды был один набор моделей:

{
  "name": "hubris",
  "engine": "openai_compatible",
  "display_name": "Hubris",
  "api_key_env": "HUBRIS_API_KEY",
  "base_url": "https://api.hubris.pw/v1",
  "models": [
    { "name": "anthropic/claude-sonnet-5", "context_limit": 1000000 },
    { "name": "google/gemini-3.7-flash", "context_limit": 1048576 }
  ],
  "supports_streaming": true
}

Ключ в файле не хранится: api_key_env — имя переменной окружения, из которой Goose его прочитает. Проверить подключение без интерфейса:

export HUBRIS_API_KEY=sk-gw-ваш-ключ
GOOSE_PROVIDER=hubris GOOSE_MODEL=google/gemini-3.7-flash \
  goose run -t "Ответь одним словом: ок" --no-session

Выбор моделей

Goose не подтягивает каталог сам: список моделей перечисляется при создании провайдера. ID берите из каталога — полностью, вместе с вендором и без даты в конце.

Каталог у нас открыт без ключа — список можно посмотреть прямо в браузере: api.hubris.pw/v1/models.

Почему пользовательский провайдер, а не встроенный

Мы предлагали Goose добавить Hubris во встроенный список, рядом с другими OpenAI-совместимыми шлюзами — issue #11884. Мейнтейнер ответил, что декларативной настройки достаточно, и закрыл заявку. Это осознанный ответ, а не молчание: пользовательский провайдер здесь — штатный путь, а не временный обход. Описанный выше способ и есть поддерживаемый.

Расходы

Агент делает несколько обращений к модели на одну задачу и каждый раз отправляет накопленный контекст проекта. Счёт растёт быстрее, чем в обычном чате.

• Заведите под Goose отдельный ключ с дневным лимитом.
• Разбор по запросам — в расходах.

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

Провайдер создан, но моделей в списке нет

Goose показывает только те модели, которые перечислены в поле Available Models (в файле — массив models). Добавьте нужные ID туда — сам каталог он не запрашивает.

Ошибка про модель

ID должен совпадать с каталожным символ в символ, вместе с вендором перед косой чертой. Короткие имена без вендора и имена с датой на конце мы не принимаем.

Ошибка авторизации

Ключ неверный или отозван. Он начинается на sk-gw-, без пробелов по краям; целиком виден только при создании. Новый — в разделе «Ключи».

Ошибка про недостаточный баланс

Пополните баланс в кабинете — от 300 ₽, через СБП, банковской картой или по счёту для юридических лиц.

Что дальше

• Каталог моделей — ID для поля Available Models.
• Управление ключами — отдельный ключ с лимитом.
• Расходы — детализация по запросам и моделям.
• Chat Completions — что именно уходит в Hubris из Goose.

Обновлено: 9 сентября 2026 г.