Installazzjoni ta’ Hermes u konfigurazzjoni ta’ OmniProxy

Hermes huwa assistent li jista’ jżomm il-konversazzjonijiet u l-esperjenza tal-kompiti, u jorganizza dak li jkun għamel f’ħiliet li jistgħu jerġgħu jintużaw aktar tard. Permezz tal-istess Gateway, jista’ wkoll jaħdem ma’ Telegram, Discord, Slack, WhatsApp, Signal u t-terminal; il-Gateway jista’ jitqies bħala punt wieħed li jirċievi u jgħaddi l-messaġġi. Tista’ tagħtih reviżjonijiet tal-kodiċi, rekords ta’ inċidenti jew materjal tal-klijenti mill-għodda taċ-chat li tuża ta’ spiss, u mbagħad tħallih ikompli jaħdem fuqhom fir-repożitorju.

Tħejjija qabel l-installazzjoni

L-ewwel agħżel il-metodu ta’ installazzjoni skont is-sistema tal-kompjuter tiegħek. Fuq macOS u Windows tista’ tuża direttament pakkett ta’ installazzjoni b’interfaċċa grafika; fuq Linux, macOS u WSL2 tista’ tuża skript mit-terminal. WSL2 hija funzjoni li tħaddem ambjent Linux ġewwa Windows. Termux fuq telefowns Android u Docker għandhom ukoll il-metodi ta’ installazzjoni tagħhom, iżda din il-gwida tkopri biss l-installazzjoni fuq kompjuters normali.

Trid tieqa

macOS, Windows

• macOS: iftaħ id-DMG
• Windows: iftaħ il-pakkett tal-installazzjoni
• Installa l-applikazzjoni fis-sistema

Terminal biss

Linux, macOS, WSL2

• Kmand install.sh wieħed
• Fuq Windows uża install.ps1
• Wara l-installazzjoni daħħal hermes

Tużax għalissa

pip, brew, AUR

• Dawn il-metodi ta' installazzjoni mhumiex appoġġjati uffiċjalment
• Huwa diffiċli wkoll li taġġorna wara l-installazzjoni
• Uża ż-żewġ għażliet fuq ix-xellug

Qabel tibda, ħejji kompjuter macOS, Windows jew Linux u kun żgur li jista’ jiftaħ terminal u jaċċessa GitHub. Jekk se tinstalla fuq diska esterna, qabbadha minn qabel u kun żgur li fiha biżżejjed spazju.

Installazzjoni u l-ewwel tħaddim

Jekk trid tieqa

Mur fit-taqsima tat-tniżżil tas-sit ta’ Hermes u niżżel il-pakkett ta’ installazzjoni għas-sistema tiegħek. Il-pakkett diġà jinkludi l-ambjent meħtieġ għat-tħaddim, għalhekk ma hemmx għalfejn tikkompilah fuq il-kompjuter meta tiftaħu għall-ewwel darba.

• macOS: iftaħ id-DMG u poġġi Hermes.app f’Applications. DMG huwa format ta’ immaġni tal-installazzjoni użat komunement fuq macOS. Dan il-pakkett jappoġġja biss kompjuters b’ċippa Apple; Intel Mac mhuwiex appoġġjat.
• Windows: iftaħ il-fajl .appinstaller bl-installatur tal-applikazzjonijiet ta’ Windows. Dan jinstalla MSIX iffirmat, jiġifieri tip ta’ pakkett ta’ installazzjoni tal-applikazzjonijiet użat minn Windows.
• Linux: il-pakketti tad-desktop huma għal macOS u Windows. Fuq Linux uża l-kmand tat-terminal hawn taħt; wara l-installazzjoni tista’ tħaddem hermes desktop.

Jekk trid biss it-terminal

Jekk qed tuża Linux, macOS jew WSL2, eżegwixxi dan fit-terminal:

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

Jekk qed tuża l-PowerShell inkluż ma’ Windows, eżegwixxi:

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

L-installatur iniżżel il-kodiċi ta’ Hermes u l-programmi meħtieġa biex jitħaddem. Jekk it-tniżżil jinqata’ waqt il-proċess, erġa’ eżegwixxi l-istess kmand. Meta titlesta l-installazzjoni, agħlaq it-terminal attwali, iftaħ tieqa ġdida u daħħal:

hermes

Jekk tara l-prompt ta’ Hermes, il-kmand huwa lest biex jintuża. Imbagħad tista’ tħaddem hermes doctor; din hija verifika tal-installazzjoni li tindika x’għadu nieqes.

Jekk il-programm jinsab fuq diska esterna

Fid-9 ta’ Ottubru 2026, Hermes Agent v0.21.6 ġie installat fuq diska esterna fuq Mac. Il-programm kien jinsab f’/Volumes/AItools/tools/hermes-agent, il-kmand tat-tħaddim f’~/.local/bin/hermes, filwaqt li l-konfigurazzjoni u l-konversazzjonijiet baqgħu f’~/.hermes.

