# Instrucciones para el agente: Honcho para Hermes: aloja tu capa de memoria

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: avanzado
- Proyecto: https://github.com/elkimek/honcho-self-hosted (licencia GPL-3.0)
- Guía completa: https://lab.wisd.ai/hub/honcho-hermes-self-hosted

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

Comprueba que trabajas en Ubuntu 22.04+ con Hermes instalado y que dispones de acceso a un proveedor compatible con OpenAI. Verifica Docker Engine y el plugin Compose; si faltan, el script propone instalarlos.

Descarga el script, lee su contenido y solo entonces ejecútalo. La ruta rápida documentada es:

```sh
curl -sL https://raw.githubusercontent.com/elkimek/honcho-self-hosted/main/setup.sh -o /tmp/setup.sh
bash /tmp/setup.sh
```

El script solicita la URL del proveedor y sus claves, arranca Honcho en `http://localhost:8000` y, si encuentra Hermes, copia la configuración a `~/.honcho/config.json`. Comprueba esa dirección local y aplica el cambio con el comando que imprime:

```sh
hermes gateway restart
```

Desde `~/honcho`, revisa `docker compose logs -f api deriver` en otra terminal; deja de seguirlos con Ctrl+C. Inicia una conversación de prueba, aporta un dato ficticio distintivo y consulta ese dato en una sesión nueva para comprobar la memoria. El script comprueba `http://localhost:8000/openapi.json`; una API accesible por sí sola no demuestra que el proceso de memoria haya terminado.

## Comprobación

Comprueba que Hermes utiliza tu instancia y que una conversación de prueba puede recuperarse en otra sesión. Revisa también a qué proveedor se envían las llamadas.

## Si algo falla

Si falla la memoria, distingue conexión de Hermes, estado de la API y procesos de memoria en segundo plano. Revisa el despliegue y los requisitos del proveedor antes de cambiar la configuración.

Consulta [el README oficial](https://github.com/elkimek/honcho-self-hosted#readme) para requisitos y variantes de instalación.