> For the complete documentation index, see [llms.txt](https://docs.ititanhosting.ro/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ititanhosting.ro/docs/romana/vps/linux/cum-instalezi-hermes-agent-pe-ubuntu.md).

# 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:

```bash
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:

```bash
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:

```bash
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:

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

Dupa ce se termina instalarea, reincarca shell-ul:

```bash
source ~/.bashrc
```

Verifica daca a functionat:

```bash
uv --version
```

### Pasul 5: Instaleaza Hermes Agent

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

```bash
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:

```bash
export OPENROUTER_API_KEY="cheia_ta_api"
```

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

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

Poti obtine o cheie API gratuita de pe [openrouter.ai/keys](https://openrouter.ai/keys).

### Pasul 7: Testeaza

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

```bash
# 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:

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

Adauga asta:

```ini
[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:

```bash
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:

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

**"uv: command not found"**

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

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

### De aici incotro

* Citeste [documentatia oficiala Hermes](https://hermes-agent.nousresearch.com/docs)
* Vezi [repository-ul GitHub](https://github.com/nousresearch/hermes-agent)
* Intra pe comunitatea de Discord sau GitHub Discussions