Hermes Agent Quickstart: De la instalare la primii pași

De ce merită atenție Hermes

Dacă ai instalat vreodată un instrument AI nou, ai văzut binar aterizând în PATH, și totuși ai ajuns cu ceva care era tehnic prezent dar practic inutil, înțelegi deja problema pe care o rezolvă acest ghid de pornire rapidă Hermes Agent. O instalare finalizată doar dovedește că fișierele au fost copiate. Nu dovedește că agentul poate inspecta un repo, să vorbească cu un model real, să folosească instrumente în siguranță, sau să redeschidă munca mai târziu.

Asta e de ce merită atenție Hermes. Când funcționează corect, încetează să se simtă ca “ChatGPT într-un terminal” și începe să se comporte ca un agent operațional. Poate inspecta fișiere, folosi instrumente de terminal, să rămână în interiorul unui workspace, și să ducă sesiunea mai departe în loc să acționeze ca și cum fiecare prompt ar începe de la zero.

Asta o face o alegere bună pentru dezvoltatori, self-hosterii, și utilizatorii care preferă terminalul și care vor ajutor cu sarcini reale: rezumarea unei baze de cod, verificarea unui repo pe o mașină personală, sau rularea pe un VPS mic de la AlexHost, sau orice alt furnizor fără a sări direct într-o stivă de automatizare mai mare. La sfârșitul acestui ghid, vei avea Hermes instalat, configurat, testat pe o primă sarcină sigură, și cu succes reluat.

Ce este Hermes — și ce vă va ajuta cu adevărat să faceți acest ghid

Înainte de a executa orice comenzi, păstrați trei termeni separați. Cea mai mare parte a confuziei din prima rulare provine din colapsarea lor într-o idee vagă despre „AI”.

Tabelul următor vă oferă modelul mental de lucru pentru acest tutorial:

Acest articol vizează o singură stare de succes: o singură sesiune Hermes sigură și funcțională pe care o puteți porni, testa și relua. Nu este un ghid de implementare în producție. Nu este o prezentare completă a caracteristicilor. Este cea mai scurtă cale fiabilă către „Hermes funcționează pe mașina mea, și pot să o dovedesc.”

📝 Notă: Instalarea Hermes nu este același lucru cu configurarea Hermes. Binarele pot fi prezente și totuși inutilizabile până când nu executați hermes model și nu îl conectați la un provider și model.

Este posibil să observați că documentele oficiale oferă și hermes setup. Aceasta este valabilă, dar acest ghid intenționat separă instalarea de hermes model pentru ca să puteți vedea exact unde se întâmplă cea mai mare parte a succesului sau eșecului din prima rulare. De asemenea, rămânem clasic-CLI-first pentru reproducibilitate, deși hermes –tui există și utilizează aceleași sesiuni subiacente. În afara domeniului acestui ghid rapid: configurarea gateway-ului, cron, MCP, rețelistică model local, rutare multi-provider și întărire în producție.

Reguli de siguranță înainte de a oferi acces shell Hermes

Înainte de a testa orice agent cu acces la terminal, decideți unde este permis să greșească. Pentru acest articol, asta înseamnă o mașină non-producție, o VM, un repo jetabil, sau cel puțin un workspace cu risc scăzut unde o comandă accidentală nu vă va strica ziua.

⚠️ Avertisment: Păstrați aprobările în modul sigur implicit pentru întregul quickstart, și nu utilizați –yolo. Hermes cere aprobare înainte de comenzi riscante; aceasta este o caracteristică de siguranță, nu o fricțiune inutilă.

Utilizați această listă de verificare rapidă înainte de a continua:

• Începeți pe o mașină sau workspace cu risc scăzut.
• Păstrați prompturile de aprobare activate.
• Evitați repo-urile personale de producție pentru primul test.
• Așteptați-vă ca sarcina de dovadă să rămână doar pentru citire.
• Tratați Docker și SSH terminal backends ca pași de consolidare ulteriori, nu cerințe din prima zi.

Prima sarcină reală de dovadă din acest ghid rămâne în interiorul ~/.hermes/hermes-agent, ceea ce ține demo-ul relevant pentru Hermes, evitând în același timp proiectele sensibile. Odată ce fluxul CLI de bază este stabil, puteți trece către izolarea mai puternică cu Docker sau backend-uri la distanță. Pentru prima oră, sigur și verificabil este mai bun decât ambiţios.

Înainte de a instala: condiții preliminare, căi acceptate și o problemă WSL2

