Kusakinisha Hermes na Kusanidi OmniProxy

Hermes ni msaidizi anayeweza kuhifadhi mazungumzo na uzoefu wa kazi, akigeuza kazi iliyokamilishwa kuwa ujuzi unaoweza kutumiwa tena baadaye. Kupitia Lango moja, inaweza pia kuunganishwa na Telegram, Discord, Slack, WhatsApp, Signal, na terminal. Lango hutumika kama sehemu moja ya kuingilia kwa kupokea na kusambaza ujumbe. Unaweza kuitumia ukaguzi wa msimbo, maelezo ya tukio, au nyenzo za wateja kutoka kwa zana zako za kawaida za gumzo, kisha uifanye irudi kwenye hazina na kuendelea kufanya kazi.

Kabla Hujaanza

Kwanza, chagua njia ya usakinishaji kulingana na mfumo wa uendeshaji wa kompyuta yako. macOS na Windows zinaweza kutumia visakinishi vya picha moja kwa moja, wakati Linux, macOS, na WSL2 zinaweza kutumia hati ya terminal. WSL2 ni kipengele cha Windows cha kuendesha mazingira ya Linux. Termux kwenye simu za Android na Docker zina njia zao za usakinishaji, lakini mwongozo huu unashughulikia usakinishaji kwenye kompyuta za kawaida pekee.

Unataka dirisha

macOS, Windows

• macOS: fungua DMG
• Windows: fungua kisakinishi
• Sakinisha programu kwenye mfumo

Terminal pekee

Linux, macOS, WSL2

• Amri moja ya install.sh
• Tumia install.ps1 kwenye Windows
• Ingiza hermes baada ya usakinishaji

Usitumie hizi bado

pip, brew, AUR

• Njia hizi za usakinishaji hazijaungwa mkono rasmi
• Pia ni vigumu kusasisha baada ya usakinishaji
• Tumia moja ya chaguzi mbili upande wa kushoto badala yake

Kabla ya kuanza, andaa kompyuta ya macOS, Windows, au Linux na uhakikishe kuwa inaweza kufungua terminal na kufikia GitHub. Ikiwa unapanga kusakinisha Hermes kwenye diski ya nje, unganisha diski kwanza na uthibitishe kuwa ina nafasi ya kutosha ya bure.

Sakinisha na Uzindue kwa Mara ya Kwanza

Ikiwa Unataka Programu ya Picha

Nenda kwenye sehemu ya kupakua kwenye tovuti ya Hermes na upakue kisakinishi kwa mfumo wako wa uendeshaji. Kisakinishi tayari kinajumuisha mazingira ya utekelezaji, kwa hivyo hakuna kitu kinachohitaji kukusanywa ndani wakati unapoifungua kwa mara ya kwanza.

• macOS: Fungua DMG na uhamishe Hermes.app kwenye Programu. DMG ni picha ya usakinishaji inayotumiwa kawaida kwenye macOS. Kisakinishi hiki kinaunga mkono Apple silicon pekee; Intel Macs hazijaungwa mkono.
• Windows: Fungua faili ya .appinstaller na Windows App Installer. Inasakinisha MSIX iliyotiwa saini, aina ya kifurushi cha programu kinachotumiwa na Windows.
• Linux: Visakinishi vya mezani ni vya macOS na Windows. Kwenye Linux, tumia amri ya terminal hapa chini. Baada ya usakinishaji, unaweza kutekeleza hermes desktop.

Ikiwa Unahitaji Terminal Pekee

Ikiwa unatumia Linux, macOS, au WSL2, tekeleza hili kwenye terminal:

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

Unapotumia PowerShell iliyojumuishwa na Windows, tekeleza:

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

Kisakinishi hupakua msimbo wa Hermes na programu zinazohitajika ili kuiendesha. Ikiwa upakuaji utakatizwa, tekeleza amri hiyo hiyo tena. Baada ya usakinishaji kukamilika, funga terminal ya sasa, fungua dirisha jipya, na uingize:

hermes

Ikiwa unaona alama ya kuingiza amri ya Hermes (prompt), amri iko tayari kutumika. Unaweza kisha kutekeleza hermes doctor; ukaguzi huu wa usakinishaji hukuambia ni nini bado kinakosekana.

Hifadhi Programu kwenye Diski ya Nje

