Instalar un agente de IA open-source no es pegar un comando y rezar. Es elegir la ruta correcta para tu sistema, conectarlo con un modelo y entender qué acabas de instalar para que la primera conversación no sea la última. Hermes Agent —el agente de Nous Research con un “learning loop” integrado— puede estar funcionando en quince minutos si sigues la documentación oficial. Esta guía hace exactamente eso, con el mental model incluido. Si vienes de leer sobre cómo elegir entre modelos y agentes, esto es la implementación práctica.
1. Qué es Hermes Agent (60 segundos)
Hermes Agent es un agente de IA open-source construido por Nous Research. Su característica distintiva es el learning loop: el agente crea “skills” —procedimientos reutilizables— desde la experiencia y persiste conocimiento entre sesiones. En palabras de su documentación oficial: “The self-improving AI agent built by Nous Research […] built-in learning loop”. No es un chat que olvida: es un sistema que acumula lo que aprende.
Andrej Karpathy describió un patrón similar con su concepto de LLM Wiki:
“Obsidian is the IDE; the LLM is the programmer; the wiki is the codebase.”
— Andrej Karpathy, LLM Wiki (gist)
Hermes Agent implementa esa idea sin necesitar Obsidian: el agente lee, integra y mantiene un conocimiento estructurado que crece con cada interacción. Si vienes de leer sobre fundamentos de IA o cómo elegir un agente, esto es la versión instalable.
2. Antes de empezar: qué necesitas
| Requisito | Por qué |
|---|---|
| Terminal (macOS, Linux, WSL2 o Windows) | El agente vive en la línea de comandos; Desktop añade interfaz gráfica |
| No necesitas ser developer | Solamente comodidad básica para copiar y pegar comandos |
| Conexión a internet | Para descargar el agente y autenticar el modelo |
| Cuenta de proveedor de modelo (gratuita o de pago) | Hermes no incluye el modelo: lo conectas vía OAuth en el setup |
3. Elige tu ruta: Desktop vs CLI
Hermes Agent ofrece dos rutas oficiales de instalación:
Hermes Desktop (Windows/macOS): un instalador que incluye la interfaz gráfica y la CLI. Ideal si prefieres no tocar la terminal después de instalar.
Solo CLI (Linux, macOS, WSL2, Android Termux, Windows PowerShell): un script que instala el motor del agente sin interfaz gráfica. Ideal si ya usas terminal con regularidad.
4. Instalación paso a paso
Los comandos siguientes están verificados contra la documentación oficial al 30 de julio de 2026. Si han pasado meses, confirma en hermes-agent.nousresearch.com antes de continuar.
Opción A — Linux, macOS, WSL2 o Termux:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashOpción B — Windows nativo (PowerShell):
iex (irm https://hermes-agent.nousresearch.com/install.ps1)Opción C — Hermes Desktop: descarga el instalador desde la web oficial y ejecútalo. Incluye CLI y aplicación de escritorio.
Verificación: tras la instalación, ejecuta hermes --version. Si el comando responde con un número de versión, el agente está instalado.
5. hermes setup –portal: el OAuth que lo conecta todo
El paso más importante después de instalar no es configurar archivos manualmente. Es ejecutar un solo comando:
hermes setup --portalSegún la documentación oficial, es “the fastest path to a working agent”: un único flujo OAuth cubre el modelo y las herramientas del Tool Gateway (búsqueda web incluida). Se abre un navegador, te autenticas con tu proveedor de modelo y el agente queda conectado. Si el comando falla por permisos o red, consulta la sección de errores comunes.
6. Tu primera conversación
Una vez que el setup termina, puedes iniciar una conversación directamente desde la terminal:
hermes chatTu primer mensaje no debería ser “hola”. Debería ser una tarea concreta —la misma estructura que aprendiste en cómo usar IA por primera vez: un objetivo con contexto. La diferencia es que Hermes Agent puede recordar lo que le enseñes, crear skills reutilizables y usar herramientas (búsqueda web, archivos, memoria) por ti.
Si el concepto de “agente que aprende” te suena abstracto, piénsalo así: un chat responde y olvida. Un agente responde, aprende y la próxima vez lo hace mejor porque guarda lo que funcionó.
7. Qué configurar después: skills, herramientas y memoria
Después de tu primera conversación, tres áreas definen cuánto valor sacas del agente:
- Skills: procedimientos reutilizables que el agente crea o que tú cargas. Si te enseñas a buscar eficientemente, la próxima vez lo hace solo.
- Herramientas: el Tool Gateway conecta búsqueda web, archivos, memoria y más. Revisa qué herramientas están activas con
hermes tools. - Memoria: el learning loop persiste conocimiento entre sesiones. Puedes revisar qué recuerda el agente y corregirlo.
La documentación oficial cubre configuración avanzada (perfiles, providers, self-hosting) para cuando necesites ir más allá del quickstart. Esta guía se queda en lo básico: instalar, autenticar, conversar.
8. Errores comunes y dónde pedir ayuda
| Problema | Solución |
|---|---|
hermes: command not found | Reinicia la terminal o verifica que el PATH incluye el directorio de instalación |
| El OAuth no abre el navegador | Copia la URL del portal manualmente en tu navegador |
| Error de modelo o API key | Ejecuta hermes setup --portal de nuevo; verifica tu cuenta de proveedor |
| El agente no recuerda entre sesiones | Revisa que el learning loop esté activo en la configuración |
Para ayuda de la comunidad, el Discord oficial de Nous Research es el canal recomendado. Antes de preguntar, ejecuta hermes doctor para obtener un diagnóstico del estado de tu instalación.
9. Preguntas frecuentes
¿Hermes Agent es gratis?
El agente es open-source y gratuito. El modelo que lo alimenta puede ser gratuito o de pago según el proveedor que elijas durante el setup. Tú controlas qué modelo usar y cuánto gastar.
¿Necesito saber programar para usar Hermes Agent?
Necesitas comodidad básica con la terminal: copiar, pegar y ejecutar comandos. La configuración avanzada puede requerir editar archivos, pero el quickstart está diseñado para usuarios sin experiencia de programación.
¿Hermes Agent funciona sin internet?
La instalación y el setup requieren internet. Algunas funciones, como la búsqueda web, necesitan conexión permanente. Otras, como la conversación con un modelo local, pueden funcionar offline si configuras un modelo local —eso es avanzado y queda fuera de este quickstart.
¿Cómo se compara Hermes Agent con otros agentes?
La comparación depende de tu tarea, sensibilidad y necesidad de verificación. Hermes Agent destaca por su learning loop persistente y por ser open-source. Si quieres un marco para decidir, lee nuestra guía sobre cómo elegir modelos y agentes.
¿Puedo usar Hermes Agent con modelos locales?
Sí, pero eso es configuración avanzada que queda fuera de este quickstart. La ruta recomendada es empezar con el setup –portal y un modelo cloud, y después explorar la documentación oficial para configurar providers locales.
FreakingJSON — Editorial FreakingJSON · IA con criterio
Cómo instalar Hermes Agent · Quickstart verificado julio de 2026
El conocimiento verdadero trasciende a lo público 🌀
¿Quieres seguir la línea de investigación? Continúa con artículos relacionados y guarda esta lectura para volver después.
Ver relacionados
