Cum instalezi Hermes Agent pe Ubuntu

Hermes Agent este un asistent AI open-source care ruleaza direct pe serverul tau. Poate scrie cod, gestiona fisiere, rula comenzi, naviga pe internet si multe altele. In acest ghid, o sa vezi cum il instalezi pe un VPS proaspat cu Ubuntu.

Ce ai nevoie

• un VPS cu Ubuntu 20.04 sau mai nou

• acces SSH cu drepturi de sudo

• cam 15 minute

Pasul 1: Conecteaza-te la VPS

Daca nu ai facut-o deja, conecteaza-te prin SSH:

ssh root@adresa-ip-server

Inlocuieste adresa-ip-server cu IP-ul real al VPS-ului tau.

Pasul 2: Actualizeaza sistemul

Mereu incepe cu o baza curata:

sudo apt update && sudo apt upgrade -y

Pasul 3: Instaleaza Python si pip

Hermes are nevoie de Python 3.10 sau mai nou. Ubuntu 22.04+ vine cu el implicit, dar hai sa ne asiguram ca totul e in regula:

python3 --version

# Daca ai nevoie de Python 3.11
sudo apt install python3.11 python3.11-venv python3-pip -y

Pasul 4: Instaleaza uv (manager de pachete Python rapid)

Hermes foloseste uv intern. Instaleaza-l cu o singura comanda:

curl -LsSf https://astral.sh/uv/install.sh | sh

Dupa ce se termina instalarea, reincarca shell-ul:

source ~/.bashrc

Verifica daca a functionat:

uv --version

Pasul 5: Instaleaza Hermes Agent

Acum, momentul principal. Creeaza un director pentru Hermes si instaleaza-l:

mkdir -p ~/hermes && cd ~/hermes

# Descarca si ruleaza installer-ul
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | sh

Installer-ul va configura un mediu virtual si va descarca toate dependentele. Poate dura un minut sau doua, in functie de server.

Pasul 6: Configureaza cheia API

Hermes are nevoie de acces la un provider de LLM. Cel mai simplu este sa configurezi o cheie OpenRouter:

export OPENROUTER_API_KEY="cheia_ta_api"

Ca sa fie permanenta, adaug-o in configuratia shell-ului:

echo 'export OPENROUTER_API_KEY="cheia_ta_api"' >> ~/.bashrc
source ~/.bashrc

Poti obtine o cheie API gratuita de pe openrouter.ai/keys.

Pasul 7: Testeaza

Ruleaza un test rapid pentru a verifica daca totul e configurat corect:

# Verifica versiunea Hermes
hermes --version

# Porneste o sesiune interactiva
hermes

Daca totul a mers bine, ar trebui sa vezi Hermes pornind si asteptand comenzile tale.

Rulezi Hermes ca serviciu (optional)

Daca vrei ca Hermes sa mearga in fundal, configureaza-l ca serviciu systemd:

sudo nano /etc/systemd/system/hermes.service

Adauga asta:

[Unit]
Description=Hermes Agent
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/root/hermes
ExecStart=/root/hermes/.venv/bin/hermes
Restart=always
Environment=OPENROUTER_API_KEY=cheia_ta_api

[Install]
WantedBy=multi-user.target

Apoi activeaza si porneste:

sudo systemctl daemon-reload
sudo systemctl enable hermes
sudo systemctl start hermes
sudo systemctl status hermes

Probleme comune

"Command not found: hermes"

Installer-ul adauga Hermes in PATH, dar poate trebuie sa reincarci shell-ul:

source ~/.bashrc
# Sau deconecteaza-te si reconecteaza-te

"uv: command not found"

Asigura-te ca ~/.local/bin este in PATH:

export PATH="$HOME/.local/bin:$PATH"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

De aici incotro

• Citeste documentatia oficiala Hermes

• Vezi repository-ul GitHub

• Intra pe comunitatea de Discord sau GitHub Discussions