Pag-install ng Hermes at Pag-configure ng OmniProxy

Ang Hermes ay isang assistant na kayang panatilihin ang mga pag-uusap at karanasan sa gawain, na ginagawang mga kasanayan ang mga natapos na trabaho na maaaring magamit muli sa susunod. Sa pamamagitan ng isang Gateway, maaari rin itong kumonekta sa Telegram, Discord, Slack, WhatsApp, Signal, at terminal. Ang Gateway ay nagsisilbing isang pinag-isang entry point para sa pagtanggap at pagpapasa ng mga mensahe. Maaari kang magpadala sa kanya ng mga code review, incident note, o materyales ng customer mula sa iyong mga karaniwang chat tool, pagkatapos ay ipabalik ito sa repository at magpatuloy sa pagtatrabaho.

Bago Ka Magsimula

Una, pumili ng paraan ng pag-install base sa operating system ng iyong computer. Ang macOS at Windows ay maaaring gumamit ng mga graphical installer nang direkta, habang ang Linux, macOS, at WSL2 ay maaaring gumamit ng terminal script. Ang WSL2 ay isang feature ng Windows para sa pagpapatakbo ng isang Linux environment. Ang Termux sa mga Android phone at Docker ay may sariling mga paraan ng pag-install, ngunit ang gabay na ito ay sumasaklaw lamang sa pag-install sa mga regular na computer.

Gusto ng window

macOS, Windows

• macOS: buksan ang DMG
• Windows: buksan ang installer
• I-install ang app sa system

Terminal lamang

Linux, macOS, WSL2

• Isang install.sh command
• Gamitin ang install.ps1 sa Windows
• Ipasok ang hermes pagkatapos ng pag-install

Huwag gamitin ang mga ito muna

pip, brew, AUR

• Ang mga paraan ng pag-install na ito ay hindi opisyal na suportado
• Mahirap din silang i-update pagkatapos ng pag-install
• Gamitin ang isa sa dalawang opsyon sa kaliwa sa halip

Bago ka magsimula, ihanda ang isang macOS, Windows, o Linux computer at siguraduhin na kaya nitong magbukas ng terminal at mag-access sa GitHub. Kung plano mong i-install ang Hermes sa isang external drive, ikonekta muna ang drive at kumpirmahin na mayroon itong sapat na libreng espasyo.

Pag-install at Unang Paglulunsad

Kung Gusto Mo ng Graphical App

Pumunta sa download section sa website ng Hermes at i-download ang installer para sa iyong operating system. Ang installer ay kasama na ang runtime environment, kaya walang kailangang i-compile nang lokal kapag binuksan mo ito sa unang pagkakataon.

• macOS: Buksan ang DMG at ilipat ang Hermes.app sa Applications. Ang DMG ay isang installation image na karaniwang ginagamit sa macOS. Ang installer na ito ay sumusuporta lamang sa Apple silicon; ang mga Intel Mac ay hindi suportado.
• Windows: Buksan ang .appinstaller file gamit ang Windows App Installer. Nag-i-install ito ng isang signed MSIX, isang uri ng application package na ginagamit ng Windows.
• Linux: Ang mga desktop installer ay para sa macOS at Windows. Sa Linux, gamitin ang terminal command sa ibaba. Pagkatapos ng pag-install, maaari mong patakbuhin ang hermes desktop.

Kung Kailangan Mo Lang ng Terminal

Kung gumagamit ka ng Linux, macOS, o WSL2, patakbuhin ito sa isang terminal:

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

Kapag ginagamit ang PowerShell na kasama sa Windows, patakbuhin ang:

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

Ang installer ay nag-da-download ng Hermes code at ang mga program na kailangan para patakbuhin ito. Kung naantala ang pag-download, patakbuhin muli ang parehong command. Pagkatapos matapos ang pag-install, isara ang kasalukuyang terminal, magbukas ng bagong window, at ipasok ang:

hermes

Kung nakikita mo ang Hermes prompt, handa na ang command para gamitin. Maaari mo nang patakbuhin ang hermes doctor; ang installation check na ito ay nagsasabi sa iyo kung ano pa ang kulang.

I-store ang Program sa isang External Drive

Noong Oktubre 9, 2026, ang Hermes Agent v0.21.6 ay na-install sa isang external drive na nakakonekta sa isang Mac. Ang program ay na-store sa /Volumes/AItools/tools/hermes-agent, ang launcher command ay matatagpuan sa ~/.local/bin/hermes, at ang configuration at conversation data ay nanatili sa ~/.hermes.

