Instalarea Hermes și configurarea OmniProxy

Hermes este un asistent care poate reține conversațiile și experiența sarcinilor, transformând munca finalizată în abilități care pot fi reutilizate ulterior. Printr-un singur Gateway, se poate conecta și la Telegram, Discord, Slack, WhatsApp, Signal și terminal. Gateway-ul servește ca punct de intrare unificat pentru primirea și redirecționarea mesajelor. Îi poți trimite recenzii de cod, note de incident sau materiale pentru clienți din instrumentele tale obișnuite de chat, apoi îl poți pune să se întoarcă la depozit și să continue lucrul.

Înainte de a începe

Mai întâi, alege o metodă de instalare bazată pe sistemul de operare al computerului tău. macOS și Windows pot folosi direct instalatoare grafice, în timp ce Linux, macOS și WSL2 pot folosi un script de terminal. WSL2 este o funcție Windows pentru rularea unui mediu Linux. Termux pe telefoanele Android și Docker au propriile metode de instalare, dar acest ghid acoperă doar instalarea pe computere obișnuite.

Dorești o fereastră

macOS, Windows

• macOS: deschide DMG-ul
• Windows: deschide instalatorul
• Instalează aplicația pe sistem

Doar terminal

Linux, macOS, WSL2

• O comandă install.sh
• Folosește install.ps1 pe Windows
• Introdu hermes după instalare

Nu le folosi încă pe acestea

pip, brew, AUR

• Aceste metode de instalare nu sunt acceptate oficial
• Sunt, de asemenea, greu de actualizat după instalare
• Folosește una dintre cele două opțiuni din stânga în schimb

Înainte de a începe, pregătește un computer cu macOS, Windows sau Linux și asigură-te că poate deschide un terminal și accesa GitHub. Dacă intenționezi să instalezi Hermes pe o unitate externă, conectează unitatea mai întâi și confirmă că are suficient spațiu liber.

Instalare și prima lansare

Dacă dorești o aplicație grafică

Mergi la secțiunea de descărcare de pe site-ul Hermes și descarcă instalatorul pentru sistemul tău de operare. Instalatorul include deja mediul de execuție, deci nu trebuie compilat nimic local când îl deschizi pentru prima dată.

• macOS: Deschide DMG-ul și mută Hermes.app în Aplicații. Un DMG este o imagine de instalare utilizată frecvent pe macOS. Acest instalator acceptă doar Apple silicon; Mac-urile Intel nu sunt acceptate.
• Windows: Deschide fișierul .appinstaller cu Windows App Installer. Acesta instalează un MSIX semnat, un tip de pachet de aplicație utilizat de Windows.
• Linux: Instalatoarele desktop sunt pentru macOS și Windows. Pe Linux, folosește comanda de terminal de mai jos. După instalare, poți rula hermes desktop.

Dacă ai nevoie doar de terminal

Dacă folosești Linux, macOS sau WSL2, rulează acest lucru într-un terminal:

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

Când folosești PowerShell inclus cu Windows, rulează:

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

Instalatorul descarcă codul Hermes și programele necesare pentru a-l rula. Dacă descărcarea este întreruptă, rulează aceeași comandă din nou. După finalizarea instalării, închide terminalul curent, deschide o fereastră nouă și introdu:

hermes

Dacă vezi promptul Hermes, comanda este gata de utilizare. Poți rula apoi hermes doctor; această verificare a instalării îți spune ce mai lipsește.

Stocarea programului pe o unitate externă

La data de 9 octombrie 2026, Hermes Agent v0.21.6 a fost instalat pe o unitate externă conectată la un Mac. Programul a fost stocat la /Volumes/AItools/tools/hermes-agent, comanda de lansare a fost localizată la ~/.local/bin/hermes, iar datele de configurare și conversație au rămas în ~/.hermes.

Dacă unitatea ta are un nume diferit, înlocuiește calea după --dir cu propriul tău folder. Unitatea trebuie să rămână conectată în timp ce Hermes rulează.

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

Program

Unitate externă

• tools/hermes-agent
• Păstrează codul aici

Comandă

~/.local/bin/hermes

• Introdu hermes în terminal
• Intră în vigoare după deschiderea unei ferestre noi

Configurare și chat-uri

~/.hermes

• config.yaml este aici
• Ieși înainte de a deconecta unitatea

Obținerea valorilor de conexiune din OmniProxy

Aici, Hermes se conectează la OmniProxy în loc să se conecteze direct la Grok sau Gemini. Configurează URL-urile serviciilor Grok și Gemini în OmniProxy; nu le introduce direct în Hermes.

Computerul tău

Hermes

→

Gateway local

OmniProxy

• Include /v1 în adresă

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

Un ID de model este numele exact pe care API-ul îl folosește pentru a identifica un model. Folosește următoarele nume pentru cele două modele:

• Pentru Grok, introdu grok-4.7. API-ul xAI este https://api.x.ai/v1, iar cererile de chat folosesc /v1/chat/completions. Vezi documentația modelului Grok.
• Pentru Gemini, introdu gemini-3.8-flash. API-ul compatibil OpenAI al Google este https://generativelanguage.googleapis.com/v1beta/openai/. Vezi documentația de compatibilitate OpenAI a Gemini.

Pentru a comuta Hermes la Gemini, schimbă doar numele modelului în gemini-3.8-flash. Continuă să folosești adresa OmniProxy ca punct final API.

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