Tarehe 9 Oktoba 2026, Hermes Agent v0.21.6 ilisakinishwa kwenye diski ya nje iliyounganishwa na Mac. Programu ilihifadhiwa kwenye /Volumes/AItools/tools/hermes-agent, amri ya kizinduzi ilikuwa kwenye ~/.local/bin/hermes, na usanidi na data ya mazungumzo ilibaki kwenye ~/.hermes.

Ikiwa diski yako ina jina tofauti, badilisha njia baada ya --dir na folda yako mwenyewe. Diski lazima ibaki imeunganishwa wakati Hermes inafanya kazi.

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

Programu

Diski ya nje

• tools/hermes-agent
• Weka msimbo hapa

Amri

~/.local/bin/hermes

• Ingiza hermes kwenye terminal
• Inaanza kufanya kazi baada ya kufungua dirisha jipya

Usanidi na gumzo

~/.hermes

• config.yaml iko hapa
• Toka kabla ya kukata diski

Pata Thamani za Muunganisho kutoka OmniProxy

Hapa, Hermes inaunganishwa na OmniProxy badala ya moja kwa moja na Grok au Gemini. Sanidi URL za huduma za Grok na Gemini kwenye OmniProxy; usiziingize moja kwa moja kwenye Hermes.

Kompyuta yako

Hermes

→

Lango la ndani

OmniProxy

• Jumuisha /v1 kwenye anwani

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

Kitambulisho cha modeli ni jina halisi ambalo API hutumia kutambua modeli. Tumia majina yafuatayo kwa modeli hizo mbili:

• Kwa Grok, ingiza grok-4.7. API ya xAI ni https://api.x.ai/v1, na maombi ya gumzo hutumia /v1/chat/completions. Angalia hati za modeli za Grok.
• Kwa Gemini, ingiza gemini-3.8-flash. API ya Google inayooana na OpenAI ni https://generativelanguage.googleapis.com/v1beta/openai/. Angalia hati za utangamano wa OpenAI za Gemini.

Ili kubadilisha Hermes hadi Gemini, badilisha tu jina la modeli kuwa gemini-3.8-flash. Endelea kutumia anwani ya OmniProxy kama mwisho wa API.

Nakili URL ya mwisho na ufunguo kutoka OmniProxy, kisha uingize kitambulisho cha modeli kinacholingana:

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

Base URL ndiyo mwisho ambao Hermes hutuma maombi. Lazima iishie na /v1 hapa. API Key ndiyo ufunguo ambao OmniProxy hutoa kwa Hermes. Badilisha kishika nafasi na thamani yako mwenyewe, na usichapishe kwenye ukurasa wa umma.

Ikiwa mfano wako wa ndani wa OmniProxy hauhitaji ufunguo, unaweza kuacha API Key tupu. Ikiwa anwani inaweza kufikiwa na mtu mwingine yeyote, unapaswa kutumia ufunguo. Pia thibitisha kuwa anwani inaweza kufikiwa kutoka mazingira ambapo Hermes inafanya kazi. Ikiwa Hermes na OmniProxy ziko kwenye kompyuta moja, unaweza kutumia anwani ya ndani.

Ingiza Usanidi wa Zana

Kwanza, toka kwenye gumzo la sasa, kisha tekeleza hili kwenye terminal:

hermes model

Chagua Custom endpoint (self-hosted / VLLM / etc.). Custom endpoint inamaanisha kuwa Hermes inaunganishwa na anwani ya huduma unayobainisha badala ya kutumia mtoa huduma aliyewekwa awali.

Mchawi wa usanidi huuliza URL ya mwisho, ufunguo, na jina la modeli kwa mfululizo. Ingiza thamani tatu kutoka sehemu iliyotangulia. Ili kutumia Gemini, ingiza gemini-3.8-flash kama jina la modeli.

Unaweza pia kuhariri ~/.hermes/config.yaml moja kwa moja. YAML ni umbizo la maandishi linalotumia indentations kuwakilisha mahusiano ya usanidi. Usanidi ufuatao unatumia Grok:

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

Ili kutumia Gemini, badilisha default kuwa gemini-3.8-flash na uache thamani nyingine tatu bila kubadilika:

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

Baada ya kuhifadhi, tekeleza hermes tena na uanze gumzo jipya. Katika kipindi kilichofunguliwa tayari, /model inaweza tu kubadilisha kati ya watoa huduma ambao wamehifadhiwa tayari; haiwezi kuongeza usanidi huu.

Thibitisha na Kazi Halisi

1

hermes doctor

• Ukaguzi wa usakinishaji umefaulu

2