Kung ang iyong drive ay may ibang pangalan, palitan ang path pagkatapos ng --dir ng sarili mong folder. Dapat manatiling nakakonekta ang drive habang tumatakbo ang Hermes.

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

Program

External drive

• tools/hermes-agent
• Panatilihin ang code dito

Command

~/.local/bin/hermes

• Ipasok ang hermes sa terminal
• Magkakabisa ito pagkatapos magbukas ng bagong window

Configuration at mga chat

~/.hermes

• Ang config.yaml ay narito
• Lumabas bago idiskonekta ang drive

Kunin ang mga Connection Value mula sa OmniProxy

Dito, kumokonekta ang Hermes sa OmniProxy sa halip na direkta sa Grok o Gemini. I-configure ang Grok at Gemini service URL sa OmniProxy; huwag silang ipasok nang direkta sa Hermes.

Ang iyong computer

Hermes

→

Lokal na gateway

OmniProxy

• Isama ang /v1 sa address

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

Ang model ID ay ang eksaktong pangalan na ginagamit ng API para tukuyin ang isang model. Gamitin ang mga sumusunod na pangalan para sa dalawang model:

• Para sa Grok, ipasok ang grok-4.7. Ang xAI API ay https://api.x.ai/v1, at ang mga chat request ay gumagamit ng /v1/chat/completions. Tingnan ang Grok model documentation.
• Para sa Gemini, ipasok ang gemini-3.8-flash. Ang OpenAI-compatible API ng Google ay https://generativelanguage.googleapis.com/v1beta/openai/. Tingnan ang Gemini’s OpenAI compatibility documentation.

Para ilipat ang Hermes sa Gemini, baguhin lamang ang pangalan ng model sa gemini-3.8-flash. Patuloy na gamitin ang OmniProxy address bilang API endpoint.

Kopyahin ang endpoint URL at key mula sa OmniProxy, pagkatapos ay ipasok ang kaukulang model ID:

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

Ang Base URL ay ang endpoint kung saan nagpapadala ng mga request ang Hermes. Dapat itong magtapos sa /v1 dito. Ang API Key ay ang key na ibinibigay ng OmniProxy sa Hermes. Palitan ang placeholder ng sarili mong value, at huwag itong i-publish sa isang pampublikong pahina.

Kung ang iyong lokal na OmniProxy instance ay hindi nangangailangan ng key, maaari mong iwanang bakante ang API Key. Kung ang address ay accessible sa sinumang iba pa, dapat kang gumamit ng key. Kumpirmahin din na ang address ay maabot mula sa environment kung saan tumatakbo ang Hermes. Kung ang Hermes at OmniProxy ay nasa parehong computer, maaari kang gumamit ng lokal na address.

Ipasok ang Tool Configuration

Una, lumabas sa kasalukuyang chat, pagkatapos ay patakbuhin ito sa isang terminal:

hermes model

Piliin ang Custom endpoint (self-hosted / VLLM / etc.). Ang Custom endpoint ay nangangahulugan na ang Hermes ay kumokonekta sa isang service address na tinukoy mo sa halip na gumamit ng preset provider.

Ang setup wizard ay humihingi ng endpoint URL, key, at pangalan ng model nang sunod-sunod. Ipasok ang tatlong value mula sa nakaraang seksyon. Para gamitin ang Gemini, ipasok ang gemini-3.8-flash bilang pangalan ng model.

Maaari mo ring i-edit ang ~/.hermes/config.yaml nang direkta. Ang YAML ay isang text format na gumagamit ng indentation para ipakita ang mga relasyon sa configuration. Ang sumusunod na configuration ay gumagamit ng Grok:

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

Para gamitin ang Gemini, baguhin ang default sa gemini-3.8-flash at iwanang hindi nagbabago ang iba pang tatlong value:

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

Pagkatapos mag-save, patakbuhin ang hermes muli at magsimula ng bagong chat. Sa isang session na nakabukas na, /model ay makakapagpalit lamang sa pagitan ng mga provider na na-save na; hindi nito maidaragdag ang configuration na ito.

I-verify gamit ang Totoong Gawain

1

hermes doctor

• Pumasa ang installation check

2

Magpadala ng maikling mensahe

