Aprende a instalar, configurar y usar Hermes Desktop y Hermes Agent con memoria, herramientas, automatización y mensajería desde cero.

Hermes Desktop facilita la instalación, la configuración y el uso diario de Hermes Agent desde una interfaz visual, mientras que la terminal ofrece un control más fino para automatización, diagnóstico e integración avanzada. La forma más útil de entender el sistema es verlo como una misma plataforma con dos entradas complementarias: una visual para operar con mayor comodidad y otra textual para trabajar con máxima precisión.

¿Qué es Hermes Desktop?

Hermes Desktop es la aplicación de escritorio recomendada en la documentación oficial de Hermes Agent para usar el agente en local con una interfaz visual. Desde la experiencia del usuario, se presenta como el escritorio “oficial” de Hermes: aparece en la web de Nous Research, comparte marca y se distribuye junto al flujo de instalación estándar.

Al mismo tiempo, el código del companion vive en un repositorio independiente mantenido por la comunidad (el proyecto de fathah en GitHub), donde se describe como un Desktop Companion for Hermes Agent. Eso significa que el núcleo del agente es un proyecto oficial de Nous Research, mientras que la interfaz de escritorio es un companion comunitario al que el equipo de Hermes da visibilidad y soporte documental.

Este matiz es útil por dos motivos: aclara dónde reportar incidencias (núcleo del agente vs interfaz) y explica por qué la numeración de versiones del agente (0.15.x) no coincide con la numeración de la app de escritorio (0.5.x).

¿Dónde se descarga Hermes Desktop?

La vía de descarga recomendada es la página oficial de Hermes Desktop en la web de Nous Research, que enlaza directamente los instaladores de escritorio, y la sección de lanzamientos del proyecto en GitHub, donde se publican las releases y notas de versión más recientes.

Desde la página oficial encontrarás descargas para macOS 12+, Windows 10/11 y la ruta de instalación para Linux:

• Mac OS: instalador .dmg desde la página de Desktop.
• Windows: instalador .exe para Windows 10/11.
• Linux: instalación vía terminal siguiendo la documentación oficial.

El companion comunitario se distribuye además en GitHub con su propio número de versión (por ejemplo, 0.5.5), mientras que en la web de Hermes se indica la versión del agente (por ejemplo, 0.15.2). Esa diferencia es normal: el instalador de escritorio empaqueta o conecta con una versión concreta del agente, pero mantiene su propia numeración como aplicación.

¿Qué significan las versiones 0.15.x y 0.5.x?

Hermes Agent usa una numeración de versiones en la rama 0.15.x, visible en su repositorio oficial y en la documentación (por ejemplo, Hermes Agent v0.15.2). Ese número se refiere al núcleo del agente: la lógica que gestiona memoria, herramientas, tareas, gateways y mensajería.

Hermes Desktop, en cambio, usa su propia numeración de versiones en GitHub, como 0.5.5. Esa versión se refiere a la aplicación de escritorio en sí: la interfaz, los flujos guiados y las mejoras específicas del companion. Cuando descargas Hermes Desktop, la app instala o se conecta con una versión 0.15.x del agente por debajo, de ahí que veas dos numeraciones distintas en documentación y repositorios.

¿Qué es Hermes Agent?

Hermes Agent es el sistema principal. La documentación pública lo presenta como un agente de inteligencia artificial con memoria persistente, herramientas, habilidades, continuidad entre sesiones, programación de tareas y capacidad de operar mediante canales externos de mensajería. Es un proyecto de código abierto de Nous Research, distribuido bajo licencia MIT.

En términos prácticos, el agente es quien responde, conserva contexto, ejecuta acciones, incorpora procedimientos reutilizables y mantiene continuidad operativa. La aplicación de escritorio solo vuelve más accesibles esas funciones para quien prefiere una experiencia menos dependiente de la terminal. Cuando algo funciona o falla, el comportamiento depende casi siempre del agente, del proveedor elegido, del gateway y de la configuración, no únicamente de cuál interfaz se esté usando.

¿Son independientes las configuraciones de Hermes Desktop y Hermes Agent?

