Инсталација Hermes-а и конфигурација OmniProxy-а

Hermes је асистент који може да задржи разговоре и искуство са задацима, претварајући завршен рад у вештине које се касније могу поново користити. Кроз један гејтвеј, такође се може повезати са 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 Mac-ови нису подржани.
• 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 prompt, команда је спремна за употребу. Затим можете покренути 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 URL-ове сервиса у OmniProxy-у; немојте их уносити директно у Hermes.

Ваш рачунар

Hermes

→

Локални гејтвеј

OmniProxy

• Укључите /v1 у адресу

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

ID модела је тачан назив који API користи за идентификацију модела. Користите следеће називе за два модела:

• За Grok, унесите grok-4.7. xAI API је https://api.x.ai/v1, а захтеви за ћаскање користе /v1/chat/completions. Погледајте Grok документацију модела.
• За Gemini, унесите gemini-3.8-flash. Google-ов OpenAI-компатибилни API је https://generativelanguage.googleapis.com/v1beta/openai/. Погледајте Gemini-јеву документацију OpenAI компатибилности.

Да бисте пребацили 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 кључ је кључ који OmniProxy издаје Hermes-у. Замените placeholder својом вредношћу и не објављујте га на јавној страници.

Ако ваша локална OmniProxy инстанца не захтева кључ, можете оставити API кључ празним. Ако је адреса доступна било коме другом, требало би да користите кључ. Такође потврдите да је адреса достижна из окружења у којем 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 документацију модела и Gemini-јеву документацију OpenAI компатибилности.

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

Замените сваки чувар места вредностима из ваше OmniProxy конфигурације. Никада не објављујте стварни кључ.

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

Званични извори · Hermes ↗