Установка Hermes и настройка OmniProxy

Hermes — это ассистент, который сохраняет историю диалогов и опыт выполнения задач. Выполненную работу можно оформить в виде навыков и использовать в дальнейшем. Кроме того, через единый Gateway он может подключаться к Telegram, Discord, Slack, WhatsApp, Signal и терминалу. Gateway служит общей точкой приёма и пересылки сообщений. Через привычный мессенджер вы можете поручить Hermes проверку кода, ведение журнала инцидента или обработку клиентских материалов, после чего он сможет продолжить работу с ними в репозитории.

Подготовка к установке

Сначала выберите способ установки в соответствии с операционной системой компьютера. В macOS и Windows можно использовать установочный пакет с графическим интерфейсом; в Linux, macOS и WSL2 — скрипт для терминала. WSL2 позволяет запускать среду Linux внутри Windows. Для Termux на Android и Docker предусмотрены отдельные способы установки, но в этом руководстве рассматривается только установка на обычный компьютер.

Нужно окно

macOS、Windows

• macOS: открыть DMG
• Windows: открыть установочный пакет
• Переместить приложение в систему

Только терминал

Linux、macOS、WSL2

• Один install.sh
• Для Windows использовать install.ps1
• После установки ввести hermes

Пока не использовать

pip、brew、AUR

• Официально эти способы установки не поддерживаются
• После установки сложно обновлять
• Использовать два способа слева

Перед началом подготовьте компьютер с macOS, Windows или Linux и убедитесь, что на нём можно открыть терминал и получить доступ к GitHub. Если вы собираетесь установить программу на внешний диск, сначала подключите его и проверьте наличие достаточного свободного места.

Установка и первый запуск

Если нужен графический интерфейс

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

• macOS: откройте DMG и переместите Hermes.app в папку «Программы». DMG — распространённый в macOS формат образа для установки приложений. Этот пакет поддерживает только компьютеры с процессорами Apple; компьютеры Mac с процессорами Intel не поддерживаются.
• Windows: откройте файл .appinstaller с помощью установщика приложений Windows. Будет установлен подписанный пакет MSIX — один из форматов установочных пакетов Windows.
• Linux: пакеты с графическим интерфейсом предназначены для macOS и Windows. В Linux используйте приведённую ниже команду терминала. После установки графический интерфейс можно запустить командой hermes desktop.

Если достаточно терминала

В Linux, macOS или WSL2 выполните в терминале:

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

Во встроенном PowerShell для Windows выполните:

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

Установщик загрузит код Hermes и необходимые для его работы программы. Если загрузка прервётся, повторно выполните ту же команду. После завершения установки закройте текущий терминал, откройте новое окно и введите:

hermes

Если появилось приглашение Hermes, команда уже доступна. Затем можно выполнить hermes doctor — эта проверка установки сообщит, каких компонентов ещё не хватает.

Размещение программы на внешнем диске

9 октября 2026 года Hermes Agent v0.21.6 был установлен на внешний диск на компьютере Mac. Программа находилась в /Volumes/AItools/tools/hermes-agent, команда запуска — в ~/.local/bin/hermes, а конфигурация и диалоги по-прежнему сохранялись в ~/.hermes.

Если ваш диск называется иначе, замените путь после --dir на путь к своей папке. Во время работы Hermes этот диск должен оставаться подключённым.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh -o install.sh
bash install.sh --dir /Volumes/AItools/tools/hermes-agent --non-interactive

Программа

Внешний диск

• tools/hermes-agent
• Код находится здесь

Команда

~/.local/bin/hermes

• Ввести hermes в терминале
• Вступает в силу после открытия нового окна

Конфигурация и диалоги

~/.hermes

• Здесь находится config.yaml
• Перед отключением диска сначала выйти

Получение параметров подключения из OmniProxy

В этой конфигурации Hermes подключается к OmniProxy, а не напрямую к Grok или Gemini. Адреса сервисов Grok и Gemini настраиваются в OmniProxy — не указывайте их непосредственно в Hermes.

Ваш компьютер

Hermes

→

Локальный шлюз

OmniProxy

• Адрес указать как /v1

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

ID модели — это точное имя, по которому интерфейс API распознаёт модель. Для двух моделей используются следующие имена:

• Для Grok укажите grok-4.7. Адрес API xAI — https://api.x.ai/v1, а запросы чата отправляются через /v1/chat/completions. См. документацию по моделям Grok.
• Для Gemini укажите gemini-3.8-flash. Адрес совместимого с OpenAI интерфейса Google — https://generativelanguage.googleapis.com/v1beta/openai/. См. описание совместимости Gemini с OpenAI.

Чтобы переключить Hermes на Gemini, достаточно заменить имя модели на gemini-3.8-flash. В качестве адреса интерфейса по-прежнему следует указывать адрес OmniProxy.

Скопируйте из OmniProxy адрес интерфейса и ключ, а затем укажите соответствующий ID модели:

Base URL: https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: grok-4.7