Pentru utilizatorii obișnuiți, povestea acceptată este simplă: Linux, macOS și WSL2 sunt căile de care trebuie să te gândești în primul rând. Windows nativ există, dar este încă în versiune beta timpurie, deci dacă ești pe Windows, recomandarea practică este încă WSL2.

Pe Ubuntu 24.04 sau WSL2, începe prin a te asigura că git și curl sunt disponibile:

sudo apt update && sudo apt install -y git curl

lsb_release -ds && git --version && curl --version

Dacă a doua linie returnează șirul distro-ului tău plus ieșire de versiune funcțională pentru ambele instrumente, condiții preliminare de bază sunt în loc. Pe macOS, verificarea echivalentă este de obicei doar confirmarea git –version și curl –version înainte de a folosi același instalator Hermes.

📝 Notă: Windows nativ este încă o cale în versiune beta timpurie, deci preferă WSL2 dacă ești pe Windows.
💡 Sfat: În WSL2, ține Hermes și repo-urile tale de lucru sub ~ în loc de /mnt/c pentru a evita operații Git mai lente și comportament ciudat al permisiunilor de fișiere.

Vestea bună este că Hermes nu te obligă să asamblezi manual o stivă gigantică de dependențe mai întâi. Instalatorul git oficial gestionează uv, Python 3.11, Node.js 22, ripgrep și ffmpeg pentru tine. Ceea ce ar trebui să ai gata înainte ca asistentul de configurare să înceapă este un cont de furnizor, sau cel puțin un plan testat pentru un endpoint personalizat. De asemenea, alege un model cu cel puțin 64K context: ferestre de context mai mici tind să se prăbușească odată ce agentul începe să transporte context de fișier, ieșire de instrumente și instrucțiuni cu mai mulți pași împreună.

Instalați Hermes Agent cu calea oficială one-line

Cu cerințele preliminare rezolvate, rulați instalatorul oficial exact așa cum este documentat:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Aceasta este acum mai mult decât un pas de instalare minimă. Hermes detectează platforma, pregătește dependențele de care are nevoie, și apoi continuă imediat în fluxul de configurare la prima rulare. În exemplul de mai sus, instalatorul detectează Linux, verifică pentru uv, instalează Python 3.11 unde este necesar, pregătește Node.js 22 pentru instrumente de browser, și construiește mediul de comandă Hermes.

Dacă instalarea este efectuată ca root, este posibil să vedeți căi precum /usr/local/bin/hermes, /usr/local/lib/hermes-agent, și /root/.hermes/. La o instalare de utilizator obișnuit, așteptați-vă aceeași structură sub propriul dvs. director home.

Detaliul important este că instalatorul one-line intră direct în asistentul de configurare. Cu alte cuvinte, instalarea și configurarea la prima rulare sunt un flux continuu. Nu tratați sfârșitul instalării pachetului ca linia de finish, deoarece Hermes nu este cu adevărat util până când acest asistent de configurare este completat.

Prima decizie este furnizorul de inferență. În această rulare, OpenRouter este selectat, ceea ce este o alegere practică la început deoarece oferă acces la un catalog larg de modele printr-un singur cont de furnizor. Dacă utilizați deja un alt furnizor suportat, alegeți acel în schimb.

Odată ce furnizorul este ales, Hermes cere cheia API corespunzătoare. În acest exemplu, aceasta înseamnă OPENROUTER_API_KEY. Lipiți cheia, apăsați Enter, și Hermes o stochează pentru utilizare viitoare.

Dacă omiteți acest pas, Hermes poate termina instalarea, dar nu va fi gata pentru o sesiune de agent real. Ar trebui să reveniți și să configurați furnizorul mai târziu.

După ce cheia este salvată, asistentul se mută la selectarea modelului. În această rulare, modelul selectat este deepseek/deepseek-v4-pro. Acesta este un exemplu concret valid, dar nu este singura dvs. cale: asistentul vă permite, de asemenea, să introduceți un nume de model personalizat sau să omiteți și să păstrați modelul curent dacă reluați configurarea pe o instalare existentă.

Pentru o primă rulare, regula practică este simplă: alegeți un model pe care știți deja că puteți accesa, și asigurați-vă că are suficient context pentru munca de agent real. Hermes este mult mai fiabil cu modele care oferă cel puțin o fereastră de context de 64K. Ferestrele de context mai mici pot arăta bine într-un test mic, apoi se defectează odată ce ieșirea instrumentelor, contextul fișierului și instrucțiunile multi-pas încep să se acumuleze.

Dacă doriți vreodată să schimbați această alegere mai târziu, hermes model este încă cel mai rapid mod de a relua selectarea furnizorului și modelului fără a reinstala nimic.

