Hermes Agent pe serverul tău
De la un VPS nou la un asistent AI care răspunde pe Telegram, funcționează 24/7 și rămâne sub administrarea ta. Ubuntu 24.04 LTS · instalare nativă + Docker · Telegram, securitate, backup.
Cuprins
Ce vei construi și ce trebuie să știi
Hermes Agent este un agent AI open source de la Nous Research, pe care îl instalezi pe propriul server. Ghidul acesta a fost pregătit pentru workshopul AI Coffee Lab și te duce de la un server gol până la un asistent care îți răspunde pe Telegram, pornește singur după restart și are backup.
La final trebuie să poți
- să te conectezi la server folosind SSH;
- să instalezi Hermes din sursa oficială;
- să alegi un provider de modele AI și să testezi conversația;
- să creezi propriul bot Telegram și să îi controlezi accesul;
- să activezi pornirea automată după reboot;
- să faci backup, actualizări și verificări de securitate.
Unde circulă mesajele și datele
Înainte să conectezi date de firmă, trebuie să înțelegi ce componentă rulează unde și cine o controlează.
| Componentă | Unde rulează | Cine controlează accesul |
|---|---|---|
| Hermes, memorie, configurare | VPS-ul ales | Administratorul serverului |
| Bot Telegram | Serviciul Telegram + gateway pe VPS | BotFather + lista de utilizatori Hermes |
| Model AI prin API | Furnizor extern | Contul și politica providerului |
| Model AI local | Server propriu, dacă există infrastructura | Administratorul infrastructurii |
Două moduri de instalare
Pentru primul Hermes recomandăm instalarea nativă pe un Ubuntu dedicat. Dacă folosești deja containere, alternativa Docker este descrisă integral mai jos.
Configurație de pornire recomandată
| Resursă | Recomandare |
|---|---|
| Procesor | 2 vCPU |
| RAM | 4 GB |
| SSD | 30–40 GB |
| Sistem | Ubuntu 24.04 LTS |
Valori orientative recomandate de One-IT, nu cerințe minime oficiale. Pentru automatizări grele în browser, multe integrări sau modele locale, necesarul crește. Cu un model AI prin API extern nu ai nevoie de GPU pe VPS.
Pregătește înainte de instalare
Notează-ți dinainte: adresa IP publică a serverului, utilizatorul Linux, numele pe care vrei să-l dai agentului și username-ul botului Telegram.
- Acces la panoul furnizorului VPS și la consola de recuperare.
- Un laptop cu terminal — PowerShell pe Windows, Terminal pe macOS sau Linux.
- Un cont Telegram.
- O metodă de plată sau credite pentru providerul AI, dacă folosești API.
- O adresă de email pentru administrarea conturilor.
ssh se rulează pe laptop.Traseul A · Instalare nativă, de la zero
Rulează pașii în ordine. Nu trece la Telegram până când Hermes nu îți răspunde corect într-o conversație de test din terminal.
A1 · Conectează-te prin SSH
Deschide PowerShell sau Terminal pe calculator. Înlocuiește utilizatorul și IP-ul cu cele reale.
PowerShell / Terminal de pe laptop
ssh UTILIZATOR@IP_SERVER
A2 · Verifică serverul
Aceste comenzi doar citesc informații. Verifici că ești pe Ubuntu și că ai spațiu liber.
Bash · Ubuntu / Linux
whoami cat /etc/os-release uname -m free -h df -h / sudo -v
A3 · Actualizează sistemul și instalează utilitarele
Instalează pachetele uzuale, inclusiv libatomic, necesar unor build-uri Node.js folosite de Hermes.
Bash · Ubuntu / Linux
sudo apt update sudo apt upgrade -y sudo apt install -y ca-certificates curl git tar xz-utils unzip \ coreutils libatomic1 openssl ufw unattended-upgrades sudo systemctl enable --now unattended-upgrades
A4 · Activează firewallul fără să pierzi SSH
Mai întâi permiți portul SSH, apoi activezi UFW. Exemplul presupune portul standard și profilul OpenSSH.
Bash · Ubuntu / Linux
sudo ufw allow OpenSSH sudo ufw default deny incoming sudo ufw default allow outgoing sudo ufw enable sudo ufw status verbose
ufw enable. Păstrează sesiunea deschisă și testează o a doua conectare înainte să o închizi.A5 · Descarcă installerul oficial și verifică sursa
Metoda de mai jos îți permite să citești scriptul înainte să-l rulezi. Verifică domeniul.
Bash · Ubuntu / Linux
curl -fsSLo /tmp/hermes-install.sh \ https://hermes-agent.nousresearch.com/install.sh less /tmp/hermes-install.sh bash /tmp/hermes-install.sh
Comanda rapidă echivalentă, indicată oficial: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash. Execută doar cod din surse verificate.
A6 · Finalizează configurarea Hermes
Installerul poate porni deja configurarea interactivă. Dacă a terminat fără ea sau vrei să o reiei, rulează wizardul.
Bash · Ubuntu / Linux
source ~/.bashrc hermes --version hermes setup
A7 · Alege providerul și testează primul dialog
hermes model deschide selectorul de model, hermes doctor face diagnosticul, iar hermes pornește conversația.
Bash · Ubuntu / Linux
hermes model hermes doctor hermes
Îl scrii după ce pornești hermes în terminal. Ieși apoi cu /quit sau Ctrl+C.
Salut! Spune-mi pe scurt ce poți face și confirmă că ești instalat pe serverul meu. Nu executa nicio comandă și nu modifica fișiere.
A8 · Creează botul Telegram — tu îi dai numele
Acesta este „botezul” agentului: alegi numele vizibil și username-ul.
- Deschide în Telegram @BotFather și verifică să fie contul oficial.
- Trimite
/newbot. - Alege numele afișat, de exemplu „Mira – Asistentul meu AI”.
- Alege un username unic terminat în
bot, de exemplumira_firma_bot. - Salvează tokenul într-un loc sigur. Nu-l trimite pe grupul workshopului.
- Scrie către @userinfobot ca să afli ID-ul numeric al contului tău Telegram.
/revoke și actualizezi configurarea Hermes.A9 · Conectează botul la Hermes și pornește gatewayul
Configurezi tokenul și lista de utilizatori autorizați. La început recomandăm doar propriul ID numeric. În wizard selectezi Telegram; dacă ai instalat deja serviciul permanent din wizard, nu e nevoie de o a doua instalare.
Bash · Ubuntu / Linux
hermes gateway setup hermes gateway install hermes gateway start hermes gateway status
A10 · Fă serviciul persistent și testează un restart
Pe Ubuntu, serviciul de utilizator rămâne pornit după logout dacă activezi „linger”. Nu trebuie să-ți lași laptopul pornit.
Bash · Ubuntu / Linux
sudo loginctl enable-linger "$USER" hermes gateway status hermes logs -f
Ctrl+C. Rulează separat sudo reboot, reconectează-te și verifică hermes gateway status. Trimite încă un mesaj pe Telegram.Alternativă pentru administratori: documentația oficială recomandă și sudo hermes gateway install --system pentru VPS-uri fără sesiune de utilizator. E o alternativă la serviciul de utilizator, nu ceva de configurat simultan pentru același profil.
Checklist: ai terminat instalarea de bază?
- Mă pot conecta prin SSH la server.
- Serverul rulează Ubuntu și are actualizările la zi.
- Firewallul permite SSH și blochează porturile nefolosite.
- Am folosit sursa oficială Nous Research.
- Hermes răspunde corect din terminal.
- Mi-am ales numele și username-ul botului.
- Doar ID-urile autorizate pot discuta cu botul.
- Botul îmi răspunde pe Telegram.
- Botul răspunde și după restartul serverului.
- Am creat și protejat o copie de siguranță.
Fă-l al tău: identitate, reguli, primul exercițiu
Un agent devine util când are un scop clar, instrucțiuni bune și un set redus de permisiuni.
~/.hermes/SOUL.md pentru identitatea de bază și directorul memories/ pentru memoria persistentă. Poți începe cu o conversație și verifici apoi ce s-a salvat.Primul mesaj prin care îi dai numele și regulile de bază.
Vreau să te numești [NUME]. Ești asistentul meu pentru organizarea sarcinilor de lucru. Comunică în limba română, clar și concis. Înainte să trimiți mesaje, să ștergi date sau să rulezi acțiuni cu efect extern, cere-mi acordul explicit. Nu presupune că ai acces la documente pe care nu ți le-am dat.
Un prim exercițiu util, fără date reale.
Ajută-mă să creez o listă de verificare pentru ofertele comerciale. Pune-mi cinci întrebări, una câte una, ca să înțelegi procesul. Nu te conecta la niciun sistem și nu prelucra date reale de clienți.
Verifici ce a înțeles agentul despre rolul lui.
Rezumă ce instrucțiuni ai despre rolul tău. Spune-mi clar ce informații nu cunoști și ce activități ar necesita aprobarea mea.
Securitate și responsabilitate (obligatoriu înainte de producție)
Un agent poate citi, scrie și executa comenzi în limitele permisiunilor primite. Tratează-l ca pe un cont tehnic cu puteri reale, nu ca pe un simplu chat.
--yolo și approvals.mode: off.Comenzi utile de verificare
Bash · Ubuntu / Linux
hermes doctor hermes config check hermes gateway status hermes logs -f sudo ufw status verbose
Activează autentificarea SSH cu chei și dezactivează parolele pentru SSH doar după ce ai testat accesul cu cheia într-o a doua sesiune.
Backup, restaurare, actualizare
Un backup Hermes poate conține chei API, tokenuri Telegram, conversații și memorii. Protejează-l ca pe o arhivă confidențială.
Backup complet
Rulează din contul Linux care administrează Hermes:
Bash · Ubuntu / Linux
mkdir -p ~/hermes-backups chmod 700 ~/hermes-backups hermes backup -o ~/hermes-backups/hermes-lab.zip chmod 600 ~/hermes-backups/hermes-lab.zip
Copiază apoi arhiva, criptată, într-o a doua locație. Nu o trimite pe un grup Telegram sau printr-un link public.
Actualizare controlată
Fă mai întâi backup, apoi:
Bash · Ubuntu / Linux
hermes --version hermes update hermes doctor hermes gateway restart hermes gateway status
Comanda de actualizare este pentru instalarea nativă. În Docker descarci o imagine nouă și recreezi containerul, fără să ștergi directorul de date.
Restaurare — doar după ce ai verificat arhiva
Restaurarea poate suprascrie configurații, tokenuri și conversații existente. Oprește gatewayul înainte de import. Dacă datele sunt importante, testează întâi pe un server separat.
Bash · Ubuntu / Linux
hermes gateway stop hermes import ~/hermes-backups/hermes-lab.zip hermes gateway start hermes doctor
Traseul B · Instalare alternativă în Docker
Alege acest traseu în locul instalării native, dacă lucrezi deja cu containere. Nu rula simultan aceeași configurație și același bot în două instanțe.
B1 · Instalează Docker pe Ubuntu
Dacă serverul are deja Docker Engine din sursele oficiale, sari peste instalare și doar verifică. Pe un Ubuntu curat, folosește depozitul oficial Docker:
Bash · Ubuntu curat · instalare Docker Engine
sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
-o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
sudo tee /etc/apt/sources.list.d/docker.sources >/dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io \
docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now docker
sudo docker run --rm hello-worldBash · verificare
docker --version sudo docker info
B2 · Pregătește volumul persistent
Directorul ~/.hermes conține configurația și datele. Nu-l șterge când recreezi containerul.
Bash · Ubuntu / Linux
mkdir -p "$HOME/.hermes" chmod 700 "$HOME/.hermes" sudo docker pull nousresearch/hermes-agent:latest
B3 · Rulează wizardul de instalare
Comanda este interactivă: configurezi providerul AI și, opțional, Telegram.
Bash · Ubuntu / Linux
sudo docker run -it --rm \ -v "$HOME/.hermes:/opt/data" \ nousresearch/hermes-agent:latest setup
$HOME/.hermes trebuie să indice mereu același director. Dacă apar erori de permisiuni, vezi secțiunea oficială despre UID/GID; nu le rezolva cu chmod 777.B4 · Testează providerul fără un serviciu public
Deschide o sesiune temporară în terminal, cu directorul de date existent. Închide sesiunea după test.
Bash · Ubuntu / Linux
sudo docker run -it --rm \ -v "$HOME/.hermes:/opt/data" \ nousresearch/hermes-agent:latest chat
Dacă versiunea afișează alte opțiuni, rulează ... nousresearch/hermes-agent:latest --help și consultă ghidul oficial.
B5 · Rulează gatewayul permanent
Botul Telegram funcționează prin conexiuni inițiate de server, așa că nu e nevoie să publici niciun port de intrare.
Bash · Ubuntu / Linux
sudo docker run -d \ --name hermes \ --restart unless-stopped \ -v "$HOME/.hermes:/opt/data" \ nousresearch/hermes-agent:latest gateway run
Dacă nu ai configurat Telegram în setup: sudo docker exec -it hermes hermes gateway setup, apoi sudo docker restart hermes.
B6 · Verifică loguri, restart și administrare
Repornești containerul, urmărești logurile și verifici mesajele pe Telegram.
Bash · Ubuntu / Linux
sudo docker ps --filter name=hermes sudo docker logs --tail 80 hermes sudo docker exec hermes hermes doctor sudo docker restart hermes sudo docker stats hermes
Oprești monitorizarea cu Ctrl+C. În producție, salvează argumentele exacte ale comenzii Docker, ca să poți recrea containerul.
B7 · Actualizează containerul fără pierderea datelor
Fă backup înainte, descarcă imaginea nouă și recreează containerul cu același director montat.
Bash · Ubuntu / Linux
sudo docker pull nousresearch/hermes-agent:latest sudo docker rm -f hermes sudo docker run -d \ --name hermes \ --restart unless-stopped \ -v "$HOME/.hermes:/opt/data" \ nousresearch/hermes-agent:latest gateway run
docker rm -f hermes șterge containerul, nu directorul de date de pe server. Nu rula rm -rf ~/.hermes. Pentru sisteme critice, testează versiunea nouă separat înainte de upgrade.Configurare manuală, loguri și fișiere
Util dacă wizardul nu funcționează sau vrei să înțelegi ce s-a salvat.
Unde sunt datele în instalarea nativă
Bash · Ubuntu / Linux
ls -la ~/.hermes ls -la ~/.hermes/logs hermes config
Exemplu .env pentru Telegram (nu-l publica)
Exemplu de conținut · ~/.hermes/.env
TELEGRAM_BOT_TOKEN=INLOCUIESTE_CU_TOKENUL_TAU TELEGRAM_ALLOWED_USERS=123456789
ID-ul trebuie să fie numeric, al contului tău. Mai simplu le configurezi prin hermes gateway setup. După editare manuală:
Bash · Ubuntu / Linux
chmod 600 ~/.hermes/.env hermes gateway restart
Comenzi de referință
| Comandă | Când o folosești |
|---|---|
hermes doctor | Diagnostic general după erori. |
hermes model | Adaugi sau schimbi providerul ori cheia API. |
hermes gateway status | Verifici procesul de mesagerie. |
hermes gateway restart | Reîncarci gatewayul după o modificare. |
hermes logs -f | Urmărești mesajele de diagnostic. |
journalctl --user -u hermes-gateway -f | Jurnalul systemd, dacă rulezi ca serviciu de utilizator. |
hermes config check | Verifici erorile de configurare. |
hermes backup | Creezi o arhivă de recuperare. |
Depanare: cele mai frecvente probleme
Testează pe rând. Nu schimba simultan serverul, modelul, botul și accesul — altfel devine greu de găsit cauza.
Primesc „hermes: command not found”. Ce fac?
Reîncarcă profilul shell cu source ~/.bashrc, verifică dacă există ~/.local/bin/hermes, apoi reconectează-te prin SSH. Dacă installerul a eșuat, consultă logul instalării și rulează din nou scriptul oficial.
Hermes este instalat, dar modelul nu răspunde. De ce?
Rulează hermes doctor și hermes model. Verifică providerul, creditul sau abonamentul, numele modelului, cheia API și conexiunea la Internet. Nu trece la gateway până când conversația din terminal nu funcționează.
Botul Telegram nu răspunde deloc. Ce verific?
Verifică hermes gateway status și hermes logs -f, apoi rulează din nou hermes gateway setup ca să confirmi tokenul. În Docker folosește sudo docker logs hermes. Asigură-te că ai apăsat Start în conversația cu botul.
Botul îmi răspunde „unauthorized”. De ce?
Lista de acces folosește ID-ul numeric, nu username-ul Telegram. Afli ID-ul de la @userinfobot și verifici valoarea TELEGRAM_ALLOWED_USERS. Nu folosi * — asta ar autoriza oricine.
Apare că tokenul Telegram e folosit în altă parte. Ce înseamnă?
Probabil rulează două gatewayuri cu același token, de exemplu instalarea nativă și Docker, sau serverul vechi și cel nou. Oprește instanța duplicat și repornește doar instanța aleasă.
Botul se oprește după logout sau restart. Cum rezolv?
La instalarea nativă verifică hermes gateway install, hermes gateway start și sudo loginctl enable-linger "$USER". În Docker, containerul trebuie pornit cu --restart unless-stopped.
Docker raportează „permission denied”. Ce fac?
Verifică cine deține directorul ~/.hermes. Containerul folosește un utilizator non-root, iar opțiunile HERMES_UID și HERMES_GID pot fi necesare. Evită chmod 777 pe date care conțin secrete.
Providerul AI costă mai mult decât mă așteptam. De ce?
Verifică tarifele curente pe tokenuri și unelte, limitele de buget, modelele implicite și automatizările care rulează în fundal. Nu confunda prețul VPS-ului cu factura de inferență.
Vreau o interfață web pe Internet. Se poate?
Da, dar dashboardul și API-ul nu trebuie expuse fără autentificare. Folosește documentația oficială, un reverse proxy cu HTTPS și restricții de acces. Pentru început, Telegram e suficient.
Ce costă un agent AI găzduit de tine
Costul lunar are patru componente. Valorile depind de ofertele furnizorilor și de cât folosești agentul.
| Componentă | Ce include | De ce depinde |
|---|---|---|
| Server (VPS) | Serverul pe care rulează Hermes | Planul ales și furnizorul |
| Model AI / API | Răspunsurile generate de model | Modelul, volumul de mesaje, automatizările din fundal |
| Backup și monitorizare | Copii de siguranță, alertare | Spațiul de stocare și serviciul folosit |
| Alte integrări | Servicii terțe conectate | Ce conectezi la agent |
Cum îl pregătești pentru o firmă
Instalarea e doar începutul. Într-o firmă, obiectivul este un agent care produce rezultate măsurabile, cu limite, aprobări și responsabilități clare.
| Întrebare pentru administrator | Decizie de luat |
|---|---|
| Cine poate scrie agentului? | Utilizatori, grupuri și roluri permise explicit. |
| Ce date primește? | Clasificare, minimizare, retenție și scop. |
| Ce acțiuni poate executa? | Listă limitată; aprobare umană pentru acțiunile importante. |
| Cine răspunde de costuri? | Buget API, alertare, monitorizare. |
| Cine intervine când cade? | Responsabil tehnic, backup, restaurare, escaladare. |
| Cum măsurăm beneficiul? | Ore economisite, timp de răspuns, erori, satisfacție. |
Surse oficiale și documentație
- Instalare oficială Hermes Agent
- Quickstart: instalare, provider, test
- Telegram: bot, token, allowlist
- Messaging Gateway: serviciu permanent
- Documentație Docker: imagine oficială
- Securitate Hermes: protecții și aprobări
- Configurare și fișiere Hermes
- Referință comenzi CLI
- Actualizare Hermes
- Backup și transfer
- Domenii oficiale și protecție anti-phishing
- Modele și provideri
- Cron și automatizări Hermes
- Depozit oficial GitHub
- Ubuntu Server: OpenSSH
- Ubuntu Server: securizare generală
- Docker Engine: instalare pe Ubuntu
Vrei ca AI-ul să lucreze automat în firma ta?
Biblioteca te ajută să folosești AI-ul cu mâna ta. Când vrei ca AI-ul să răspundă clienților, să completeze documente sau să gestioneze marketingul automat, One-IT implementează soluția potrivită pentru afacerea ta.