Руководство по настройке Hermes Agent

Веб-сайт: https://hermes-agent.nousresearch.com (нажмите для перехода!)

📌 О Hermes Agent Hermes Agent — это открытый терминальный ИИ-агент, запущенный Nous Research, поддерживающий три точки входа CLI / TUI / API Server, и способный подключаться к любой совместимой с OpenAI конечной точке.

Адрес исходного кода

• GitHub: NousResearch/hermes-agent
• Официальная документация: hermes-agent.nousresearch.com/docs

1. Установить Hermes Agent

Способ 1: Установка pip (рекомендуется)

pip install hermes-agent
hermes postinstall    # Опционально: автоматическая установка Node.js / браузера / ripgrep / ffmpeg

Способ 2: Установка скриптом (следовать ветке main)

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

После установки перезагрузите Shell:

source ~/.zshrc    # или source ~/.bashrc

2. Основной процесс настройки

Настройки Hermes Agent сосредоточены в каталоге ~/.hermes/:

1. Настроить config.yaml (пользовательский провайдер)

Откройте или создайте ~/.hermes/config.yaml, запишите блок model как провайдер custom и направьте base_url на LLMoxy:

model:
  provider: custom
  base_url: "https://llmoxy.com/v1"
  model: "gpt-5.5"

Вы также можете использовать запись одним щелчком CLI (автоматически попадает в config.yaml):

hermes config set model.provider custom
hermes config set model.base_url https://llmoxy.com/v1
hermes config set model.model gpt-5.5

2. Настроить .env (записать ключ API)

Запишите токен LLMoxy в ~/.hermes/.env:

OPENAI_API_KEY=<LLMOXY_API_KEY>xxxxxxxxxxxxxxx

Или используйте CLI (рекомендуется, автоматически маршрутизирует в .env без утечки в YAML):

hermes config set OPENAI_API_KEY <LLMOXY_API_KEY>xxxxxxxxxxxxxxx

Замените <LLMOXY_API_KEY>xxxxxxxxxxxxxxx на реальный токен, полученный из Консоли LLMoxy.

💡 Подсказка Пожалуйста, используйте токен из группы auto. Hermes Agent вызывает LLMoxy через протокол OpenAI Chat Completions; base_url должен включать /v1.

3. Быстрая интерактивная настройка (опционально)

Если вы не хотите редактировать YAML вручную, выполните hermes model для входа в интерактивный мастер:

hermes model

Выберите по порядку:

1. В опциях провайдера выберите Custom Endpoint
2. Base URL введите https://llmoxy.com/v1
3. Ключ API вставьте токен LLMoxy
4. Модель введите gpt-5.5 (или другой ID модели, поддерживаемый LLMoxy, например gpt-5.4)

4. Запустить Hermes

hermes          # Классический CLI
hermes --tui    # Современный TUI интерфейс (рекомендуется)

После запуска приветственный баннер отобразит текущую активную модель и провайдера; вы можете ввести тестовый prompt для проверки связи.

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

# ~/.hermes/config.yaml
model:
  provider: custom
  base_url: "https://llmoxy.com/v1"
  model: "gpt-5.5"

# ~/.hermes/.env
OPENAI_API_KEY=<LLMOXY_API_KEY>xxxxxxxxxxxxxxx

💡 Подсказка по правилам именования моделей gpt-5.5 — это стандартный ID модели на LLMoxy, доступный для просмотра в консоли «Список моделей». Другие распространенные:

• Серия GPT: gpt-5.5, gpt-5.4, gpt-4o
• Серия Claude: claude-opus-4-6, claude-sonnet-4-6, claude-haiku-4-5
• Серия Gemini: gemini-2.5-pro

Приоритет конфигурации

Hermes Agent читает конфигурацию по следующему приоритету (от высокого к низкому):

1. Параметры командной строки
2. ~/.hermes/config.yaml
3. ~/.hermes/.env
4. Встроенные значения по умолчанию

После изменения конфигурации нет необходимости перезапускать Hermes; следующая новая сессия автоматически загрузит последний config.yaml.