Hermes Agent
Подключите Hermes Agent к GonkaGate через официальный установщик hermes-agent-setup.
Подключите уже установленный hermes-agent к GonkaGate через официальный установщик.
Helper настраивает Hermes на provider: custom и OpenAI-compatible endpoint GonkaGate https://api.gonkagate.com/v1.
Быстрая настройка через официальный установщик
Запустите установщик в интерактивном терминале:
npx @gonkagate/hermes-agent-setupЕсли вы используете именованный профиль Hermes, передайте его явно:
npx @gonkagate/hermes-agent-setup --profile workИнструмент настраивает уже установленный локально Hermes Agent. Он не устанавливает сам Hermes и не заменяет hermes setup.
Используйте этот путь, если хотите поддерживаемую настройку GonkaGate без ручной правки Hermes-файлов:
- запрашивает GonkaGate key через скрытый prompt в терминале
- резолвит активный Hermes config, включая
--profile <name> - проверяет
GET /v1/modelsдо записи файлов - предлагает только live-модели, у которых есть checked-in launch qualification artifacts
- создает backup в рамках текущего запуска и откатывает
config.yaml, если последующая запись.envне удалась
Перед началом
hermes-agentустановлен и доступен вPATHкакhermes.- Hermes Agent версии
v2026.5.16/v0.14.0или новее. - Node
>=22.14.0доступен дляnpxinstaller. - У вас уже есть API-ключ GonkaGate в формате
gp-.... - Вы можете запускать helper в интерактивном TTY.
- Платформа: Linux, macOS или WSL2.
Public onboarding не позиционируется для пользователей или организаций из США и территорий США.
Что меняет установщик
Helper управляет этими Hermes-файлами:
~/.hermes/config.yaml~/.hermes/.env
Он записывает только GonkaGate-managed поверхность:
model.provider = custommodel.base_url = https://api.gonkagate.com/v1model.default = <selected qualified GonkaGate model>OPENAI_API_KEY = <your GonkaGate API key>
Ключ GonkaGate хранится только в resolved Hermes .env. Он не записывается в config.yaml и не должен попадать в репозиторий.
Проверка после настройки
После успешного завершения helper запустите Hermes в том же resolved context:
hermesПеред длинной coding-сессией отправьте один короткий prompt, например:
Reply with exactly: Hermes Agent connected to GonkaGate
Проверка /v1/models внутри установщика подтверждает только auth и видимость каталога. Она не доказывает достаточность баланса, quota или полную runtime-готовность Hermes к первому billable request.
Частые первые проблемы
| Что видно | Что это обычно значит | Что сделать |
|---|---|---|
Hermes Agent не найден в PATH | Helper не может запустить hermes или определить активный config context | Установите Hermes Agent или исправьте PATH, затем повторите запуск |
Hermes ниже v2026.5.16 / v0.14.0 | Локальный Hermes contract старее поддерживаемого latest-only setup | Обновите Hermes Agent и повторите npx @gonkagate/hermes-agent-setup |
Node.js ниже 22.14.0 | Runtime для npx слишком старый для установщика | Обновите Node.js и повторите запуск helper |
| Нужен TTY | Helper не может показать скрытый prompt для API-ключа | Запустите команду в интерактивном терминале |
401 invalid_api_key или catalog/auth failure до записи файлов | Ключ gp-... отсутствует, неверен или не видит model catalog | Проверьте ключ, затем подтвердите его через GET /v1/models |
Conflict blockers упоминают providers, custom_providers или auth.json | Существующее состояние credential/provider в Hermes делает managed write неоднозначным | Разрешите конфликтующий Hermes-owned config вручную и повторите запуск |
| Первый Hermes prompt падает после setup | /v1/models доказал auth/catalog visibility, но не balance или first-request readiness | Проверьте баланс, quota и выбранную модель перед повтором |
Текущие ограничения
- Этот гайд настраивает уже установленный Hermes Agent. Он не устанавливает сам Hermes.
- Public helper поддерживает интерактивный flow и опциональный
--profile <name>. Он не предоставляет--yes,--json,--api-keyили--api-key-stdin. - Текущая цель — OpenAI-compatible
chat/completionsчерезhttps://api.gonkagate.com/v1. - Helper не принимает произвольные custom base URLs.
- Helper не меняет shell profiles, repository-local
.envfiles или credential pools вauth.json. - Native Windows production support пока не заявлен.
- Setup check не доказывает billing, quota или полную готовность первого запроса, кроме live
/v1/modelsauth и catalog visibility.
Официальные ссылки
- GonkaGate Hermes Agent installer
- Security notes установщика Hermes
- Implementation notes установщика Hermes
Связанные страницы
- Claude Code для поддерживаемого Anthropic-compatible пути
- Настройка Cursor для OpenAI-настроек Cursor
- Kilo Code для пути через официальный установщик Kilo Code
- Настройка OpenCode для пути через официальный установщик OpenCode
- Настройка OpenClaw для custom-provider пути
- Аутентификация и API-ключи для создания, хранения и ротации ключей
- Get Models для актуальных machine-readable model ID