Jekk id-diska tiegħek għandha isem differenti, ibdel il-mogħdija wara --dir bil-folder tiegħek. Meta tħaddem Hermes, din id-diska trid tibqa’ mqabbda.

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

Programm

Diska esterna

• tools/hermes-agent
• Il-kodiċi jinsab hawn

Kmand

~/.local/bin/hermes

• Daħħal hermes fit-terminal
• Jidħol fis-seħħ wara li tiftaħ tieqa ġdida

Konfigurazzjoni u konversazzjonijiet

~/.hermes

• config.yaml jinsab hawn
• Oħroġ qabel ma tiskonnettja d-diska

Ikseb il-parametri tal-konnessjoni minn OmniProxy

Hawnhekk Hermes jikkonnettja ma’ OmniProxy, mhux direttament ma’ Grok jew Gemini. L-indirizzi tas-servizzi ta’ Grok u Gemini jiġu kkonfigurati f’OmniProxy; iddaħħalhomx direttament f’Hermes.

Il-kompjuter tiegħek

Hermes

→

Gateway lokali

OmniProxy

• L-indirizz għandu jispiċċa b'/v1

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

L-ID tal-mudell huwa l-isem eżatt li l-interfaċċa tuża biex tidentifika l-mudell. Uża dawn l-ismijiet għaż-żewġ mudelli:

• Għal Grok daħħal grok-4.7. L-interfaċċa ta’ xAI hija https://api.x.ai/v1, u t-talbiet taċ-chat jgħaddu minn /v1/chat/completions. Ara d-dokumentazzjoni tal-mudelli Grok.
• Għal Gemini daħħal gemini-3.8-flash. L-interfaċċa ta’ Google kompatibbli ma’ OpenAI hija https://generativelanguage.googleapis.com/v1beta/openai/. Ara l-ispjegazzjoni dwar il-kompatibbiltà ta’ Gemini ma’ OpenAI.

Jekk trid taqleb għal Gemini f’Hermes, ibdel biss l-isem tal-mudell għal gemini-3.8-flash; għall-indirizz tal-interfaċċa kompli uża l-indirizz ta’ OmniProxy.

Ikkopja l-indirizz tal-interfaċċa u ċ-ċavetta minn OmniProxy, imbagħad daħħal l-ID tal-mudell korrispondenti:

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

Base URL huwa l-indirizz tal-interfaċċa li lejh Hermes jibgħat it-talbiet; hawnhekk irid jintemm b’/v1. API Key hija ċ-ċavetta li OmniProxy jagħti lil Hermes. Ibdelha bil-valur tiegħek u tpoġġihiex fuq paġna pubblika.

Jekk OmniProxy lokali ma jeħtieġx ċavetta, tista’ tħalli API Key vojt; jekk l-indirizz jista’ jiġi aċċessat minn persuni oħra, għandek tuża ċavetta. Kun żgur ukoll li l-indirizz jista’ jiġi aċċessat mill-ambjent fejn qed jitħaddem Hermes. Jekk Hermes u OmniProxy jinsabu fuq l-istess kompjuter, tista’ tuża indirizz lokali.

Daħħal il-konfigurazzjoni tal-għodda

L-ewwel oħroġ miċ-chat li jkun għaddej, imbagħad eżegwixxi dan fit-terminal:

hermes model

Agħżel Custom endpoint (self-hosted / VLLM / etc.). Custom endpoint huwa endpoint personalizzat, jiġifieri Hermes jikkonnettja mal-indirizz tas-servizz li tispeċifika minflok ma juża sors issettjat minn qabel.

Il-wizard jistaqsi wieħed wara l-ieħor għall-indirizz tal-interfaċċa, iċ-ċavetta u l-isem tal-mudell. Daħħal it-tliet valuri mit-taqsima preċedenti. Jekk trid tuża Gemini, daħħal gemini-3.8-flash bħala l-isem tal-mudell.

Tista’ wkoll teditja direttament ~/.hermes/config.yaml. YAML huwa format ta’ test li juża l-indentazzjoni biex jirrappreżenta r-relazzjonijiet fil-konfigurazzjoni. Din hija l-konfigurazzjoni għal Grok:

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

Biex tuża Gemini, ibdel default għal gemini-3.8-flash; it-tliet valuri l-oħra jibqgħu l-istess:

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

Wara li ssalva, erġa’ ħaddem hermes u ibda chat ġdid. F’sessjoni li diġà hija miftuħa, /model jista’ jaqleb biss bejn sorsi li diġà ġew issejvjati; ma jistax iżid din il-konfigurazzjoni.

Ivverifika kompitu reali

1

hermes doctor

• Il-kontroll tal-installazzjoni għadda

2

Ibgħat messaġġ qasir

• Ara t-tweġiba ta' Hermes