Hermes Desktop y la terminal forman parte del mismo ecosistema, pero no gestionan la configuración de forma idéntica. El agente utiliza una carpeta base para almacenar modelos, herramientas, memoria, habilidades y credenciales, y la app de escritorio se apoya en ese núcleo para ofrecer una vista visual de buen parte de esos elementos.

Sin embargo, la forma en que cada interfaz lee y aplica esa configuración puede diferir. Es posible, por ejemplo, que un modelo funcione correctamente en la terminal y, aun así, la aplicación de escritorio muestre un gateway offline si su panel interno no tiene el mismo proveedor, endpoint, gateway o credenciales configurados. Por eso, aunque compartan base de datos, no conviene prometer que toda configuración realizada en CLI se reflejará siempre de forma automática en la Desktop App, ni al revés.

En escenarios mixtos, la recomendación práctica es esta: configurar primero un proveedor y un modelo estables, validar que la conversación funciona en la terminal y, después, abrir la aplicación de escritorio para comprobar que detecta el mismo estado. Si la interfaz visual marca gateway offline, hay que revisar perfil, proveedor, endpoint y claves antes de asumir que el problema está en el modelo.

¿Cuáles son los requisitos del sistema?

La documentación oficial de Hermes Agent confirma que el agente se puede instalar en Linux, macOS, WSL2 y Windows nativo, con guías específicas para cada caso. En Windows, el instalador añade el comando hermes al PATH del usuario, sin necesidad de privilegios de administrador.

Para Hermes Desktop, la página oficial de escritorio ofrece instaladores para macOS 12 o superior y Windows 10/11, así como instrucciones para trabajar con Linux desde la terminal. Antes de instalar conviene revisar la release concreta, la arquitectura compatible (Intel/Apple Silicon en macOS, x64 en Windows) y las notas de versión o checksums publicados.

¿Qué incluye Hermes Desktop?

La aplicación de escritorio reúne en un solo lugar funciones que en la terminal se distribuyen entre comandos y archivos: instalación guiada, elección de proveedor y modelo, chat, sesiones, perfiles, memoria, habilidades, herramientas, tareas programadas, gateways y conectores de mensajería. Su objetivo es que el usuario pueda instalar, configurar y usar Hermes sin aprender primero todos los comandos de la CLI.

Esto la vuelve especialmente útil para revisar memoria, historial, sesiones y perfiles con mayor claridad visual, y para que equipos mixtos (técnicos y no técnicos) compartan el mismo entorno sin depender exclusivamente de la línea de comandos.

¿Qué ofrece la terminal?

La terminal sigue siendo la capa más flexible para instalación avanzada, actualización, automatización y diagnóstico. La documentación oficial incluye una guía de instalación rápida, un asistente de configuración (hermes setup) y comandos específicos para ajustar proveedor, modelo, herramientas, gateways, mensajería y configuración general.

Para perfiles técnicos, la CLI permite repetir procesos, ejecutar scripts, revisar logs, validar rutas, lanzar el modo TUI (hermes --tui) y recuperar sistemas que hayan quedado en estados extraños. La app de escritorio se apoya en ese mismo núcleo, pero no sustituye la capacidad de diagnóstico fino que ofrece la terminal.

¿Cuál elegir: escritorio o terminal?

La elección depende del trabajo que se quiera hacer. La aplicación de escritorio conviene para instalación guiada, exploración del sistema, operación diaria y revisión visual de memoria, sesiones y perfiles. La terminal conviene cuando se necesita repetir procesos, automatizar, diagnosticar con precisión o integrar el agente con otros sistemas y servidores.

La recomendación práctica es combinar ambas rutas: usar Hermes Desktop para operar y supervisar con agilidad y la terminal para afinar, automatizar, corregir y escalar.

¿Cómo debería empezar un principiante?

Un principiante necesita una secuencia corta, clara y comprobable. La mayoría de los problemas no aparece porque la plataforma sea demasiado compleja, sino porque se intenta resolver todo al mismo tiempo.

1. Instalar el sistema base (Desktop o CLI).
2. Elegir un único proveedor y un único modelo.
3. Validar una conversación simple.
4. Comprobar que la sesión se guarda y se puede retomar.
5. Activar pocas herramientas.
6. Explorar memoria e historial.
7. Dejar mensajería y automatización para una etapa posterior.