În continuare, Hermes întreabă cât din configurarea mai largă doriți să faceți chiar acum. Pentru acest ghid rapid, opțiunea recomandată este cea corectă: configurare rapidă.

Aceasta ține articolul concentrat pe calea care poartă sarcina: furnizor, model, și alegerile minime înconjurătoare necesare pentru a face Hermes utilizabil.

Ecranul următor întreabă despre backend-ul terminalului. Pentru o primă rulare, păstrați backend-ul local curent, astfel Hermes să ruleze direct pe această mașină. Docker, SSH, Modal și alte backend-uri sunt utile mai târziu, dar adaugă complexitate înainte ca voi să fi confirmat că fluxul de lucru CLI de bază funcționează.

Hermes apoi oferă configurarea platformei de mesagerie. Pentru acest ghid rapid, omiteți-o. Aceasta ține ghidul centrat pe fluxul de agent CLI de bază, și puteți adăuga Telegram, Discord sau o altă cale de mesagerie mai târziu cu hermes setup gateway.

Odată ce asistentul se termină, Hermes arată unde a stocat fișierele importante.

Împărțirea principală de reținut este simplă: config.yaml conține setări non-secrete, .env conține chei API și alte secrete, și directoarele de date conțin sesiuni, jurnale și stare de rulare conexă. În această captură de ecran căile sunt sub /root/.hermes/ deoarece instalarea a fost efectuată ca root. La o instalare de utilizator normal, citiți acele căi ca ~/.hermes/.

Hermes apoi tipărește rezumatul scurt gata de utilizare, inclusiv comenzile pe care sunteți cel mai probabil să le utilizați mai întâi.

În acest punct, Hermes este atât instalat cât și configurat. Următorul lucru de făcut este verificarea că mediul este sănătos înainte de a trece la prima sarcină reală:

hermes doctor

hermes doctor ar trebui să confirme elementele de bază: nicio aviz de securitate activ, un mediu Python care funcționează, și pachetele necesare prezente. Acesta este semnalul de succes curat pe care îl doriți înainte de a continua.

Dacă hermes nu este vizibil într-un shell nou încă, reîncărcați shell-ul și verificați calea comenzii înainte de a continua. Pe Bash aceasta înseamnă de obicei source ~/.bashrc; pe Zsh, source ~/.zshrc. Dacă este necesar, confirmați lansatorul cu command -v hermes.

Cu Doctor trecând, instalarea nu este doar terminată — Hermes este acum cu adevărat gata de utilizare.

Rulează prima ta sarcină de agent sigură

Cu Hermes acum instalat, configurat și verificat de hermes doctor, ești gata pentru prima demonstrație reală. Cel mai sigur spațiu de lucru cu semnal înalt pentru început este chiar directorul tău Hermes home. În această rulare, instalarea a fost făcută ca root, deci acel director este /root/.hermes. La o instalare normală a unui utilizator, același loc ar fi ~/.hermes.

Intră în acel director, confirmă unde te afli, și apoi lansează Hermes:

cd ~/.hermes
pwd
ls
hermes

Acesta este un bun spațiu de lucru pentru început, deoarece este deja prezent, direct legat de instrumentul pe care tocmai l-ai instalat, și cu risc scăzut comparativ cu lansarea unui agent într-un repo personal sau de producție. Ecranul de pornire este, de asemenea, o verificare de sănătate utilă în sine: arată Hermes lansând corect, modelul activ în subsol, și faptul că agentul poate deja vedea instrumentele și abilitățile sale disponibile.

Dacă preferi interfața mai nouă, hermes –tui este încă disponibil, dar acest ghid rămâne CLI-clasic-prim, deoarece este mai ușor de reprodus pas cu pas și ambele interfețe împărtășesc aceleași sesiuni.

Când Hermes se deschide, dă-i o instrucțiune simplă, doar pentru citire, care îi cere să inspecteze spațiul de lucru curent și să identifice punctul de intrare. În acest exemplu, instrucțiunea vizează în mod explicit /root/.hermes, deoarece instalarea a fost efectuată ca root. La o instalare normală a unui utilizator, indică-o către propriul tău director ~/.hermes.

Folosește următoarea instrucțiune:

Summarize this repo in 5 bullets and tell me what the main entrypoint is: ~/.hermes

Aceasta este exact felul de primă sarcină pe care o dorești: sigură, observabilă și ușor de verificat. În captura de ecran de mai sus, Hermes nu doar ghicește. Începe să citească fișiere concrete, cum ar fi config.yaml, SOUL.md, și .install_method, caută fișiere legate de Hermes și inspectează calea lansatorului instalat. Acea activitate vizibilă a instrumentului este dovada reală că Hermes se comportă ca un agent, nu ca o cutie de chat cu o singură lovitură.

