carlos.lat
Cómo desinstalar Hermes Agent limpiamente (Linux, Windows y Mac)

Cómo desinstalar Hermes Agent limpiamente (Linux, Windows y Mac)

23 de julio del 20266 minHermes Agent, Nous Research, IA, Tutorial, Uninstall

Respuesta corta (60 segundos): si el CLI sigue disponible, corré hermes uninstall — al final pregunta si querés conservar ~/.hermes/ (config para reinstalar futuro) o borrarlo. Después sacás el binario manual: rm -f ~/.local/bin/hermes y rm -rf ~/.hermes/hermes-agent. Si el gateway quedó como servicio: primero hermes gateway stop, después systemctl --user disable hermes-gateway (Linux), launchctl remove ai.hermes.gateway (macOS) o schtasks /Delete /F /TN "Hermes Gateway" (Windows). Para reset total incluyendo el venv y los caches de Playwright: rm -rf ~/.hermes ~/.cache/ms-playwright.

Hermes Agent es un agente AI local-first — eso es una ventaja cuando lo usás, pero también significa que toca varios lugares del filesystem y puede dejar restos si desinstalás a medias. Esta guía cubre los tres caminos: fácil con hermes uninstall, manual con control fino, y service-only si necesitás limpiar un servicio que quedó huerfano.

Antes de desinstalar: parar todo

Antes de correr el uninstaller, cerrá todo lo que pueda tener handles abiertos sobre el binario o el venv:

  • Cerrá cualquier REPL de hermes abierto en otras terminales.
  • Salí de Hermes Desktop si lo estás usando (Windows / macOS).
  • Pará el gateway: hermes gateway stop.

Por qué importa: en Windows, el hermes.exe queda bloqueado mientras algún proceso lo esté usando (Hermes Desktop, gateway, un REPL Python). Si intentás borrar el venv o el binario con handles abiertos, vas a recibir "access denied" o un rename fallido.

Camino 1 · Fácil con hermes uninstall (CLI presente)

Si hermes --version responde, este es el camino recomendado. El uninstaller detecta automáticamente si instalaste en per-user mode o root-mode y limpia lo que corresponde.

hermes uninstall

Al final del proceso, el uninstaller pregunta:

Keep ~/.hermes/ (config, auth, sessions, skills) for a future reinstall? [Y/n]

  • Y (default recomendado): conserva ~/.hermes/ — útil si pensás reinstalar y querés evitar reconfigurar provider keys, channels, etc.
  • n: borra ~/.hermes/ completo — empezás de cero la próxima vez.

Después de correr el uninstaller, te queda el binario en ~/.local/bin/hermes y el repo checkout en ~/.hermes/hermes-agent/. El uninstaller los borra en algunos casos; si quedaron, manual es:

rm -f ~/.local/bin/hermes           # symlink del binario
rm -rf ~/.hermes/hermes-agent       # checkout del repo
# Opcional: borrar el venv
rm -rf ~/.hermes/venvs

Si instalaste en root-mode (sudo):

sudo rm -f /usr/local/bin/hermes
sudo rm -rf /usr/local/lib/hermes-agent

Camino 2 · Manual paso a paso (CLI presente, control fino)

Si preferís entender cada paso (servidores con auditoría, setups custom, container cleanup), este es el orden.

Paso 1 · Parar el gateway

hermes gateway stop

Si quedó como servicio managed:

# Linux
systemctl --user disable hermes-gateway

# macOS
launchctl remove ai.hermes.gateway

# Windows (PowerShell)
schtasks /Delete /F /TN "Hermes Gateway"

Paso 2 · Borrar el binario

Per-user (default):

rm -f ~/.local/bin/hermes

Root-mode:

sudo rm -f /usr/local/bin/hermes

Paso 3 · Borrar el repo

Per-user:

rm -rf ~/.hermes/hermes-agent

Root-mode:

sudo rm -rf /usr/local/lib/hermes-agent

Paso 4 · (Opcional) borrar el venv

# Per-user
rm -rf ~/.hermes/venvs

# Root-mode
sudo rm -rf /usr/local/lib/hermes-agent/venv

Paso 5 · (Opcional) borrar config, auth, sesiones, skills

Si decidiste no conservar ~/.hermes/:

# Linux / macOS
rm -rf ~/.hermes

# Windows (PowerShell)
Remove-Item -Recurse -Force "$env:USERPROFILE\.hermes"

Paso 6 · (Opcional) borrar caches de Playwright

Chromium queda cacheado en ~/.cache/ms-playwright/ (Linux/macOS) o %LOCALAPPDATA%\ms-playwright\ (Windows). Pesan ~150-300 MB. Si no vas a reinstalar Hermes pronto o querés liberar espacio:

# Linux / macOS
rm -rf ~/.cache/ms-playwright

# Windows (PowerShell)
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\ms-playwright"

Camino 3 · Solo el servicio (instalación manual o servicio huerfano)

Si instalaste sin curl | bash (por ejemplo clonando el repo y armando un systemd unit a mano), o si el CLI ya no está disponible pero el servicio quedó corriendo:

Parar y desactivar el servicio

# Linux
systemctl --user stop hermes-gateway
systemctl --user disable hermes-gateway