Base URL este punctul final către care Hermes trimite cereri. Trebuie să se termine cu /v1 aici. API Key este cheia pe care OmniProxy o emite către Hermes. Înlocuiește substituentul cu propria ta valoare și nu o publica pe o pagină publică.

Dacă instanța ta locală OmniProxy nu necesită o cheie, poți lăsa API Key gol. Dacă adresa este accesibilă oricui altcuiva, ar trebui să folosești o cheie. Confirmă, de asemenea, că adresa este accesibilă din mediul în care rulează Hermes. Dacă Hermes și OmniProxy sunt pe același computer, poți folosi o adresă locală.

Introducerea configurației instrumentului

Mai întâi, ieși din chat-ul curent, apoi rulează acest lucru într-un terminal:

hermes model

Selectează Custom endpoint (self-hosted / VLLM / etc.). Custom endpoint înseamnă că Hermes se conectează la o adresă de serviciu pe care o specifici în loc să folosească un furnizor presetat.

Expertul de configurare cere URL-ul punctului final, cheia și numele modelului în ordine. Introdu cele trei valori din secțiunea anterioară. Pentru a folosi Gemini, introdu gemini-3.8-flash ca nume al modelului.

Poți edita și ~/.hermes/config.yaml direct. YAML este un format text care folosește indentarea pentru a reprezenta relațiile de configurare. Următoarea configurație folosește Grok:

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

Pentru a folosi Gemini, schimbă default la gemini-3.8-flash și lasă celelalte trei valori neschimbate:

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

După salvare, rulează hermes din nou și începe un chat nou. Într-o sesiune deja deschisă, /model poate comuta doar între furnizorii care au fost deja salvați; nu poate adăuga această configurație.

Verificarea cu o sarcină reală

1

hermes doctor

• Verificarea instalării trece

2

Trimite un mesaj scurt

• Vezi un răspuns de la Hermes

3

Deschide jurnalele de cereri

• Verifică numele modelului

1. Rulează hermes doctor pentru a verifica dacă instalarea este completă.
2. Rulează hermes și cere-i să explice într-o singură propoziție ce poate face. Ar trebui să vezi un răspuns.
3. Deschide jurnalul de cereri OmniProxy, confirmă că cererea a venit de la Hermes și verifică dacă numele modelului este grok-4.7 sau gemini-3.8-flash.

Să vezi că expertul de configurare a salvat cu succes sau că API-ul a returnat un răspuns de succes nu este suficient pentru a arăta că Hermes poate finaliza sarcini pentru tine. Numele modelului din jurnalul de cereri trebuie să se potrivească cu valoarea pe care ai introdus-o.

Pentru a conversa într-un browser, rulează următoarele local:

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

Apoi deschide http://127.0.0.1:9119. Această adresă funcționează doar pe computerul curent.

Erori comune

• Introducerea hermes raportează că comanda nu poate fi găsită: Închide terminalul și deschide o fereastră nouă. Dacă comanda tot nu este găsită, confirmă că ~/.local/bin este în PATH. PATH este lista de directoare unde sistemul caută comenzi. Pe Windows, confirmă că directorul de lansare adăugat de instalator este în PATH.
• Descărcarea instalării se oprește pe parcurs: Rulează aceeași comandă de instalare din nou. Părțile deja descărcate vor fi reutilizate.
• Hermes nu răspunde sau raportează că nu se poate conecta: Confirmă că OmniProxy rulează și verifică dacă Base URL se termină cu /v1. Dacă Hermes rulează în Docker în timp ce OmniProxy rulează pe gazdă, nu folosi 127.0.0.1 dacă este valid doar în interiorul containerului.
• Apare o eroare de cheie: Actualizează cheia OmniProxy, apoi schimbă api_key în config.yaml. Cheia xAI sau Google aparține setărilor furnizorului OmniProxy; nu o introduce în acest câmp Hermes.
• Modelul este raportat ca indisponibil: Deschide lista curentă de modele în OmniProxy și copiază grok-4.7 sau gemini-3.8-flash exact așa cum apare în listă.
• Hermes răspunde, dar nu poate efectua sarcini precum citirea fișierelor sau executarea comenzilor: Treci la un alt model în OmniProxy care are acele capacități, apoi începe o sesiune Hermes nouă.
• Programul este pe o unitate externă și hermes doctor raportează o eroare de stocare după ce unitatea este deconectată: Reconectează unitatea mai întâi. Nu lăsa Hermes să creeze o configurație separată în timp ce unitatea este deconectată.

Referințe

Pentru pașii de instalare, vezi documentația de instalare Hermes și suportul pentru platforme. Pentru configurarea Custom endpoint, vezi documentația Furnizorului Hermes. Pentru ID-urile modelelor, vezi documentația modelului Grok și documentația de compatibilitate OpenAI a Gemini.

Procesul de instalare macOS a fost finalizat la data de 2026-10-09 folosind Hermes Agent v0.21.6. grok-4.7 și gemini-3.8-flash erau ID-urile standard de model în documentația xAI și Google la acea dată. Când introduci valorile, folosește numele afișate în OmniProxy.

Înlocuiește fiecare spațiu rezervat cu valori din propria ta configurare OmniProxy. Nu publica niciodată o cheie reală.

Un rezultat salvat sau HTTP 200 singur nu dovedește compatibilitatea completă a Agentului. Verifică sursa și modelul în înregistrarea de apeluri OmniProxy.

Surse oficiale · Hermes ↗