Este orden permite saber con claridad dónde aparece el primer fallo, lo que simplifica mucho el diagnóstico.

¿Cómo debería empezar un usuario avanzado?

Un usuario avanzado no necesita una entrada más compleja, sino más disciplinada. Lo recomendable es definir antes de empezar qué proveedor será el principal, cuál será el entorno de prueba, qué herramientas son realmente necesarias y qué partes del sistema conviene mantener separadas.

1. Definir proveedor principal y, si hace falta, proveedor secundario.
2. Separar un perfil estable y un perfil de pruebas.
3. Activar solo las herramientas necesarias.
4. Validar el flujo base antes de automatizar.
5. Agregar mensajería cuando el entorno principal ya sea fiable.
6. Usar habilidades solo para tareas repetitivas bien definidas.

¿Cómo se instala Hermes Agent?

La instalación rápida se explica en la documentación oficial de Hermes Agent. En sistemas compatibles, se puede usar un instalador de línea de comandos que prepara el entorno y deja listo el comando hermes. En Windows, existe además un instalador nativo que coloca el agente en la carpeta de datos de usuario y añade el ejecutable al PATH.

Si se prefiere trabajar desde la app de escritorio, Hermes Desktop integra este flujo de instalación y guía al usuario en los pasos iniciales sin necesidad de escribir comandos manuales. En ambos casos, el objetivo es llegar a un punto en el que el agente arranque sin errores y esté asociado a un proveedor y un modelo válidos.

¿Qué debe validarse después de instalar?

La instalación solo cubre el primer tramo. Antes de activar memoria avanzada, mensajería o tareas programadas, conviene comprobar cinco puntos básicos:

• Que el agente arranque sin errores visibles.
• Que el proveedor quede configurado correctamente.
• Que el modelo responda a una consulta simple.
• Que la sesión pueda guardarse y retomarse.
• Que una herramienta básica funcione cuando se la invoca.

Si alguno de estos pasos falla, no tiene sentido añadir más capas. Primero hay que estabilizar la base.

Proveedor, modelo y gateway

Hermes Agent admite múltiples proveedores y permite configurar modelos, gateways y endpoints de forma bastante flexible. Esto es una ventaja, pero también introduce un matiz importante: la app de escritorio y la CLI pueden no estar leyendo exactamente el mismo estado de proveedor, modelo y gateway si se han configurado por caminos distintos.

En la práctica, puede ocurrir que la terminal utilice un modelo sin problemas, mientras que Hermes Desktop muestre un gateway offline porque su panel interno no tiene configurado ese mismo endpoint, o porque espera que el gateway se haya activado mediante un comando o asistente específico. En entornos mixtos, siempre conviene verificar en qué gateway y qué modelo está realmente trabajando el agente antes de culpar al modelo o al sistema en general.

¿Cómo interpretar el error “Gateway offline”?

Si Hermes Desktop muestra Gateway offline pero la terminal funciona, no significa necesariamente que el sistema esté roto. El caso más habitual es una desalineación entre lo que la CLI considera activo y lo que la app de escritorio espera encontrar en su configuración.

Las causas más frecuentes son:

• Proveedor o modelo configurados en la terminal, pero no seleccionados o reconocidos en el panel de Desktop.
• Perfiles distintos entre CLI y Desktop (no se está usando el mismo entorno lógico).
• Endpoint o gateway definidos en un sitio y ausentes en el otro.
• Credenciales guardadas en el entorno de terminal que no han sido introducidas o actualizadas en la interfaz visual.

La secuencia razonable de diagnóstico es esta: verificar proveedor y modelo en la terminal, comprobar que un chat sencillo funciona, abrir Hermes Desktop, revisar qué proveedor y gateway tiene seleccionados y, si sigue marcando offline, ajustar ese estado hasta que coincida con el entorno que ya sabes que funciona.

¿Qué es la memoria?