3

Iftaħ ir-reġistru tas-sejħiet

• Iċċekkja l-isem tal-mudell

1. Ħaddem hermes doctor biex tivverifika li l-installazzjoni hija kompleta.
2. Ħaddem hermes u itolbu jispjega b’sentenza waħda x’jista’ jagħmel. Għandek tara tweġiba.
3. Iftaħ ir-reġistru tat-talbiet ta’ OmniProxy, ikkonferma li din it-talba ġiet minn Hermes u ċċekkja jekk l-isem tal-mudell huwiex grok-4.7 jew gemini-3.8-flash.

Il-fatt li l-wizard juri li l-konfigurazzjoni ġiet issejvjata, jew li l-interfaċċa tirritorna suċċess, mhuwiex biżżejjed biex juri li Hermes jista’ jwettaq kompitu għalik. L-isem tal-mudell fir-reġistru tat-talbiet irid jaqbel ma’ dak li daħħalt.

Jekk trid tiċċettja fil-browser, eżegwixxi dan fuq il-kompjuter lokali:

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

Imbagħad iftaħ http://127.0.0.1:9119. Dan l-indirizz jaħdem biss fuq il-kompjuter attwali.

Żbalji komuni

• Meta ddaħħal hermes, jidher messaġġ li l-kmand ma nstabx: agħlaq it-terminal u iftaħ tieqa ġdida. Jekk xorta ma jinstabx, kun żgur li ~/.local/bin jinsab fil-PATH; PATH hija l-lista ta’ postijiet fejn is-sistema tfittex id-direttorji tal-kmandi. Fuq Windows, kun żgur li d-direttorju tat-tħaddim miżjud mill-installatur jinsab fil-PATH.
• It-tniżżil tal-installazzjoni jinqata’ fin-nofs: erġa’ eżegwixxi l-istess kmand ta’ installazzjoni; il-partijiet li diġà tniżżlu jerġgħu jintużaw.
• Hermes ma jweġibx jew jgħid li ma jistax jikkonnettja: kun żgur li OmniProxy qed jaħdem u ċċekkja li Base URL jintemm b’/v1. Jekk Hermes qed jitħaddem f’Docker u OmniProxy jinsab fuq il-host, tużax 127.0.0.1, li huwa validu biss ġewwa l-container.
• Jidher żball taċ-ċavetta: aġġorna ċ-ċavetta ta’ OmniProxy u mbagħad ibdel api_key f’config.yaml. Iċ-ċwievet ta’ xAI jew Google jagħmlu parti mis-settings tal-fornitur f’OmniProxy; iddaħħalhomx f’dan il-qasam ta’ Hermes.
• Jidher messaġġ li l-mudell ma jeżistix: iftaħ il-lista attwali tal-mudelli f’OmniProxy u kkopja grok-4.7 jew gemini-3.8-flash eżattament kif jidher fil-lista.
• Hermes iwieġeb iżda ma jistax jagħmel affarijiet bħall-qari ta’ fajls jew l-eżekuzzjoni ta’ kmandi: aqleb għal mudell ieħor f’OmniProxy li għandu dawn il-kapaċitajiet, imbagħad iftaħ sessjoni ġdida ta’ Hermes.
• Il-programm jinsab fuq diska esterna u, wara li tiskonnettjaha, hermes doctor jirrapporta żball tal-ħażna: erġa’ qabbad dik id-diska. Tħallix lil Hermes jikteb sett ieħor ta’ konfigurazzjoni waqt li d-diska mhix imqabbda.

Referenzi uffiċjali

Għall-passi tal-installazzjoni, ara d-dokumentazzjoni tal-installazzjoni ta’ Hermes u l-appoġġ tal-pjattaformi. Għall-konfigurazzjoni ta’ Custom endpoint, ara d-dokumentazzjoni tal-Provider ta’ Hermes. Għall-ID tal-mudelli, ara rispettivament id-dokumentazzjoni tal-mudelli Grok u l-ispjegazzjoni dwar il-kompatibbiltà ta’ Gemini ma’ OpenAI.

L-installazzjoni fuq macOS tlestiet fid-2026-10-09 bl-użu ta’ Hermes Agent v0.21.6. grok-4.7 u gemini-3.8-flash kienu l-IDs standard tal-mudelli fid-dokumentazzjoni ta’ xAI u Google f’dik id-data. Meta ddaħħal il-valuri, uża l-ismijiet kif jidhru f’OmniProxy.

Ibdel kull placeholder b'valuri mill-konfigurazzjoni personali tiegħek ta' OmniProxy. Qatt ma npubblika key reali.

Risultat salvat jew HTTP 200 waħdu ma jipprovax kompatibilità sħiħa tal-Agent. Iċċekkja s-sors u l-mudell fir-rekord tat-talba ta' OmniProxy.

Sorsi uffiċjali · Hermes ↗