• Makakita ng reply mula sa Hermes

3

Buksan ang request logs

• I-verify ang pangalan ng model

1. Patakbuhin ang hermes doctor para suriin kung kumpleto ang pag-install.
2. Patakbuhin ang hermes at utusan itong ipaliwanag sa isang pangungusap kung ano ang kaya nitong gawin. Dapat kang makakita ng response.
3. Buksan ang OmniProxy request log, kumpirmahin na ang request ay nagmula sa Hermes, at suriin kung ang pangalan ng model ay grok-4.7 o gemini-3.8-flash.

Ang makita na matagumpay na na-save ang setup wizard, o na ang API ay nagbalik ng matagumpay na response, ay hindi sapat para ipakita na kayang kumpletuhin ng Hermes ang mga gawain para sa iyo. Ang pangalan ng model sa request log ay dapat tumugma sa value na ipinasok mo.

Para makipag-chat sa isang browser, patakbuhin ang sumusunod nang lokal:

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

Pagkatapos ay buksan ang http://127.0.0.1:9119. Ang address na ito ay gumagana lamang sa kasalukuyang computer.

Mga Karaniwang Error

• Ang pagpasok ng hermes ay nag-uulat na hindi mahanap ang command: Isara ang terminal at magbukas ng bagong window. Kung hindi pa rin mahanap ang command, kumpirmahin na ang ~/.local/bin ay nasa PATH. Ang PATH ay ang listahan ng mga directory kung saan hinahanap ng system ang mga command. Sa Windows, kumpirmahin na ang launch directory na idinagdag ng installer ay nasa PATH.
• Ang pag-download ng pag-install ay humihinto sa kalagitnaan: Patakbuhin muli ang parehong installation command. Ang mga bahagi na na-download na ay gagamitin muli.
• Hindi tumutugon ang Hermes o nag-uulat na hindi ito makakonekta: Kumpirmahin na tumatakbo ang OmniProxy at suriin na ang Base URL ay nagtatapos sa /v1. Kung ang Hermes ay tumatakbo sa Docker habang ang OmniProxy ay tumatakbo sa host, huwag gamitin ang 127.0.0.1 kung ito ay valid lamang sa loob ng container.
• May lumalabas na key error: I-update ang OmniProxy key, pagkatapos ay baguhin ang api_key sa config.yaml. Ang xAI o Google key ay kabilang sa provider settings ng OmniProxy; huwag itong ipasok sa field na ito ng Hermes.
• Ang model ay iniulat na hindi available: Buksan ang kasalukuyang listahan ng model sa OmniProxy at kopyahin ang grok-4.7 o gemini-3.8-flash nang eksakto gaya ng pagkakita nito sa listahan.
• Tumutugon ang Hermes pero hindi makagawa ng mga gawain gaya ng pagbabasa ng mga file o pag-execute ng mga command: Lumipat sa isa pang model sa OmniProxy na may mga kakayahang iyon, pagkatapos ay magsimula ng bagong Hermes session.
• Ang program ay nasa isang external drive, at ang hermes doctor ay nag-uulat ng storage error pagkatapos idiskonekta ang drive: Ikonekta muli ang drive. Huwag hayaan ang Hermes na gumawa ng hiwalay na configuration habang nakadiskonekta ang drive.

Mga Sanggunian

Para sa mga hakbang sa pag-install, tingnan ang Hermes installation documentation at platform support. Para sa Custom endpoint configuration, tingnan ang Hermes Provider documentation. Para sa mga model ID, tingnan ang Grok model documentation at Gemini’s OpenAI compatibility documentation.

Ang proseso ng pag-install sa macOS ay nakumpleto noong 2026-10-09 gamit ang Hermes Agent v0.21.6. grok-4.7 at gemini-3.8-flash ang mga standard model ID sa dokumentasyon ng xAI at Google sa petsang iyon. Kapag ipinapasok ang mga value, gamitin ang mga pangalang ipinapakita sa OmniProxy.

Palagyan ng halaga mula sa iyong sariling konfigurasyon ng OmniProxy ang bawat placeholder. Huwag kailanman ilabas ang tunay na key.

Ang isang na-save na resulta o HTTP 200 lamang ay hindi patunay ng full Agent compatibility. Suriin ang source at modelo sa call log ng OmniProxy.

Mga opisyal na pinagkukunan · Hermes ↗