La memoria permite conservar hechos, preferencias, restricciones y datos útiles entre sesiones. Hermes no usa una única “memoria mágica”, sino un sistema por capas: memoria de sesión para el contexto inmediato, memoria duradera para hechos y preferencias estables, y búsqueda sobre el historial de sesiones para recuperar conversaciones pasadas.

En la aplicación de escritorio, esa memoria gana una ventaja práctica: puede revisarse y editarse de forma visual. Esto ayuda a entender qué está reteniendo el sistema y reduce la opacidad que a veces vuelve incómodo el uso de otros agentes solo por terminal.

¿Cómo usar la memoria sin crear desorden?

La memoria es valiosa cuando guarda información estable: preferencias editoriales, convenciones de proyecto, restricciones técnicas, rutas de trabajo y hábitos duraderos. No lo es cuando se llena de detalles temporales, duplicados o ruido de sesiones antiguas.

Conviene tomar una decisión explícita: qué merece quedarse en memoria duradera y qué no. Una memoria bien cuidada hace que el sistema gane utilidad con el tiempo; una memoria descuidada se parece a un archivo caótico que entorpece cada nueva sesión.

¿Qué son las habilidades?

Las habilidades son instrucciones reutilizables para resolver tareas específicas. En Hermes, una habilidad se comporta como un procedimiento documentado: describe pasos, herramientas a usar y condiciones de éxito para que el agente pueda repetir una tarea compleja sin rediseñarla cada vez.

El sistema puede trabajar con habilidades instaladas y también generar nuevas a partir de experiencia en tareas no triviales. Pero que una habilidad pueda generarse automáticamente no significa que siempre deba hacerse: tiene sentido convertir algo en habilidad solo cuando existe repetición y una expectativa de resultado clara.

¿Cómo empezar con habilidades?

1. Detectar una tarea que se repite con frecuencia.
2. Definir con claridad el resultado esperado.
3. Resolver manualmente esa tarea varias veces.
4. Comprobar que el procedimiento es estable.
5. Solo entonces adoptar o crear una habilidad.

Este método evita uno de los errores más comunes: transformar demasiado pronto una idea vaga en una rutina formal. Las habilidades funcionan mejor cuando nacen de un patrón confirmado, no de un impulso aislado.

¿Cómo diferenciar memoria y habilidades?

La memoria conserva información útil sobre el usuario, el proyecto o el entorno. La habilidad conserva un procedimiento. Si el sistema necesita recordar que cierto proyecto exige un tono técnico concreto, eso pertenece a la memoria. Si necesita ejecutar siempre una secuencia fija para revisar un repositorio y producir un informe, eso pertenece a una habilidad.

Separar ambas capas desde el principio mejora el orden del sistema y facilita su mantenimiento, especialmente cuando se trabaja con varios perfiles y canales de mensajería.

¿Cómo conviene usar perfiles?

Los perfiles sirven para separar contextos y configuraciones. Cada perfil puede tener su propia combinación de proveedor, herramientas, habilidades, memoria y gateways. Esto es útil cuando una persona trabaja en varios frentes o cuando un equipo necesita separar pruebas, producción y automatización sin contaminar un entorno con otro.

Una organización simple y eficaz puede incluir un perfil estable para trabajo diario, uno de pruebas para experimentar con modelos y herramientas, y otro dedicado a mensajería o tareas programadas. En Hermes Desktop, esta separación se hace visible mediante listas de perfiles; en la terminal, a través de comandos y archivos de configuración.

¿Cómo conectar mensajería de forma segura?

Hermes puede operar mediante varios canales externos (por ejemplo, Telegram o Discord) a través de un gateway de mensajería. Esto permite recibir respuestas, activar tareas o consultar el agente desde otros dispositivos, pero introduce nuevas superficies de riesgo.

La recomendación prudente es no activar mensajería hasta que el entorno base funcione bien: el chat local debe ser estable, la memoria debe comportarse de manera predecible y las herramientas críticas deben estar probadas. Añadir mensajería sobre una base inestable solo complica el diagnóstico.

¿Cuándo activar mensajería?

Hay tres condiciones razonables antes de conectar canales externos:

• El chat local funciona con estabilidad.
• La sesión y la memoria se comportan de forma predecible.
• Existe un caso de uso concreto (consultas remotas, avisos, tareas desencadenadas desde otra plataforma).

