Gonka x Hermes Agent

GonkaGate x Агент Гермеса

Настройте локальный агент Hermes для использования GonkaGate:

npx @gonkagate/hermes-agent-setup

Если вы используете агент Hermes и у вас есть ключ API GonkaGate, это должен быть короткий шаг настройки, а не ручное редактирование ~/.hermes/config.yaml и ~/.hermes/.env .

Утилита настраивает Hermes через поддерживаемого поставщика: собственный путь, сохраняет необработанный ключ в .env Hermes и предлагает только модели, которые работают на GonkaGate и подходят для запуска Hermes.

Требования

Гермес-агент установлен

Агент Гермес v2026.5.16/v0.14.0 или новее

Node.js >=22.14.0

ключ API GonkaGate

интерактивный терминал

Linux, macOS или WSL2

Публичная регистрация соответствует текущим правилам доступности Условий GonkaGate. Он не предназначен для пользователей или организаций в Соединенных Штатах Америки или на территориях США.

Беги

Интерактивная настройка по умолчанию:

npx @gonkagate/hermes-agent-setup

Конкретный профиль Гермеса:

npx @gonkagate/hermes-agent-setup --profile работа

После настройки:

Гермес

Дополнительный тест на дым по реальному запросу:

чат гермеса -Q --max-turns 1 -q " Не использовать инструменты. Точный ответ: дымовой тест GonkaGate в порядке»

Утилита печатает дымовой тест в конце, но не запускает его автоматически. Он отправляет один реальный запрос модели.

Что пишет

Утилита разрешает активные пути конфигурации Hermes с самим Hermes. С --profile используются пути, специфичные для профиля.

Он пишет:

~/.hermes/config.yaml

~/.hermes/.env

Форма управляемой конфигурации:

модель: поставщик: пользовательский base_url: https://api.gonkagate.com/v1 по умолчанию: <selected-model> api_key: ${GONKAGATE_API_KEY}

Необработанный ключ хранится в .env:

GONKAGATE_API_KEY = gp-...

Необработанный ключ не записывается в config.yaml. Утилита также позволяет избежать несвязанного использования OPENAI_API_KEY.

Что происходит во время установки

• Проверьте Node, поддержку терминала, поддержку ОС, доступность Hermes и версию Hermes.

• Разрешите активные пути config.yaml и .env.

• Прочтите существующие файлы config.yaml, .env, auth.json и состояние задания Hermes.

• Остановить конфликты утилита не должна перезаписывать.

• Попросите ключ GonkaGate через скрытую подсказку.

• Получите GET https://api.gonkagate.com/v1/models.

• Ознакомьтесь с действующим каталогом проверенных квалификационных артефактов Hermes.

• Позвольте пользователю выбрать квалифицированную действующую модель.

• Показать запланированные изменения файла.

• Создайте резервную копию файлов, напишите config.yaml, затем напишите .env.

• Откатите файл config.yaml, если запись в .env не удалась.

Утилита не принимает простой флаг --api-key, поэтому ключ не попадает в историю оболочки или списки процессов.

Выбор модели

Модели угадываются не только по живому каталогу. Модель должна быть:

присутствует в GonkaGate /v1/models

зарегистрирован как сертифицированный для запуска агента Гермеса

Текущий белый список:

Moonshotai/kimi-k2.6 (рекомендуется по умолчанию)

минимаксай/минимакс-м2.7

qwen/qwen3-235b-a22b-instruct-2507-fp8

Модели, работающие только в реальном времени, игнорируются. Модели, содержащие только артефакты, которые больше не используются, также игнорируются.

Что доказывает /v1/models

Запрос на установку подтверждает:

ключ аутентифицирует

GonkaGate возвращает каталог моделей

Это не доказывает:

платежный баланс

квота

готовность первого оплачиваемого запроса Hermes

Используйте дополнительный дымовой тест чата Hermes, если вам нужно подтверждение во время выполнения.

Текущий контракт

пакет: @gonkagate/hermes-agent-setup

команда: npx @gonkagate/hermes-agent-setup

установленный bin: hermes-agent-setup

Путь поставщика: поставщик: пользовательский

базовый URL: https://api.gonkagate.com/v1

• управляемые ключи конфигурации: model.provider, model.base_url, model.default, model.api_key.

управляемый секретный ключ: GONKAGATE_API_KEY

Нецели

Это не обычный установщик Hermes. Это не так:

заменить установку Гермеса выше по потоку

поддержка версий Hermes старше v2026.5.16/v0.14.0

принимать произвольные пользовательские базовые URL-адреса

• перенести устаревшие настройки конечной точки, такие как OPENAI_BASE_URL, LLM_MODEL, поставщик корневого уровня / base_url или устаревшие custom_providers.

редактировать профили оболочки

писать напрямую в пулы учетных данных auth.json

генерировать локальные файлы .env репозитория

требовать встроенной поддержки запуска Windows

• утверждать, что /v1/models подтверждает готовность к выставлению счетов, квотам или первому запросу.

Ссылки

Репозиторий (https://github.com/GonkaGate/hermes-agent-setup)

пакет npm (https://www.npmjs.com/package/@gonkagate/hermes-agent-setup)

Проблемы и отзывы (https://github.com/GonkaGate/hermes-agent-setup/issues)

README (https://github.com/GonkaGate/hermes-agent-setup/blob/main/README.md)

Как это работает (https://github.com/GonkaGate/hermes-agent-setup/blob/main/docs/how-it-works.md)

Примечания по безопасности (https://github.com/GonkaGate/hermes-agent-setup/blob/main/docs/security.md)

• Артефакты квалификации запуска (https://github.com/GonkaGate/hermes-agent-setup/tree/main/docs/launch-qualification/hermes-agent-setup)

Руководство агента GonkaGate Hermes (https://gonkagate.com/en/docs/guides/coding-agents/hermes-agent)

Документация GonkaGate (https://gonkagate.com/en/docs)