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

En 60 segundos: si el CLI todavía funciona, corré hermes uninstall y elegí si querés conservar ~/.hermes/ para una reinstalación futura. Después eliminá cualquier resto del binario y el repo con rm -f ~/.local/bin/hermes y rm -rf ~/.hermes/hermes-agent. Si el gateway corre como servicio, detenelo con hermes gateway stop y desactivalo con systemctl --user disable hermes-gateway en Linux, launchctl remove ai.hermes.gateway en macOS o schtasks /Delete /F /TN "Hermes Gateway" en Windows. Para un reset completo, incluido el virtualenv y los caches de Playwright, usá rm -rf ~/.hermes ~/.cache/ms-playwright.

Hermes Agent guarda componentes en varios lugares del filesystem. Una desinstalación incompleta puede dejar el binario, el repo, el virtualenv, el state directory o el gateway service. Esta guía cubre el uninstaller oficial, la limpieza manual y el camino para quitar un servicio huérfano.

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.

En Windows, hermes.exe queda bloqueado mientras Hermes Desktop, el gateway o un REPL de Python lo estén usando. Borrar el virtualenv o el binario antes de detener esos procesos puede producir un error de “access denied” o un rename fallido.

Camino 1: usar hermes uninstall

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/, lo que evita reconfigurar provider keys, channels y otros ajustes después de reinstalar.
• n: borra ~/.hermes/ completo, así que 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: borrar cada componente manualmente

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

Paso 1: detener 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: borrar el virtualenv si no lo necesitás

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

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

Paso 5: borrar config, auth, sesiones y skills si no los necesitás

Si decidiste no conservar ~/.hermes/:

# Linux / macOS
rm -rf ~/.hermes

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

Paso 6: borrar los caches de Playwright si no los necesitás

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: eliminar un servicio huérfano

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.

Si pensás reinstalarlo

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, la config y las skills que conservaste ya estarán en su lugar. Corré hermes doctor para verificar la instalación.

Antes de borrar ~/.hermes/, hacé una copia si contiene skills custom, configuración de providers o sesiones que puedas necesitar después. Los otros pasos de limpieza se pueden repetir; ese state directory no se recupera una vez eliminado.