Tuma ujumbe mfupi

• Ona jibu kutoka kwa Hermes

3

Fungua kumbukumbu za ombi

• Thibitisha jina la modeli

1. Tekeleza hermes doctor ili kuangalia ikiwa usakinishaji umekamilika.
2. Tekeleza hermes na uombe ieleze kwa sentensi moja kile inachoweza kufanya. Unapaswa kuona jibu.
3. Fungua kumbukumbu ya ombi la OmniProxy, thibitisha kuwa ombi lilitoka kwa Hermes, na uangalie ikiwa jina la modeli ni grok-4.7 au gemini-3.8-flash.

Kuona kuwa mchawi wa usanidi umehifadhi kwa mafanikio, au kwamba API ilirudisha jibu la mafanikio, haitoshi kuonyesha kuwa Hermes inaweza kukamilisha kazi kwa ajili yako. Jina la modeli kwenye kumbukumbu ya ombi lazima lilingane na thamani uliyoingiza.

Ili kuzungumza kwenye kivinjari, tekeleza yafuatayo ndani:

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

Kisha fungua http://127.0.0.1:9119. Anwani hii inafanya kazi kwenye kompyuta ya sasa pekee.

Hitilafu za Kawaida

• Kuingiza hermes kunaripoti kuwa amri haiwezi kupatikana: Funga terminal na ufungue dirisha jipya. Ikiwa amri bado haipatikani, thibitisha kuwa ~/.local/bin iko kwenye PATH. PATH ni orodha ya saraka ambapo mfumo hutafuta amri. Kwenye Windows, thibitisha kuwa saraka ya uzinduzi iliyoongezwa na kisakinishi iko kwenye PATH.
• Upakuaji wa usakinishaji unasimama katikati: Tekeleza amri hiyo hiyo ya usakinishaji tena. Sehemu zilizopakuliwa tayari zitatumiwa tena.
• Hermes haijibu au inaripoti kuwa haiwezi kuunganishwa: Thibitisha kuwa OmniProxy inafanya kazi na uangalie kuwa Base URL inaishia na /v1. Ikiwa Hermes inafanya kazi kwenye Docker wakati OmniProxy inafanya kazi kwenye mwenyeji, usitumie 127.0.0.1 ikiwa ni halali ndani ya kontena pekee.
• Hitilafu ya ufunguo inaonekana: Sasisha ufunguo wa OmniProxy, kisha ubadilishe api_key kwenye config.yaml. Ufunguo wa xAI au Google ni wa mipangilio ya mtoa huduma wa OmniProxy; usiingize kwenye uwanja huu wa Hermes.
• Modeli inaripotiwa kuwa haipatikani: Fungua orodha ya sasa ya modeli kwenye OmniProxy na nakili grok-4.7 au gemini-3.8-flash kama inavyoonekana kwenye orodha.
• Hermes inajibu lakini haiwezi kufanya kazi kama vile kusoma faili au kutekeleza amri: Badilisha hadi modeli nyingine kwenye OmniProxy ambayo ina uwezo huo, kisha uanze kipindi kipya cha Hermes.
• Programu iko kwenye diski ya nje, na hermes doctor inaripoti hitilafu ya hifadhi baada ya diski kukatwa: Unganisha diski kwanza. Usiruhusu Hermes kuunda usanidi tofauti wakati diski imekatwa.

Marejeleo

Kwa hatua za usakinishaji, angalia hati za usakinishaji za Hermes na msaada wa jukwaa. Kwa usanidi wa Custom endpoint, angalia hati za Mtoa Huduma wa Hermes. Kwa vitambulisho vya modeli, angalia hati za modeli za Grok na hati za utangamano wa OpenAI za Gemini.

Mchakato wa usakinishaji wa macOS ulikamilishwa tarehe 2026-10-09 kwa kutumia Hermes Agent v0.21.6. grok-4.7 na gemini-3.8-flash zilikuwa vitambulisho vya kawaida vya modeli katika hati za xAI na Google tarehe hiyo. Unapoingiza thamani, tumia majina yanayoonyeshwa kwenye OmniProxy.

Badilisha kila nafasi yenye thamani kutoka kwenye usanidi wako wa OmniProxy. Usitangaze funguo halisi.

Matokeo yaliyohifadhiwa au HTTP 200 pekee hayathibitishi utangamano kamili wa Agent. Angalia chanzo na mfano katika rekodi ya maombi ya OmniProxy.

Vyanzo rasmi · Hermes ↗