Встановлення Hermes і налаштування OmniProxy

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

Підготовка до встановлення

Спочатку виберіть спосіб встановлення відповідно до операційної системи комп’ютера. У 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

У вбудованому в Windows PowerShell виконайте:

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. Адресою API й надалі має бути адреса OmniProxy.

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

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

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

Якщо локальний OmniProxy не вимагає ключа, поле API Key можна залишити порожнім. Якщо адреса доступна іншим користувачам, ключ потрібно вказати. Також переконайтеся, що ця адреса доступна із середовища, у якому працює Hermes. Якщо Hermes і OmniProxy працюють на одному комп’ютері, можна використовувати локальну адресу.

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

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

hermes model

Виберіть Custom endpoint (self-hosted / VLLM / etc.). Custom endpoint — це власна кінцева точка, яка дає Hermes змогу підключатися до вказаної вами адреси сервісу замість попередньо налаштованого постачальника.

Майстер по черзі запитає адресу API, ключ і назву моделі. Введіть три значення з попереднього розділу. Якщо хочете використовувати 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.

Самого повідомлення про успішне збереження в майстрі або успішної відповіді API недостатньо, щоб вважати, що 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 точно в тому вигляді, у якому назву наведено в списку.
• Відповідь надходить, але читання файлів, виконання команд або подібні дії недоступні: виберіть в 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 ↗