Un rezultat sănătos ar trebui să revină cu un rezumat concret legat de spațiul de lucru și un punct de intrare verificabil. În această rulare, Hermes identifică wrapper-ul de comandă instalat la /usr/local/bin/hermes, explică că duce la punctul de intrare CLI Python, și rezumă mediul Hermes înconjurător în cinci puncte.

Acesta este semnalul de succes pe care trebuie să-l cauți. Răspunsul este specific, ancorat în fișiere pe care Hermes le-a inspectat cu adevărat, și ușor de verificat împotriva a ceea ce poți deja vedea pe disc. Nu trata rezultatul ca pe magie — compară rezumatul cu fișierele vizibile și aspectul directorului. Pentru o primă demonstrație, sigur și verificabil este mult mai bun decât strălucitor.

Reluați sesiunea și confirmați că configurarea funcționează cu adevărat

Quickstart-ul nu este terminat când Hermes răspunde o dată. Este terminat când confirmați că sesiunea poate fi reluată.

Utilizați comanda de reluare de mai jos; -c este forma scurtă pentru aceeași acțiune:

hermes --continue "<chat_name>"

Rezultatul așteptat este că Hermes redeschide cea mai recentă sesiune sau vă oferă un rezumat care aparține clar sarcinii pe care tocmai ați executat-o. Asta contează pentru că dovedește că Hermes nu acționează ca un chat unic și jetabil. Păstrează o sesiune de lucru durabilă la care puteți reveni.

Utilizați această listă de verificare compactă a succesului înainte de a continua:

• Hermes instalat și verificat
• Provider configurat
• Primul răspuns curat
• Prima sarcină repo completată
• Sesiunea reluată cu succes

Dacă reluarea nu funcționează, mai întâi asigurați-vă că utilizați același profil, apoi verificați sesiunile disponibile cu hermes sessions list. Odată ce hermes –continue funcționează, aveți linia de bază completă pe care a fost menită să o stabilească acest tutorial Hermes Agent.

Ce să încerci în continuare odată ce fluxul de bază funcționează

Odată ce chat-ul de bază este stabil, adaugă doar un singur nou strat la un moment dat.

💡 Sfat: Rezistă tentației de a activa imediat fiecare funcție avansată. Stabilizează mai întâi un flux de lucru curat, apoi extinde-te deliberat.

Iată meniul scurt cu pași sensibili pentru continuare:

• Încearcă hermes –tui dacă vrei interfața mai nouă de terminal peste același model de sesiune.
• Rulează hermes setup mai târziu dacă vrei vrăjitorul de configurare mai larg după ce înțelegi bazele manual.
• Explorează hermes gateway setup dacă următorul tău obiectiv este integrarea platformei de mesagerie.
• Revizuiește hermes tools și hermes skills când vrei expansiunea controlată a capacităților.
• Treci la un backend de terminal Docker sau SSH dacă agentul va începe să atingă sisteme cu mize mai mari.
• Folosește documentele oficiale pentru furnizori personalizați și puncte finale de modele locale odată ce calea găzduită funcționează deja.

Dacă vrei idei de continuare pentru utilizare reală, iată câteva bune de cercetat în continuare: note de onboarding codebase, redactare changelog, planificare refactor sigură, explicație fișier config, rezumate de revizuire pull request, liste de verificare VPS housekeeping, redactare runbook de deployment, prompturi de triage log și găsire de goluri în documentație.

Pentru căi mai profunde, leagă spre exterior în loc să întinzi acest quickstart într-un al doilea articol: quickstart-ul, documentele de instalare, ghidul CLI și ghidul de securitate sunt următoarele opriri corecte.

Acum aveți o configurare Hermes quickstart sigură și funcțională

Piatra de hotar importantă nu este că Hermes s-a instalat. Piatra de hotar importantă este că Hermes a devenit util. Acum aveți o linie de bază verificată: binarele sunt prezente, furnizorul este configurat, primul răspuns a funcționat, prima sarcină sigură s-a completat, iar sesiunea s-a reluat după aceea.

Acesta este locul potrivit pentru a vă opri și a profita de victorie. Păstrați aprobările activate, extindeți câte un strat la o dată, și mutați-vă către izolarea mai puternică atunci când agentul începe să lucreze la sarcini cu risc mai mare. Dacă veți rula eventual Hermes pe o stație de lucru personală, o cutie de laborator, sau un VPS de la AlexHost, sau oriunde altundeva, regula rămâne aceeași: câștigați încredere în pași mici.