---
title: "Cómo desinstalar Hermes Agent limpiamente (Linux, Windows y Mac)"
description: "Eliminá Hermes Agent de macOS, Linux o Windows, incluido el CLI, repo, virtualenv, state directory, gateway service, app Desktop y caches opcionales de Playwright."
author: "Carlos García"
published: 2026-07-23
updated: 2026-07-23
language: es
human_url: "https://kiia.cloud/es/blog/desinstalar-hermes-agent/"
---

> **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](https://hermes-agent.nousresearch.com) 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.

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

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

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

```bash
hermes gateway stop
```

Si quedó como servicio managed:

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

```bash
rm -f ~/.local/bin/hermes
```

Root-mode:

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

### Paso 3: borrar el repo

Per-user:

```bash
rm -rf ~/.hermes/hermes-agent
```

Root-mode:

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

### Paso 4: borrar el virtualenv si no lo necesitás

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

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

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

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

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

Y si configuraste un `HERMES_HOME` custom:

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

## Si instalaste via Docker o NixOS

**Docker:** borra la imagen y los containers.

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

```bash
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](https://hermes-agent.nousresearch.com/docs/getting-started/installation#non-sudo--system-service-user-installs), 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:

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

## Verificación post-desinstalación

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

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

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

## 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 no los toca por defecto porque son útiles si vas a reinstalar y querés evitar la re-descarga. Para borrarlos: `rm -rf ~/.cache/ms-playwright`.

## Guía paso a paso

### Desinstalar Hermes Agent en Linux, Windows o macOS

Desinstalar el agente AI Hermes Agent limpiamente: gateway como servicio, state dir, virtualenv, repo, CLI, y opcionalmente los caches de Playwright.

**Tiempo total:** PT3M

**Herramientas:** macOS / Linux / WSL2 / Windows 10+ nativo, Hermes Agent CLI (`hermes`)

### 1. Parar el gateway y los procesos abiertos

Antes de desinstalar, cerrá cualquier REPL de `hermes` abierto y pará el gateway: `hermes gateway stop`. En Windows cerrá también Hermes Desktop si lo estás usando. Esto evita que queden handles abiertos sobre el binario o el venv que bloqueen la desinstalación.

### 2. Desactivar el servicio managed (si lo creaste)

En Linux: `systemctl --user disable hermes-gateway`. En macOS: `launchctl remove ai.hermes.gateway`. En Windows (PowerShell): `schtasks /Delete /F /TN "Hermes Gateway"`. Si instalaste Hermes Desktop en Windows, también salí del tray app.

### 3. Correr el uninstaller oficial

Ejecutá `hermes uninstall`. El uninstaller detecta el modo de install (per-user o root) y pregunta al final si querés conservar `~/.hermes/` (recomendado si pensás reinstalar) o borrarlo completo. Para forzar la versión no interactiva, podés responder `yes` a todo y borrar el directorio manualmente después.

### 4. Borrar el binario y el repo (manual)

Per-user: `rm -f ~/.local/bin/hermes` (symlink) y `rm -rf ~/.hermes/hermes-agent` (repo checkout). Root-mode: `sudo rm -f /usr/local/bin/hermes` y `sudo rm -rf /usr/local/lib/hermes-agent`. Si querés también borrar el venv: `rm -rf ~/.hermes/venvs`.

### 5. (Opcional) borrar config y caches

Si decidiste conservar `~/.hermes/` durante el uninstaller pero ahora querés resetear: `rm -rf ~/.hermes` (Linux/macOS) o `Remove-Item -Recurse -Force $env:USERPROFILE\.hermes` (Windows). Para los caches de Playwright: `rm -rf ~/.cache/ms-playwright` o `Remove-Item -Recurse -Force $env:LOCALAPPDATA\ms-playwright`.

### 6. Verificar la desinstalación

`which hermes` no debe devolver nada. `hermes doctor` debe reportar "command not found" (no es necesario correrlo, es solo sanity check). `ls ~/.hermes/` y `ls /usr/local/lib/` confirman que no quedan restos.