Hermes Agent - самообучающийся AI-агент

В этом руководстве показано, как установить Hermes Agent и настроить Lychee AI в качестве пользовательского поставщика моделей.

Перед началом

Подготовьте следующие данные:

1. Адрес API: https://lizh.ai/v1
2. API-ключ: войдите в Lychee AI, затем создайте и скопируйте ключ в разделе «Консоль → Управление API-ключами»
3. ID модели: скопируйте точное название нужной модели из каталога моделей Lychee AI

Установка Hermes Agent

macOS, Linux или WSL2

Запустите официальный установщик Hermes в терминале:

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

Windows

Выполните следующую команду в PowerShell:

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

После установки откройте новое окно терминала и проверьте версию:

hermes version

Если появилась информация о версии, Hermes установлен успешно.

Настройка Lychee AI

Hermes рекомендует добавлять пользовательский OpenAI-совместимый адрес через мастер настройки моделей.

1. Откройте мастер настройки моделей

Выполните в терминале:

hermes model

2. Выберите пользовательский адрес

В списке Provider выберите:

Custom endpoint (self-hosted / VLLM / etc.)

Точное название пункта может немного отличаться в разных версиях. Выберите вариант, содержащий Custom endpoint.

3. Введите данные подключения

Следуя подсказкам мастера, укажите:

Если мастер запросит Context length, укажите размер контекста, показанный для выбранной модели. Если вы не уверены, оставьте значение по умолчанию, предложенное Hermes.

После завершения Hermes сохранит модель, Provider и адрес API в ~/.hermes/config.yaml. Настройки сохранятся после перезапуска терминала.

Проверка подключения

Выполните:

hermes chat

После запуска чата отправьте простое сообщение. Если Hermes вернул ответ, адрес API, API-ключ и ID модели настроены правильно.

Чтобы позднее сменить модель Lychee AI, завершите текущий сеанс и снова выполните:

hermes model

Ручная настройка (необязательно)

Если интерактивный мастер недоступен, отредактируйте файл ~/.hermes/config.yaml:

model:
  default: "ID модели из каталога моделей"
  provider: custom
  base_url: https://lizh.ai/v1
  api_key: "ваш API-ключ lizh.ai"

Сохраните файл и снова запустите hermes chat. Для отступов в YAML используйте пробелы, а не Tab. Не публикуйте конфигурационный файл с настоящим API-ключом в открытом репозитории.

Частые проблемы

Ошибка 401 или Authentication failed

API-ключ недействителен, истёк или скопирован не полностью. Проверьте состояние ключа в разделе управления API-ключами Lychee AI и при необходимости создайте новый.

Ошибка 404, Model not found или модель недоступна

ID модели должен полностью совпадать с названием в каталоге моделей Lychee AI. Проверьте регистр, дефисы и номер версии.

Не удаётся подключиться к API

Убедитесь, что API Base URL указан как https://lizh.ai/v1 и содержит /v1 в конце. Также проверьте, доступен ли Lychee AI из вашей сети.

Lychee AI не отображается в /model

Завершите чат Hermes и выполните hermes model в системном терминале, чтобы сначала настроить пользовательский адрес. После этого команду /model можно использовать внутри чата для переключения моделей.

Ошибка hermes: command not found

Закройте и снова откройте терминал. Если команда по-прежнему недоступна, проверьте путь установки и настройку PATH по официальной инструкции Hermes: FAQ & Troubleshooting.