Base URL — адрес интерфейса, на который Hermes отправляет запросы. Здесь он должен заканчиваться на /v1. API Key — ключ, который OmniProxy выдаёт для Hermes. Замените его своим значением и не публикуйте на общедоступных страницах.

Если локальный экземпляр OmniProxy не требует ключа, поле API Key можно оставить пустым. Если адрес доступен другим людям, ключ необходимо указать. Также убедитесь, что этот адрес доступен из среды, где работает Hermes. Если Hermes и OmniProxy работают на одном компьютере, можно использовать локальный адрес.

Ввод конфигурации инструмента

Сначала завершите текущий чат, а затем выполните в терминале:

hermes model

Выберите Custom endpoint (self-hosted / VLLM / etc.). Custom endpoint — это пользовательский интерфейс подключения, позволяющий Hermes обращаться по указанному вами адресу сервиса вместо предустановленного поставщика.

Мастер последовательно запросит адрес интерфейса, ключ и имя модели. Введите три значения из предыдущего раздела. Если хотите использовать Gemini, укажите имя модели gemini-3.8-flash.

Также можно напрямую отредактировать ~/.hermes/config.yaml. YAML — это текстовый формат, в котором структура конфигурации задаётся отступами. Ниже приведён вариант для Grok:

model:
  default: grok-4.7
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

Для Gemini замените значение default на gemini-3.8-flash. Остальные три параметра не меняются:

model:
  default: gemini-3.8-flash
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

После сохранения снова запустите hermes, а затем начните чат. В уже открытом сеансе команда /model позволяет только переключаться между ранее сохранёнными поставщиками — добавить с её помощью эту конфигурацию нельзя.

Проверка на реальной задаче

1

hermes doctor

• Проверка установки пройдена

2

Отправить короткую фразу

• Увидеть ответ Hermes

3

Открыть журнал вызовов

• Проверить имя модели

1. Выполните hermes doctor, чтобы проверить полноту установки.
2. Запустите hermes и попросите его одним предложением рассказать, что он умеет. В ответ должен появиться текст.
3. Откройте журнал вызовов OmniProxy, убедитесь, что запрос поступил от Hermes, и проверьте, указано ли имя модели grok-4.7 или gemini-3.8-flash.

Одного сообщения об успешном сохранении настроек мастером или успешного ответа интерфейса недостаточно, чтобы убедиться, что Hermes уже может выполнять ваши задачи. Имя модели в журнале вызовов должно точно совпадать с указанным значением.

Если вы хотите общаться с Hermes в браузере, выполните на локальном компьютере:

hermes dashboard --no-open --host 127.0.0.1 --port 9119

Затем откройте http://127.0.0.1:9119. Этот адрес доступен только на текущем компьютере.

Распространённые ошибки

• При вводе hermes появляется сообщение, что команда не найдена: закройте терминал и откройте новое окно. Если команда по-прежнему не найдена, убедитесь, что ~/.local/bin добавлен в PATH. PATH — это список каталогов, в которых система ищет команды. В Windows проверьте, добавил ли установщик каталог запуска в PATH.
• Загрузка во время установки прервалась: повторно выполните ту же команду установки. Уже загруженные данные будут использованы повторно.
• Hermes не отвечает или сообщает, что не удаётся подключиться: убедитесь, что OmniProxy запущен, и проверьте, заканчивается ли Base URL на /v1. Если Hermes работает в Docker, а OmniProxy — на хост-компьютере, не используйте 127.0.0.1, доступный только внутри контейнера.
• Появляется сообщение о неверном ключе: обновите ключ OmniProxy, а затем измените значение api_key в config.yaml. Ключи xAI или Google относятся к настройкам поставщика в OmniProxy — не вводите их в это поле Hermes.
• Появляется сообщение, что такой модели нет: откройте текущий список моделей OmniProxy и точно скопируйте из него написание grok-4.7 или gemini-3.8-flash.
• Hermes отвечает, но не может читать файлы, выполнять команды или делать другие подобные операции: выберите в OmniProxy другую модель с необходимыми возможностями, а затем запустите новый сеанс Hermes.
• Программа находится на внешнем диске, а после его отключения hermes doctor сообщает об ошибке хранилища: сначала снова подключите диск. Не позволяйте Hermes создавать отдельную конфигурацию, пока диск отключён.

Официальные справочные материалы

Инструкции по установке приведены в документации по установке Hermes и разделе поддержки платформ. Настройка Custom endpoint описана в документации Hermes Provider. ID моделей приведены в документации по моделям Grok и описании совместимости Gemini с OpenAI.

Установка в macOS была полностью проверена 2026-10-09 с использованием Hermes Agent v0.21.6. На эту дату grok-4.7 и gemini-3.8-flash являлись стандартными ID моделей в документации xAI и Google. При настройке используйте имена, отображаемые в OmniProxy.

Замените все заполнители значениями из вашей собственной конфигурации OmniProxy. Никогда не публикуйте реальный ключ.

Сохранённый результат или HTTP 200 сами по себе не доказывают полную совместимость Агента. Проверьте источник и модель в журнале вызовов OmniProxy.

Официальные источники · Hermes ↗