Hermes Agent

Настройка терминального агента Hermes для моделей Guard API.

Протокол модели

Claude, Kimi, Composer и Grok

Hermes Agent это терминальный агент Nous Research. Стороннему адресу его документация ставит одно требование: сервер обслуживает POST /v1/chat/completions. Guard отдаёт такой адрес всем семействам; для Claude, Kimi, Composer и Grok настройка ниже одна, меняется только точный id модели.

bash

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

На Windows тот же установщик запускается из PowerShell: iex (irm https://hermes-agent.nousresearch.com/install.ps1).

Настройки лежат в ~/.hermes/config.yaml, ключи в ~/.hermes/.env. Быстрый путь: команда hermes model, пункт Custom endpoint, дальше вопросы про адрес, ключ и имя модели. То же самое руками:

yaml

# ~/.hermes/config.yaml
model:
  provider: custom
  base_url: https://api.guardrelay.ai/v1
  api_key: gd-ваш-ключ-из-бота
  default: claude-sonnet-5

yaml

# ~/.hermes/config.yaml
model:
  provider: custom
  base_url: https://api.guardrelay.ai/v1
  api_key: gd-ваш-ключ-из-бота
  default: k3

yaml

# ~/.hermes/config.yaml
model:
  provider: custom
  base_url: https://api.guardrelay.ai/v1
  api_key: gd-ваш-ключ-из-бота
  default: cursor-grok-4.7-high
  context_length: 256000

model_overrides:
  custom:
    cursor-grok-4.7-low:
      supports_reasoning: false
    cursor-grok-4.7-low-fast:
      supports_reasoning: false
    cursor-grok-4.7-medium:
      supports_reasoning: false
    cursor-grok-4.7-medium-fast:
      supports_reasoning: false
    cursor-grok-4.7-high:
      supports_reasoning: false
    cursor-grok-4.7-high-fast:
      supports_reasoning: false
    cursor-grok-4.7-xhigh:
      supports_reasoning: false
    cursor-grok-4.7-xhigh-fast:
      supports_reasoning: false

yaml

# ~/.hermes/config.yaml
model:
  provider: custom
  base_url: https://api.guardrelay.ai/v1
  api_key: gd-ваш-ключ-из-бота
  default: composer-2.5

Адрес пишется ровно с /v1 на конце. Hermes версию сам не дописывает: в его примерах для OpenAI-совместимых адресов /v1 стоит прямо в значении base_url.

Несколько адресов держат в разделе providers: того же файла. У записи есть поля api (базовый адрес), key_env либо api_key, transport, default_model и context_length. Для Guard берите transport: chat_completions.

yaml

# ~/.hermes/config.yaml
providers:
  guard:
    api: https://api.guardrelay.ai/v1
    key_env: GUARD_API_KEY
    transport: chat_completions

Модель после этого переключается прямо в сессии: /model custom:guard:<точный id>. Если именованных провайдеров нет, работает короткая форма /model custom:<точный id>.

GLM 5.3 в Hermes Agent

Установите Hermes

Используйте официальную инструкцию Hermes. На macOS/Linux/WSL2 — первый блок, на Windows PowerShell — второй.

bash

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
hermes --version

powershell

iex (irm https://hermes-agent.nousresearch.com/install.ps1)
hermes --version

Получите ключ Guard

Получите универсальный ключ gd-… по прямой ссылке на API в @guardapi и выберите API-пакет. Не вставляйте ключ в проект, репозиторий, текст задания или скриншот. Баланс и расход видны в личном кабинете.

Создайте отдельный профиль GLM

Создайте ~/.hermes-guard-glm/config.yaml (Windows: %USERPROFILE%\.hermes-guard-glm\config.yaml) и сохраните туда пример ниже. HERMES_HOME подключит его только к запуску GLM.
Создайте рядом .env со строкой GUARD_GLM_API_KEY=gd-ваш-ключ; не пересылайте этот файл и не меняйте обычный профиль .hermes.
Используйте provider: custom, api_mode: codex_responses и адрес без конечного /responses.

dotenv

# ~/.hermes-guard-glm/.env
GUARD_GLM_API_KEY=gd-ваш-ключ

yaml

_config_version: 45
model:
  provider: custom
  name: glm-5.3
providers:
  custom:
    name: Guard GLM
    base_url: https://api.guardrelay.ai/glm/v1
    key_env: GUARD_GLM_API_KEY
    api_mode: codex_responses
    default_model: glm-5.3
    discover_models: false
    models:
      glm-5.3: {}
      glm-5.3-flash: {}
agent:
  reasoning_effort: none

Проверьте и продолжите

macOS / Linux:

export HERMES_HOME="$HOME/.hermes-guard-glm"
hermes config check
hermes --provider custom --model glm-5.3 --reasoning none
# После выхода продолжить последний сеанс:
hermes --continue

Windows PowerShell:

powershell

$env:HERMES_HOME = Join-Path $env:USERPROFILE ".hermes-guard-glm"
hermes config check
hermes --provider custom --model glm-5.3 --reasoning none
# Continue the last session after exit:
hermes --continue

После config check запустите Hermes в отдельной тестовой папке.
Отправьте Ответь ровно GLM_OK и запомни слово СОСНА.
В том же окне спросите запомненное слово; после выхода вернитесь через hermes --continue.

Модели и подтверждённые возможности

Model ID	Что использовать
`glm-5.3`	Основная модель; текст и задачи с кодом.
`glm-5.3-flash`	Быстрая модель; на уровне API принимает PNG и PDF во всех трёх протоколах, MP4 — только в Chat Completions.

Работают Responses, терминальные инструменты и продолжение последней Hermes-сессии.
Инструменты чтения, правки и терминала исполняет сам клиент. Этот профиль не подключает инструменты или MCP Z.AI автоматически.
Проверка этой версии была текстовой и не подтверждает её кнопку вложений. Возможности Flash на уровне API не означают, что конкретный интерфейс умеет передать файл.
Профиль использует Custom OpenAI Responses (codex_responses). Серверный промпт GLM для обычного API выключен по умолчанию; настройка клиента сама его не включает.
Native TXT, DOCX и XLSX не входят в подтверждённый GLM-контракт. Для документов используйте PDF; для изображений — PNG и модель glm-5.3-flash.

Если подключение не получилось

Признак	Что проверить
`401 invalid_api_key`	Клиент получил полный действующий ключ `gd-…`; переменная задана в том же процессе, где запущен клиент.
`404 model_not_found`	Model ID равен ровно `glm-5.3` или `glm-5.3-flash`; старые GLM ID, aliases, Turbo и FlashX не поддерживаются.
`404` или неверный путь	Base URL равен `https://api.guardrelay.ai/glm/v1`. Клиент сам добавляет `/responses`; не дописывайте его второй раз.
`400 invalid_request`	Выбран указанный в инструкции API format; из старого профиля не перенесены reasoning, temperature, MCP или другие непроверенные поля.
`402 insufficient_balance`	Проверьте доступный баланс и незавершённые резервы в личном кабинете.
`/model` не видит GLM	Проверьте `model.provider: custom`, `providers.custom.models`, `discover_models: false` и перезапустите Hermes.
Hermes просит другую авторизацию	Не выбирайте встроенный `openai-codex`; используйте custom provider и `key_env`.

Gemini в Hermes Agent

Установите Hermes

Используйте официальную инструкцию Hermes. На macOS/Linux/WSL2 — первый блок, на Windows PowerShell — второй.

bash

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
hermes --version

powershell

iex (irm https://hermes-agent.nousresearch.com/install.ps1)
hermes --version

Получите ключ Guard

Создайте отдельный профиль Gemini

Создайте ~/.hermes-guard-gemini/config.yaml (Windows: %USERPROFILE%\.hermes-guard-gemini\config.yaml) и сохраните туда пример ниже. HERMES_HOME подключит его только к запуску Gemini.
Создайте рядом .env со строкой GUARD_GEMINI_API_KEY=gd-ваш-ключ; не пересылайте этот файл и не меняйте обычный профиль .hermes.
Используйте provider: custom, api_mode: codex_responses и адрес без конечного /responses.

dotenv

# ~/.hermes-guard-gemini/.env
GUARD_GEMINI_API_KEY=gd-ваш-ключ

yaml

_config_version: 45
model:
  provider: custom
  name: gemini-4-argon
providers:
  custom:
    name: Guard Gemini
    base_url: https://api.guardrelay.ai/v1
    key_env: GUARD_GEMINI_API_KEY
    api_mode: codex_responses
    default_model: gemini-4-argon
    discover_models: false
    models:
      gemini-4-argon: {}
      gemini-3.8-flash: {}

Проверьте и продолжите

macOS / Linux:

export HERMES_HOME="$HOME/.hermes-guard-gemini"
hermes config check
hermes --provider custom --model gemini-4-argon
# После выхода продолжить последний сеанс:
hermes --continue

Windows PowerShell:

powershell

$env:HERMES_HOME = Join-Path $env:USERPROFILE ".hermes-guard-gemini"
hermes config check
hermes --provider custom --model gemini-4-argon
# Continue the last session after exit:
hermes --continue

После config check запустите Hermes в отдельной тестовой папке.
Отправьте Ответь ровно GUARD_GEMINI_OK и запомни слово СОСНА.
В том же окне спросите запомненное слово; после выхода вернитесь через hermes --continue.

Модели и возможности Gemini

Model ID	Вход и окно
`gemini-4-argon`	Текст, изображения, PDF; окно 1 048 576 токенов, общее на вход и ответ.
`gemini-3.8-flash`	Текст, изображения, PDF; окно 1 048 576 токенов на вход.

Терминальные инструменты исполняет сам Hermes; hermes --continue продолжает последнюю сессию.
Вход в каталоге Guard: текст, изображения и PDF; ответ приходит текстом. Как передать файл или картинку, зависит от интерфейса клиента; эта инструкция вложения не описывает.
Профиль использует Custom OpenAI Responses (codex_responses). Серверный промпт — отдельная настройка семейства Gemini: он применяется, только если у ключа есть право и включена опция; настройка клиента сама его не включает.

Если подключение не получилось

Признак	Что проверить
`401 invalid_api_key`	Клиент получил полный действующий ключ `gd-…`; переменная задана в том же процессе, где запущен клиент.
`404 model_not_found`	Model ID — точный ID из таблицы выше или короткое имя `gemini`; другие написания не поддерживаются.
`404` или неверный путь	Base URL равен `https://api.guardrelay.ai/v1`. Клиент сам добавляет `/responses`; не дописывайте его второй раз.
`400 invalid_request`	Выбран указанный в инструкции формат API; из старого профиля не перенесены лишние настройки: размышления, temperature, MCP и другие.
`402 insufficient_credit`	Проверьте доступный баланс и незавершённые резервы в личном кабинете.
`/model` не видит Gemini	Проверьте `model.provider: custom`, `providers.custom.models`, `discover_models: false` и перезапустите Hermes.
Hermes просит другую авторизацию	Не выбирайте встроенный `openai-codex`; используйте custom provider и `key_env`.

Muse в Hermes Agent

Установите Hermes

Используйте официальную инструкцию Hermes. На macOS/Linux/WSL2 — первый блок, на Windows PowerShell — второй.

bash

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
hermes --version

powershell

iex (irm https://hermes-agent.nousresearch.com/install.ps1)
hermes --version

Получите ключ Guard

Создайте отдельный профиль Muse

Создайте ~/.hermes-guard-muse/config.yaml (Windows: %USERPROFILE%\.hermes-guard-muse\config.yaml) и сохраните туда пример ниже. HERMES_HOME подключит его только к запуску Muse.
Создайте рядом .env со строкой GUARD_MUSE_API_KEY=gd-ваш-ключ; не пересылайте этот файл и не меняйте обычный профиль .hermes.
Используйте provider: custom, api_mode: codex_responses и адрес без конечного /responses.

dotenv

# ~/.hermes-guard-muse/.env
GUARD_MUSE_API_KEY=gd-ваш-ключ

yaml

_config_version: 45
model:
  provider: custom
  name: muse-wonder-1.0
providers:
  custom:
    name: Guard Muse
    base_url: https://api.guardrelay.ai/v1
    key_env: GUARD_MUSE_API_KEY
    api_mode: codex_responses
    default_model: muse-wonder-1.0
    discover_models: false
    models:
      muse-wonder-1.0: {}
      muse-spark-1.3: {}
      muse-spark-1.2: {}

Проверьте и продолжите

macOS / Linux:

export HERMES_HOME="$HOME/.hermes-guard-muse"
hermes config check
hermes --provider custom --model muse-wonder-1.0
# После выхода продолжить последний сеанс:
hermes --continue

Windows PowerShell:

powershell

$env:HERMES_HOME = Join-Path $env:USERPROFILE ".hermes-guard-muse"
hermes config check
hermes --provider custom --model muse-wonder-1.0
# Continue the last session after exit:
hermes --continue

После config check запустите Hermes в отдельной тестовой папке.
Отправьте Ответь ровно GUARD_MUSE_OK и запомни слово СОСНА.
В том же окне спросите запомненное слово; после выхода вернитесь через hermes --continue.

Модели и возможности Muse

Model ID	Вход и окно
`muse-wonder-1.0`	Текст, изображения, PDF; окно 1 048 576 токенов.
`muse-spark-1.3`	Текст, изображения, PDF; окно 1 048 576 токенов.
`muse-spark-1.2`	Текст, изображения, PDF; окно 1 048 576 токенов.

Терминальные инструменты исполняет сам Hermes; hermes --continue продолжает последнюю сессию.
Вход в каталоге Guard: текст, изображения и PDF; ответ приходит текстом. Как передать файл или картинку, зависит от интерфейса клиента; эта инструкция вложения не описывает.
Профиль использует Custom OpenAI Responses (codex_responses). Серверный промпт — отдельная настройка семейства Muse: он применяется, только если у ключа есть право и включена опция; настройка клиента сама его не включает.

Если подключение не получилось

Признак	Что проверить
`401 invalid_api_key`	Клиент получил полный действующий ключ `gd-…`; переменная задана в том же процессе, где запущен клиент.
`404 model_not_found`	Model ID — точный ID из таблицы выше или короткое имя `muse`; другие написания не поддерживаются.
`404` или неверный путь	Base URL равен `https://api.guardrelay.ai/v1`. Клиент сам добавляет `/responses`; не дописывайте его второй раз.
`400 invalid_request`	Выбран указанный в инструкции формат API; из старого профиля не перенесены лишние настройки: размышления, temperature, MCP и другие.
`402 insufficient_credit`	Проверьте доступный баланс и незавершённые резервы в личном кабинете.
`/model` не видит Muse	Проверьте `model.provider: custom`, `providers.custom.models`, `discover_models: false` и перезапустите Hermes.
Hermes просит другую авторизацию	Не выбирайте встроенный `openai-codex`; используйте custom provider и `key_env`.

Установите Hermes Agent

Установите CLI по официальной инструкции Hermes. На macOS/Linux/WSL2 — первая команда; на Windows PowerShell — вторая. Откройте новый терминал и проверьте hermes --version.

bash

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
hermes --version

powershell

iex (irm https://hermes-agent.nousresearch.com/install.ps1)
hermes --version

Получите ключ Guard

В @guardapi откройте Категории → API, выберите пакет и сохраните выданный gd-…. Один и тот же ключ работает с моделями Codex; список семи ID — Модели.

Создайте отдельного провайдера

Откройте ~/.hermes/.env и ~/.hermes/config.yaml в текстовом редакторе. Если файлов ещё нет, установщик создаёт каталог ~/.hermes; создайте недостающий файл. На Windows native папка данных находится в %LOCALAPPDATA%\hermes.
Добавьте в .env строку GUARD_API_KEY=gd-ваш-ключ. Если такая строка уже есть, обновите её, не создавая дубликат. Файл с ключом держите доступным только своей учётной записи.
В config.yaml обновите единственный раздел model:: provider: custom, точный default, адрес, key_env, api_mode и context_length как в примере. Сохраните остальные разделы файла.
Укажите api_mode: codex_responses; base_url должен заканчиваться на /codex/v1, без /responses. Перезапустите Hermes после сохранения.

dotenv

# ~/.hermes/.env
GUARD_API_KEY=gd-ваш-ключ

yaml

# ~/.hermes/config.yaml
_config_version: 45
model:
  default: gpt-6-astra
  provider: custom
  base_url: https://api.guardrelay.ai/codex/v1
  key_env: GUARD_API_KEY
  api_mode: codex_responses
  context_length: 872000
agent:
  reasoning_effort: medium

model.context_length задаёт клиентский бюджет выбранной модели; при смене модели измените его по таблице ниже. Это настройка сжатия истории Hermes, не жёсткий предел сервера.

Последний сохранённый нативный каталог Guard объявляет следующие значения максимального окна для настройки клиентского бюджета. Это не проверенный жёсткий предел входа; клиент может сжать историю раньше. В подключении Guard все семь моделей принимают и сохраняют max_output_tokens (Responses), max_completion_tokens (Chat) и max_tokens (Messages) как advisory, без гарантии жёсткого лимита вывода managed Codex; списание идёт по фактическим токенам и денежным правилам ключа.

ID модели	Контекст для настройки клиента
`gpt-6-astra`	`872000`
`gpt-6.1-sol`	`872000`
`gpt-6-sol`	`872000`
`gpt-6-luna`	`872000`
`gpt-5.6-sol`	`872000`
`gpt-5.6-terra`	`872000`
`gpt-5.6-luna`	`872000`

Выберите модель и отправьте запрос

В папке проекта запустите hermes.
Запустите hermes --provider custom --model gpt-6-astra --reasoning medium. Для другой модели сначала сверьте effort и context в Моделях.
Введите обычным сообщением Ответь ровно OK и дождитесь ответа.
Следующий вопрос в той же беседе продолжит её. После выхода вернитесь к последней CLI-беседе командой hermes --continue.

bash

hermes --provider custom --model gpt-6-astra --reasoning medium
# Продолжить тот же сеанс:
hermes --continue

Если подключение не получилось

Признак	Что проверить
`/model` не видит модель	В единственном разделе `model:` заданы `provider: custom`, точный `default` и `api_mode: codex_responses`; после правки клиент перезапущен.
`401`	В `.env` ровно одна действующая строка `GUARD_API_KEY`, а в записи провайдера нет старого `api_key`, который имеет приоритет.
`404` или ошибка формата	`base_url` равен `https://api.guardrelay.ai/codex/v1`, `api_mode` равен `codex_responses`, суффикс `/responses` вручную не добавлен.
`402`	Проверьте баланс и лимиты ключа в кабинете.

Hermes Agent

Claude, Kimi, Composer и Grok

GLM 5.3 в Hermes Agent

Установите Hermes

Получите ключ Guard

Создайте отдельный профиль GLM

Проверьте и продолжите

Модели и подтверждённые возможности

Если подключение не получилось

Gemini в Hermes Agent

Установите Hermes

Получите ключ Guard

Создайте отдельный профиль Gemini

Проверьте и продолжите

Модели и возможности Gemini

Если подключение не получилось

Muse в Hermes Agent

Установите Hermes

Получите ключ Guard

Создайте отдельный профиль Muse

Проверьте и продолжите

Модели и возможности Muse

Если подключение не получилось

Установите Hermes Agent

Получите ключ Guard

Создайте отдельного провайдера

Выберите модель и отправьте запрос

Если подключение не получилось

Разделы

На этой странице