Инсталиране на Hermes и конфигуриране на OmniProxy

Hermes е асистент, който може да запазва разговори и опит от задачи, превръщайки завършената работа в умения, които могат да бъдат използвани повторно по-късно. Чрез един шлюз (Gateway) той може също да се свързва с Telegram, Discord, Slack, WhatsApp, Signal и терминала. Шлюзът служи като единна входна точка за получаване и препращане на съобщения. Можете да му изпращате прегледи на код, бележки за инциденти или клиентски материали от вашите обичайни инструменти за чат, след което да го накарате да се върне в хранилището и да продължи работата си.

Преди да започнете

Първо изберете метод за инсталация въз основа на операционната система на вашия компютър. macOS и Windows могат да използват графични инсталатори директно, докато Linux, macOS и WSL2 могат да използват терминален скрипт. WSL2 е функция на Windows за стартиране на Linux среда. Termux на телефони с Android и Docker имат свои собствени методи за инсталация, но това ръководство обхваща само инсталацията на обикновени компютъри.

Искате прозорец

macOS, Windows

• macOS: отворете DMG
• Windows: отворете инсталатора
• Инсталирайте приложението на системата

Само терминал

Linux, macOS, WSL2

• Една команда install.sh
• Използвайте install.ps1 на Windows
• Въведете hermes след инсталацията

Не използвайте тези все още

pip, brew, AUR

• Тези методи за инсталация не се поддържат официално
• Те също са трудни за актуализиране след инсталация
• Използвайте една от двете опции вляво вместо това

Преди да започнете, подгответе компютър с macOS, Windows или Linux и се уверете, че може да отваря терминал и да има достъп до GitHub. Ако планирате да инсталирате Hermes на външно устройство, свържете устройството първо и потвърдете, че има достатъчно свободно място.

Инсталиране и първо стартиране

Ако искате графично приложение

Отидете в раздела за изтегляне на уебсайта на Hermes и изтеглете инсталатора за вашата операционна система. Инсталаторът вече включва средата за изпълнение, така че нищо не трябва да се компилира локално, когато го отворите за първи път.

• macOS: Отворете DMG и преместете Hermes.app в Applications. DMG е инсталационен образ, често използван на macOS. Този инсталатор поддържа само Apple silicon; Intel Macs не се поддържат.
• Windows: Отворете .appinstaller файла с Windows App Installer. Той инсталира подписан 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. Конфигурирайте URL адресите на услугите 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-съвместимият API на Google е https://generativelanguage.googleapis.com/v1beta/openai/. Вижте документацията за OpenAI съвместимост на Gemini.

За да превключите Hermes към Gemini, само променете името на модела на gemini-3.8-flash. Продължете да използвате адреса на OmniProxy като API крайна точка.

Копирайте URL адреса на крайната точка и ключа от 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 се свързва с адрес на услуга, който вие посочите, вместо да използва предварително зададен доставчик.

Съветникът за настройка изисква URL адреса на крайната точка, ключа и името на модела последователно. Въведете трите стойности от предишния раздел. За да използвате 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 точно както се появява в списъка.
• Hermes отговаря, но не може да изпълнява задачи като четене на файлове или изпълнение на команди: Превключете към друг модел в OmniProxy, който има тези възможности, след което стартирайте нова сесия на Hermes.
• Програмата е на външно устройство и hermes doctor съобщава за грешка в съхранението след изключване на устройството: Свържете устройството първо. Не позволявайте на Hermes да създава отделна конфигурация, докато устройството е изключено.

Справки

За стъпките по инсталиране вижте документацията за инсталиране на Hermes и поддръжка на платформи. За конфигурация на Custom endpoint вижте документацията за доставчици на Hermes. За ID-тата на моделите вижте документацията за модели на Grok и документацията за OpenAI съвместимост на Gemini.

Процесът на инсталиране на macOS беше завършен на 9 октомври 2026 г. с помощта на Hermes Agent v0.21.6. grok-4.7 и gemini-3.8-flash бяха стандартните ID-та на модели в документацията на xAI и Google на тази дата. Когато въвеждате стойностите, използвайте имената, показани в OmniProxy.

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

Запазен резултат или HTTP 200 сам по себе си не доказва пълна съвместимост на агента. Проверете източника и модела в записа на заявката в OmniProxy.

Официални източници · Hermes ↗