# macOS
launchctl unload ~/Library/LaunchAgents/ai.hermes.gateway.plist   # si tenés el plist
launchctl remove ai.hermes.gateway

# Windows (PowerShell)
schtasks /Delete /F /TN "Hermes Gateway"

Borrar el binario y los archivos

rm -f ~/.local/bin/hermes
rm -rf /path/to/hermes-agent        # el path donde lo clonaste

Y si configuraste un HERMES_HOME custom:

unset HERMES_HOME
rm -rf /path/to/your/hermes/home

Si instalaste via Docker o NixOS

Docker: borra la imagen y los containers.

docker ps -a | grep hermes         # listar containers
docker rm -f hermes-gateway        # borrar container (ajustá el nombre)
docker images | grep hermes        # listar imágenes
docker rmi hermes-agent:latest     # borrar imagen

NixOS / Nix profile: las instalaciones Nix son inmutables y se manejan por generations.

nix profile list | grep hermes     # ver qué generations existen
nix profile remove hermes-agent    # borrar
# Opcional: limpiar generations viejas
nix-collect-garbage -d

Para setups con el módulo NixOS, remové el módulo de tu configuration.nix y rebuildeá.

Si instalaste como service user sin sudo

Si seguiste el patrón recomendado de install sin sudo, el service user tiene ~/.local/bin/hermes y ~/.hermes/. La desinstalación es la misma que per-user mode, pero ojo con el admin:

  • El admin que corrió sudo npx playwright install-deps chromium puede borrar esas libs de sistema con apt remove (son libs estándar de Chromium), pero no afectan a otros usuarios que no las necesiten.
  • Si creaste un symlink system-wide (sudo ln -s /home/hermes/.hermes/hermes-agent/venv/bin/hermes /usr/local/bin/hermes), recordá borrarlo:
sudo rm -f /usr/local/bin/hermes

Verificación post-desinstalación

Después de desinstalar, verificá que no quede nada:

# macOS / Linux
which hermes                           # no debería devolver nada
launchctl list | grep hermes           # no debería listar nada
systemctl --user list-units --type=service | grep hermes   # no debería listar nada
ls -la ~/.hermes 2>/dev/null           # No such file or directory (si borraste config)

# Windows (PowerShell)
Get-Command hermes -ErrorAction SilentlyContinue
Get-ScheduledTask | Where-Object {$_.TaskName -like "*Hermes*"}
Test-Path "$env:USERPROFILE\.hermes"   # False si borraste config

Si todo devuelve vacío / False, la desinstalación está completa.

¿Reinstalás más adelante?

Si pensás reinstalar (por ejemplo upgrade a una versión nueva), podés conservar ~/.hermes/:

# Parar daemon, conservar todo lo demás
hermes gateway stop
hermes uninstall         # responder "Y" a "keep ~/.hermes/"

Después de reinstalar, tu config y skills ya están donde tienen que estar — corré hermes doctor para confirmar que todo está sano.

¿Tenés algún edge case raro (instalación Docker, Nix, container, service account) o querés discutir si conviene conservar algo antes de desinstalar? Hay un CTA al final con una llamada gratis de 30 minutos.

Preguntas frecuentes

¿Cuál es el comando rápido para desinstalar Hermes Agent?

Si el CLI sigue disponible, corré `hermes uninstall` — te ofrece conservar `~/.hermes/` (config) para reinstalar futuro, o borrarlo completo. Después sacás el binario y el repo manual (ver abajo).

¿Cómo desinstalo si instalé como root o con sudo?

El uninstaller detecta el modo de install (per-user o root). En root-mode, los paths son `/usr/local/lib/hermes-agent/`, `/usr/local/bin/hermes` y `/root/.hermes/`. `hermes uninstall` los limpia; después `sudo rm -rf` si quedó algo.

¿Y si el gateway quedó corriendo como servicio managed?

Paralo primero: `hermes gateway stop`. Después en Linux: `systemctl --user disable hermes-gateway`. En macOS: `launchctl remove ai.hermes.gateway`. En Windows: `schtasks /Delete /F /TN "Hermes Gateway"` (o el nombre que uses).

¿Qué pasa con mi config (`~/.hermes/`) y el virtualenv?

El uninstaller pregunta al final si querés conservar `~/.hermes/`. Si decís "keep", queda todo (config, auth.json, sesiones, skills) y podés reinstalar sin reconfigurar nada. Si decís "remove", lo borra completo y empezás de cero.

¿Cómo borro el repo y el venv?

Manual: `rm -f ~/.local/bin/hermes` (saca el symlink del binario), `rm -rf ~/.hermes/hermes-agent` (borra el checkout del repo), y `rm -rf ~/.hermes/venvs` (borra los virtualenvs). Si instalaste en root-mode: `sudo rm -f /usr/local/bin/hermes && sudo rm -rf /usr/local/lib/hermes-agent`.

¿Y los caches que dejó Playwright/Chromium?

Quedan en `~/.cache/ms-playwright/` (Linux/macOS) o `%LOCALAPPDATA%\ms-playwright\` (Windows). `hermes uninstall` no los toca por defecto — son útiles si vas a reinstalar y querés evitar la re-descarga. Para borrarlos: `rm -rf ~/.cache/ms-playwright`.