Guía · Intermedio · 12 min
Hermes Agent, guía de referencia: instalación, memoria y habilidades, modelos, costos y límites
Hermes Agent realiza tareas con herramientas, memoria y habilidades. Aprenda a instalarlo, elegir un modelo, controlar los costos y limitar los riesgos de uso.
Hermes Agent es un agente de Nous Research que combina un modelo de lenguaje, herramientas, memoria persistente y habilidades reutilizables para realizar tareas. Puede instalarlo en su equipo, elegir el proveedor del modelo y controlar sus accesos; el costo real dependerá de la inferencia, los servicios utilizados y el alojamiento.
Qué hace realmente Hermes Agent
El programa recibe una solicitud, utiliza las herramientas disponibles, examina sus resultados y continúa trabajando. Una de sus particularidades es que conserva datos y procedimientos entre sesiones. Esa continuidad puede evitar que tenga que repetir instrucciones, aunque también exige revisar qué información se ha guardado.
El repositorio oficial de Nous Research publica el código con licencia MIT. La revisión del sitio de octubre de 2026 recoge la versión v0.22.5, fechada el 23 de octubre de 2026. Esta referencia identifica un estado concreto del proyecto; los comandos de esta guía siguen la documentación oficial consultada durante su elaboración.
Conviene distinguir el agente del modelo que utiliza. Instalar Hermes no implica instalar automáticamente un modelo local. El programa que coordina las acciones y el servicio que genera las respuestas se configuran por separado.
Hermes está dirigido a personas que sepan manejar un terminal, credenciales y archivos de configuración. Para comparar este enfoque con otras soluciones, consulte el directorio de agentes de IA. El artículo Hermes Agent: instalación, costos y límites aborda un tema relacionado; esta página se centra en las decisiones necesarias para utilizarlo de forma continuada.
Requisitos previos: preparar el entorno y los accesos
Antes de instalarlo, decida dónde trabajará el agente y a qué datos podrá acceder. Para una primera prueba, utilice una cuenta de usuario estándar y una carpeta con documentos que no sean sensibles. Evite empezar con sus copias de seguridad, sus accesos a producción o todo el contenido de su correo profesional.
Prepare los siguientes elementos:
- un sistema contemplado en la documentación oficial;
- un terminal adecuado para su entorno;
- acceso a la red para descargar el programa y contactar con una API remota;
- una cuenta de proveedor o un servidor de modelos que ya esté accesible;
- un medio para consultar el gasto en el proveedor;
- copias de los archivos que utilizará en las pruebas.
Los recursos necesarios dependen sobre todo de dónde se ejecute el modelo. Con una API remota, la inferencia se realiza fuera de su equipo; un modelo local exige que su hardware pueda manejar los pesos y el contexto. Por tanto, el nombre Hermes no permite deducir una configuración de hardware válida para todos los casos.
Defina también un primer objetivo que pueda comprobar: resumir un documento público, localizar información en una carpeta de prueba o preparar un procedimiento sin ejecutarlo. Una petición acotada facilita el diagnóstico: podrá distinguir un problema de instalación de un error del modelo o de una herramienta que no esté disponible.
1. Instalar desde la documentación oficial
Los siguientes comandos proceden de la guía oficial de instalación, consultada para esta página el 24 de octubre de 2026. Descargan y ejecutan un script: compruebe el dominio y revise el script si así lo exige su política informática.
En Linux, macOS o WSL2:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashEn Windows nativo, abra PowerShell:
iex (irm https://hermes-agent.nousresearch.com/install.ps1)Son métodos alternativos: utilice el que corresponda a su entorno. La documentación también ofrece paquetes de la aplicación de escritorio para macOS y Windows. Compruebe los requisitos de hardware antes de elegir uno; el paquete documentado para macOS está destinado a Apple Silicon.
La instalación desde el código fuente prepara el programa y sus dependencias. También puede descargar componentes para navegar por la web y utilizar la computadora. Que la instalación termine no demuestra que todas las funciones opcionales estén listas: revise los mensajes finales y los posibles fallos de descarga.
En una instalación POSIX, la documentación sitúa de forma predeterminada el código en ~/.hermes/hermes-agent/ y los datos en ~/.hermes/. La instalación desde el código fuente en Windows utiliza una ubicación dentro de %LOCALAPPDATA%\hermes\. Tenga presente esta diferencia al crear copias de seguridad o resolver problemas.
2. Configurar el modelo y comprobar una conversación
La guía oficial de inicio rápido propone un asistente de configuración:
hermes setupPara elegir o cambiar de forma interactiva el proveedor y el modelo:
hermes modelLa opción integrada con Nous Portal utiliza este comando:
hermes setup --portalEste configura el acceso al proveedor y a las herramientas de su pasarela. Revise las condiciones de facturación antes de elegir esta opción. Si desea gestionar sus propias credenciales, seleccione el proceso de configuración correspondiente en lugar de dar por hecho que una suscripción existente cubre todas las llamadas.
A continuación, inicie la interfaz:
hermesSolicite una respuesta sencilla y después pida que lea un archivo de su carpeta de prueba. Compruebe el proveedor que aparece, la coherencia de la respuesta y si realmente se ha utilizado la herramienta. Todavía no conecte ninguna automatización.
Puede comprobar si se reanuda la última sesión:
hermes --continueLa documentación consultada exige un contexto mínimo de 64 000 tokens. Si utiliza un servidor local, compruebe la capacidad que está configurada en la práctica, además de la que se anuncia para el modelo.
El modo de configuración Blank Slate ofrece una base reducida, pero mantiene disponibles, entre otras funciones, las operaciones con archivos y el terminal. También desactiva la memoria y las habilidades: vuelva a activar expresamente las funciones que necesite antes de comprobar su persistencia.
3. Entender la configuración y guardar una copia
La referencia oficial de configuración distingue entre los ajustes generales, los secretos y las credenciales de autenticación. En la instalación POSIX predeterminada, estas son las ubicaciones principales:
| Elemento | Ubicación | Precaución |
|---|---|---|
| Ajustes | ~/.hermes/config.yaml | Guardar una copia antes de modificarlo |
| Claves y secretos | ~/.hermes/.env | Excluirlos de publicaciones y repositorios compartidos |
| Autenticación | ~/.hermes/auth.json | Protegerla como un acceso a la cuenta |
| Memoria | ~/.hermes/memories/ | Revisar la información conservada |
| Habilidades | ~/.hermes/skills/ | Llevar un seguimiento de los procedimientos y sus cambios |
Los comandos documentados permiten examinar los ajustes y detectar opciones que falten o selecciones que hayan quedado obsoletas:
hermes config
hermes config checkPara abrir el archivo de configuración en su editor:
hermes config editEvite modificar varias capas de configuración a la vez. Cambie un ajuste, repita una prueba conocida y anote el resultado. Un error en el nombre de una clave puede dejar un archivo legible sin que se aplique el comportamiento esperado.
Distinga también entre guardar una copia y compartirla. Un archivo comprimido que sirva para restaurar la instalación puede contener claves, historial e información personal. Si necesita pedir ayuda, prepare un fragmento reducido del que haya eliminado los datos sensibles. No publique toda la carpeta de datos en una solicitud de soporte.
Memoria, historial y habilidades: tres funciones distintas
La memoria de un agente se refiere aquí a información seleccionada para conservarse entre conversaciones. No sustituye al historial completo ni a los archivos de trabajo.
La documentación oficial de la memoria describe dos archivos: MEMORY.md, para las notas duraderas, y USER.md, para las preferencias y expectativas del usuario. Su contenido se carga como una instantánea al comenzar la sesión. Por eso, una modificación guardada durante esa sesión no actualiza inmediatamente dicha instantánea.
| Mecanismo | Contenido | Comprobación útil |
|---|---|---|
| Contexto actual | Intercambios y resultados de la tarea activa | ¿Dispone el agente del documento correcto? |
| Historial de sesiones | Conversaciones anteriores que se pueden consultar | ¿Encuentra la fuente adecuada? |
| Memoria persistente | Datos y preferencias seleccionados | ¿Es correcto el dato guardado? |
| Habilidades | Procedimientos reutilizables | ¿Sigue funcionando el procedimiento? |
La memoria tiene una capacidad limitada y no se compacta automáticamente cuando una escritura supera ese límite. En ese caso, el agente debe acortar, agrupar o eliminar entradas.
Para comprobar la persistencia, pida que guarde una convención sin importancia, termine la tarea y abra una sesión nueva. En las conversaciones prolongadas por mensajería, la documentación recomienda marcar explícitamente el inicio de una nueva sesión:
/newReiniciar el equipo no basta necesariamente para crear esa separación. Tampoco permita que varios procesos escriban en el mismo directorio de datos: utilice perfiles distintos. El artículo sobre la memoria de los agentes de IA profundiza en las diferencias entre recordar, buscar y disponer de contexto.
4. Revisar las habilidades antes de reutilizarlas
Una habilidad contiene instrucciones que se utilizan para realizar una tarea. El sistema oficial de habilidades emplea, entre otros elementos, archivos SKILL.md, cuyo contenido detallado se carga cuando hace falta. Hermes puede crear, modificar y eliminar habilidades.
Puede consultar el inventario disponible con este comando documentado:
hermes chat --toolsets skills -q "What skills do you have?"Que un procedimiento esté disponible no demuestra que sea adecuado. Antes de utilizarlo, examine su objetivo, sus requisitos previos, las acciones que realiza en servicios externos y su método de comprobación. Una habilidad que publica un documento exige un nivel de confianza distinto al de un procedimiento que solo le da formato.
La creación autónoma puede conservar un método útil, pero también una solución válida solo en una circunstancia concreta o un comando que haya quedado obsoleto. Aquí, el término aprendizaje no significa que se hayan vuelto a entrenar los parámetros del modelo. Usted debe poder localizar el procedimiento guardado y entender sus efectos.
Si prepara una habilidad interna, especifique cuándo debe utilizarse, qué datos de entrada espera, qué acciones permite y en qué condiciones debe detenerse. Pruébela sobre una copia de los datos, con un caso normal y otro incompleto. Compruebe que señala la información que falta en lugar de inventarla.
Por último, conserve una copia de los procedimientos validados para poder comparar los cambios. La guía de habilidades de los agentes de IA explica con más detalle este método de redacción y revisión.
Elegir el modelo según la tarea y los datos
La documentación de configuración de modelos explica cómo seleccionar el proveedor y el modelo. Esta decisión debe tener en cuenta la calidad de las acciones, la compatibilidad con las herramientas, la longitud del contexto y las condiciones de tratamiento de los datos.
OpenRouter figura entre los proveedores incluidos en la guía de inicio rápido. Un punto de acceso compatible también puede conectar el agente con una infraestructura local, por ejemplo mediante Ollama. En cualquier caso, compruebe la dirección, el identificador exacto del modelo y las funciones que ofrece el servidor.
| Criterio | API remota | Inferencia local |
|---|---|---|
| Operación | Servicio gestionado por el proveedor | Servidor y modelo cuyo mantenimiento debe asumir |
| Gastos | Consumo o plan del proveedor | Hardware, energía y administración |
| Datos | Contenido transmitido al servicio elegido | Flujos que debe comprobar en su infraestructura |
| Capacidad | Depende de la oferta a la que tenga acceso | Depende del hardware y de la configuración |
Un modelo que redacta bien puede manejar mal las herramientas. Evalúe si sabe elegir una acción adecuada, interpretar un fallo y detenerse cuando falta una autorización.
Utilice el mismo conjunto reducido de tareas para comparar las opciones: leer un documento, extraer información verificable, provocar deliberadamente un error de acceso y plantear una petición ambigua. Anote los resultados aprovechables y las intervenciones necesarias. Cambiar de modelo también puede alterar la forma en que Hermes selecciona su memoria y sigue sus habilidades; repita estas comprobaciones después de una migración.
Costos: presupuestar el trabajo completo
La licencia del programa no determina su costo de operación. El presupuesto incluye el acceso al modelo, las herramientas externas, la infraestructura y el tiempo dedicado a revisar o reparar los resultados. Una estimación mensual que omita estas partidas estará incompleta.
En las API que facturan por tokens, el cálculo básico suma los tokens de entrada multiplicados por su tarifa y los tokens de salida multiplicados por la suya. Los posibles mecanismos de caché y las demás condiciones contractuales deben calcularse por separado. La calculadora de precios de LLM ayuda a establecer estas hipótesis.
Un agente puede realizar muchas llamadas para una sola petición. Añade observaciones, vuelve a leer el contexto, intenta corregir un error o explora una vía que no da resultado. Por eso, una respuesta final breve puede ocultar una cantidad considerable de trabajo intermedio.
Para elaborar un presupuesto útil:
- registre los gastos de tareas representativas;
- cuente las tareas aceptadas después de revisarlas;
- separe los fallos y los nuevos intentos;
- añada el alojamiento y los servicios complementarios;
- compare el gasto con el trabajo que se haya completado.
No confunda una advertencia con un límite que bloquee el consumo. Compruebe con su proveedor qué ocurre al alcanzar el presupuesto y pruebe ese comportamiento con un acceso dedicado. Limite también las búsquedas abiertas: una lista de documentos y un resultado esperado ayudan a reducir las exploraciones innecesarias.
Límites y seguridad: controlar los efectos de las acciones
La documentación oficial de seguridad describe varias protecciones, como los permisos de usuario, la aprobación de comandos peligrosos y el aislamiento del terminal. Su presencia no garantiza que una operación sea correcta para el trabajo que desea realizar.
Un comando técnicamente corriente puede enviar el archivo equivocado al destinatario incorrecto. Defina las validaciones según las consecuencias de cada acción: publicar, eliminar, pagar o modificar datos compartidos.
La configuración documentada permite elegir un terminal dentro de un contenedor:
hermes config set terminal.backend dockerEste comando requiere un entorno Docker operativo. Revise los directorios montados, los secretos disponibles y las conexiones de red; un contenedor con permisos amplios sigue pudiendo afectar a su entorno.
La inyección de instrucciones supone otro riesgo: un documento consultado puede contener una instrucción que intente desviar al agente. Trate las páginas, los mensajes y los resultados de las herramientas como datos, y revise cualquier petición de acceso adicional o de transferencia.
Además, la memoria local puede incluirse en las solicitudes enviadas al proveedor. El almacenamiento local y la inferencia local son decisiones distintas. La guía para proteger un agente de IA amplía estas comprobaciones. Para empezar, mantenga los secretos fuera de los documentos de trabajo y conceda únicamente los accesos necesarios para la tarea.
Problemas frecuentes
No se encuentra el comando de inicio
Abra un terminal nuevo y revise los mensajes del instalador. En Bash, la guía de inicio rápido propone volver a cargar la configuración del intérprete:
source ~/.bashrcNo repita la instalación con más privilegios sin diagnosticar el problema. Compruebe primero la cuenta utilizada y la ubicación del ejecutable de inicio.
El programa se inicia, pero el modelo no responde
Vuelva a la selección interactiva del proveedor. Revise la autenticación, el saldo disponible, la dirección del servidor y el identificador del modelo. Si utiliza inferencia local, compruebe también el contexto configurado. Añadir habilidades no resuelve un error de acceso.
El agente parece olvidar una instrucción
Compruebe que la memoria está activada, que la información se ha guardado y que está utilizando el mismo perfil. Después, pruebe con una sesión nueva. Si la información solo aparecía en un documento leído anteriormente, no tiene por qué haberse conservado como un dato duradero.
Una habilidad ya no produce el resultado correcto
Vuelva a leer el procedimiento y compare sus requisitos previos con el entorno actual. Identifique el paso que falla antes de solicitar una reescritura completa. Conserve el mensaje de error y pruebe la corrección con los datos de prueba.
El gasto aumenta sin producir resultados aprovechables
Interrumpa la tarea y examine las llamadas repetidas, los errores de las herramientas y las búsquedas demasiado amplias. Reformule el objetivo con una entrega concreta y una condición de parada. Después, retome una prueba acotada en lugar de prolongar un ciclo que ya está fallando.
Lista de comprobación antes del uso habitual
La instalación estará lista cuando usted pueda explicar dónde guarda sus datos, qué servicio recibe sus solicitudes y qué efectos pueden producir sus herramientas.
- La instalación procede del dominio oficial y se han revisado los errores.
- Se han identificado el proveedor, el modelo y el contexto efectivo.
- Una tarea sencilla se completa correctamente y es posible reanudar su sesión.
- Se ha comprobado que una información sin importancia persiste entre sesiones.
- Las habilidades seleccionadas se han revisado y probado.
- Los secretos quedan fuera de los documentos y del material compartido.
- Los accesos a los archivos y a la red se ajustan a lo necesario.
- Las operaciones con consecuencias relevantes requieren una validación adecuada.
- Se hace un seguimiento del gasto y se entienden sus límites.
- Una copia de seguridad permite restaurar la configuración y los procedimientos.
Después de una actualización o de cambiar de proveedor, vuelva a ejecutar sus tareas de referencia antes de restablecer las automatizaciones. Así comprobará cómo se comporta su instalación, más allá de confirmar que el programa se inicia.
Páginas relacionadas
Preguntas frecuentes
¿Se puede utilizar Hermes Agent sin suscripción?
Puede utilizar el software sin contratar un plan comercial de Hermes. Sin embargo, debe darle acceso a un modelo mediante una API que se factura por separado o un servidor de inferencia que usted gestione. Los servicios externos que utilicen sus herramientas también pueden tener un costo.
¿Hermes Agent aprende modificando su modelo?
La memoria y la creación de habilidades guardan información y procedimientos que el modelo puede utilizar. Por sí solas, estas funciones no entrenan los parámetros del modelo. Por eso, un procedimiento guardado puede conservar un error y debe poder revisarse y corregirse.
¿Se puede instalar Hermes Agent directamente en Windows?
La documentación oficial consultada para esta guía ofrece un instalador nativo de PowerShell y una aplicación de escritorio. WSL2 sigue siendo otra opción para utilizar la instalación de Linux. Compruebe qué funciones están disponibles con el método de instalación elegido.
¿La memoria de Hermes Agent se mantiene confidencial?
Guardar los datos en su equipo no garantiza que permanezcan allí. Cuando utiliza una API remota, los elementos de memoria incluidos en las solicitudes se transmiten al proveedor del modelo. Conviene revisar por separado el almacenamiento, la inferencia y los servicios a los que acceden las herramientas.
¿Es Hermes Agent adecuado para automatizar tareas sin supervisión?
Empiece con una tarea acotada cuyo resultado se pueda comprobar y revertir. El funcionamiento sin supervisión también requiere una política de acceso, límites de gasto, copias de seguridad y una forma de gestionar los fallos. Las operaciones con consecuencias relevantes deben mantener una validación acorde con sus efectos.