Si esas tres condiciones no se cumplen, la mensajería probablemente todavía no sea prioritaria. En la guía conviene dejar claro que “se puede”, pero que no siempre “se debe” en la primera semana de uso.

¿Cómo usar tareas programadas?

Hermes incluye un sistema de tareas programadas (cron) que permite ejecutar rutinas periódicas, a menudo combinadas con memoria, herramientas y mensajería. Es una de las funciones que más valor aporta a medio plazo, pero también una de las que más daño puede hacer si se configura mal.

La recomendación más sensata es empezar con tareas pequeñas, previsibles y de bajo riesgo: resúmenes periódicos, revisiones simples de carpetas o avisos operativos. No conviene automatizar desde el primer momento procesos críticos, destructivos o demasiado amplios.

¿Qué automatizar primero?

Conviene automatizar tareas repetitivas, fáciles de verificar y de impacto controlado, como:

• Recopilar cambios en un proyecto.
• Resumir actividad reciente.
• Revisar una ubicación concreta en busca de archivos nuevos.
• Enviar un aviso sencillo a través de mensajería.

La idea es construir confianza con procesos pequeños y ampliar el alcance cuando ya existe evidencia de estabilidad, en vez de empezar por la automatización más ambiciosa del sistema.

¿Cómo diagnosticar problemas?

La regla más útil en diagnóstico es retroceder a la última capa que sí funcionaba. No se trata de “tocar todo a la vez”, sino de aislar la causa. Si el problema aparece al añadir mensajería, el primer paso es comprobar que el chat local sigue bien. Si surge al cambiar de modelo o de gateway, conviene revisar proveedor, endpoint y credenciales antes de pensar en memoria o habilidades.

La terminal sigue siendo la herramienta más fiable para este tipo de diagnóstico: permite ver qué modelo está activo, qué comandos fallan y qué mensajes devuelve el agente. Hermes Desktop, en cambio, ayuda a observar visualmente el estado de sesiones, memoria y perfiles, lo que complementa la investigación.

¿Cuál es una secuencia de recuperación razonable?

1. Verificar proveedor y modelo en la terminal.
2. Comprobar una conversación simple en local.
3. Revisar la configuración guardada (perfiles, herramientas básicas).
4. Confirmar continuidad de sesión.
5. Probar herramientas mínimas.
6. Solo después revisar mensajería, tareas programadas y gateways externos.

Este orden separa causas principales de síntomas secundarios y evita perder tiempo corrigiendo capas superiores cuando el problema real está en el modelo o en el gateway.

¿Cuál es la recomendación final de uso?

Para un lector nuevo, la mejor ruta es comenzar con Hermes Desktop, elegir un único proveedor estable, validar una conversación simple, comprender la diferencia entre memoria y habilidades, y dejar mensajería y automatización para después. Para un lector avanzado, la combinación más sólida es usar la app de escritorio como panel de control visual y conservar la terminal como base de configuración, integración y diagnóstico.

La idea central que debe quedar en la guía es esta: Hermes Desktop y Hermes Agent forman parte del mismo ecosistema, pero no siempre muestran exactamente el mismo estado operativo en todo momento. Cuando haya dudas, la terminal sigue siendo la referencia más fiable para comprobar qué proveedor, modelo y gateway están realmente activos.

¿Cómo sería una ruta de adopción recomendada?

1. Instalar el sistema base.
2. Elegir un proveedor confiable y un modelo estable.
3. Validar el primer chat en local.
4. Comprobar continuidad de sesión.
5. Activar pocas herramientas esenciales.
6. Revisar memoria y mantenerla limpia.
7. Separar perfiles por función (trabajo, pruebas, automatización).
8. Agregar habilidades solo cuando exista repetición real.
9. Conectar mensajería cuando el entorno ya sea estable.
10. Programar tareas pequeñas antes de ampliar alcance.

Con este enfoque, el sistema puede empezar a aportar valor en pocos días, pero su verdadera potencia aparece cuando la configuración se construye de forma ordenada y verificable, no solo por acumulación de funciones.