Inicio rápido del Agente Hermes: De la instalación a los primeros pasos

Por qué vale la pena prestar atención a Hermes

Si alguna vez has instalado una nueva herramienta de IA, has visto el binario llegar a tu PATH y aun así has terminado con algo que estaba técnicamente presente pero prácticamente inútil, ya entiendes el problema que este inicio rápido de Hermes Agent está resolviendo. Una instalación terminada solo demuestra que los archivos fueron copiados. No demuestra que el agente pueda inspeccionar un repositorio, hablar con un modelo real, usar herramientas de forma segura o retomar el trabajo más tarde.

Por eso vale la pena prestar atención a Hermes. Cuando funciona correctamente, deja de sentirse como “ChatGPT en una terminal” y comienza a comportarse como un agente operacional. Puede inspeccionar archivos, usar herramientas de terminal, mantenerse dentro de un espacio de trabajo y llevar la sesión hacia adelante en lugar de actuar como si cada prompt comenzara desde cero.

Eso lo convierte en una buena opción para desarrolladores, usuarios de autoalojamiento y usuarios orientados a la terminal que quieren ayuda con tareas reales: resumir una base de código, revisar un repositorio en una máquina personal, o ejecutarlo en un pequeño VPS de AlexHost, AvaHost u otro proveedor sin saltar directamente a una pila de automatización más grande. Al final de esta guía, tendrás Hermes instalado, configurado, probado en una primera tarea segura y reanudado con éxito.

Qué es Hermes — y qué te ayudará realmente a hacer esta guía

Antes de ejecutar cualquier comando, mantén tres términos separados. La mayor parte de la confusión en la primera ejecución proviene de colapsarlos en una idea vaga de “la IA.”

La siguiente tabla te proporciona el modelo mental de trabajo para este tutorial:

Este artículo apunta a un único estado de éxito: una sola sesión de Hermes segura y funcional que puedas iniciar, probar y reanudar. No es una guía de implementación en producción. No es un recorrido completo de características. Es el camino más corto y confiable hacia “Hermes funciona en mi máquina, y puedo demostrarlo.”

📝 Nota: Instalar Hermes no es lo mismo que configurar Hermes. El binario puede estar presente y seguir siendo inutilizable hasta que ejecutes hermes model y lo conectes a un proveedor y modelo.

Es posible que notes que los documentos oficiales también ofrecen hermes setup. Eso es válido, pero esta guía separa intencionalmente la instalación de hermes model para que puedas ver exactamente dónde ocurre la mayor parte del éxito o fracaso en la primera ejecución. También nos mantenemos con CLI clásico primero por reproducibilidad, aunque hermes –tui existe y usa las mismas sesiones subyacentes. Fuera del alcance de este inicio rápido: configuración de gateway, cron, MCP, redes de modelos locales, enrutamiento multi-proveedor y hardening de producción.

Reglas de seguridad antes de dar a Hermes acceso a la shell

Antes de probar cualquier agente con acceso a la terminal, decide dónde se le permite equivocarse. Para este artículo, eso significa una máquina que no sea de producción, una VM, un repositorio desechable, o como mínimo un espacio de trabajo de bajo riesgo donde un comando accidental no arruine tu día.

⚠️ Advertencia: Mantén las aprobaciones en el modo seguro predeterminado durante todo este inicio rápido, y no uses –yolo. Hermes pregunta antes de ejecutar comandos arriesgados; esa es una característica de seguridad, no una fricción sin sentido.

Usa esta lista de verificación rápida antes de continuar:

• Comienza en una máquina o espacio de trabajo de bajo riesgo.
• Mantén habilitadas las solicitudes de aprobación.
• Evita repositorios de producción personales para la primera prueba.
• Espera que la tarea de prueba sea de solo lectura.
• Trata los backends de terminal Docker y SSH como pasos de hardening posteriores, no como requisitos del primer día.

La primera tarea de prueba real en esta guía se mantiene dentro de ~/.hermes/hermes-agent, lo que mantiene la demostración relevante para Hermes mientras evita proyectos sensibles. Una vez que el flujo base de CLI sea estable, puedes avanzar hacia un aislamiento más fuerte con Docker o backends remotos. Durante la primera hora, seguro y verificable es mejor que ambicioso.

Antes de instalar: requisitos previos, rutas compatibles y un problema con WSL2

Para los usuarios habituales, la historia de compatibilidad es simple: Linux, macOS y WSL2 son las rutas a considerar primero. Windows nativo existe, pero todavía está en beta temprana, así que si estás en Windows, la recomendación práctica sigue siendo WSL2.

En Ubuntu 24.04 o WSL2, comienza asegurándote de que git y curl estén disponibles:

Si la segunda línea devuelve la cadena de tu distribución más la salida de versión funcional para ambas herramientas, los requisitos previos base están en su lugar. En macOS, la verificación equivalente suele ser simplemente confirmar git –version y curl –version antes de usar el mismo instalador de Hermes.

📝 Nota: Windows nativo todavía es una ruta en beta temprana, así que prefiere WSL2 si estás en Windows.
💡 Consejo: En WSL2, mantén Hermes y tus repositorios de trabajo bajo ~ en lugar de /mnt/c para evitar operaciones Git más lentas y comportamientos extraños con permisos de archivos.

La buena noticia es que Hermes no requiere que ensamblen manualmente una gran pila de dependencias primero. El instalador oficial de git se encarga de uv, Python 3.11, Node.js 22, ripgrep y ffmpeg por ti. Lo que deberías tener listo antes de que comience el asistente de configuración es una cuenta de proveedor, o al menos un plan probado para un endpoint personalizado. Además, elige un modelo con al menos 64K de contexto: las ventanas de contexto más pequeñas tienden a fallar una vez que el agente comienza a manejar contexto de archivos, salida de herramientas e instrucciones de múltiples pasos juntos.

Instala Hermes Agent con la ruta oficial de una sola línea

Con los requisitos previos listos, ejecuta el instalador oficial exactamente como está documentado:

Esto es ahora más que un simple paso de instalación. Hermes detecta la plataforma, prepara las dependencias que necesita y luego continúa inmediatamente con el flujo de configuración de la primera ejecución. En el ejemplo anterior, el instalador detecta Linux, verifica si hay uv, instala Python 3.11 donde sea necesario, prepara Node.js 22 para las herramientas del navegador y construye el entorno de comandos de Hermes.

Si tu instalación se realiza como root, es posible que veas rutas como /usr/local/bin/hermes, /usr/local/lib/hermes-agent y /root/.hermes/. En una instalación de usuario regular, espera la misma estructura bajo tu propio directorio home.

El detalle importante es que el instalador de una línea ahora continúa directamente con el asistente de configuración. En otras palabras, la instalación y la configuración de la primera ejecución son un flujo continuo. No trates el final de la instalación del paquete como la línea de llegada, porque Hermes no es realmente útil hasta que se complete este asistente de configuración.

La primera decisión es el proveedor de inferencia. En esta ejecución, se selecciona OpenRouter, que es una primera opción práctica porque da acceso a un amplio catálogo de modelos a través de una sola cuenta de proveedor. Si ya usas un proveedor compatible diferente, elige ese en su lugar.

Una vez elegido el proveedor, Hermes solicita la clave API correspondiente. En este ejemplo, eso significa OPENROUTER_API_KEY. Pega la clave, presiona Enter y Hermes la almacena para uso futuro.

Si omites este paso, Hermes puede terminar de instalarse, pero aún no estará listo para una sesión de agente real. Tendrías que volver y configurar el proveedor más tarde.

Después de guardar la clave, el asistente pasa a la selección del modelo. En esta ejecución, el modelo seleccionado es deepseek/deepseek-v4-pro. Ese es un ejemplo concreto válido, pero no es tu único camino: el asistente también te permite ingresar un nombre de modelo personalizado u omitir y mantener el modelo actual si estás volviendo a ejecutar la configuración en una instalación existente.

Para una primera ejecución, la regla práctica es simple: elige un modelo al que ya sabes que puedes acceder y asegúrate de que tenga suficiente contexto para el trabajo real del agente. Hermes es mucho más confiable con modelos que ofrecen al menos una ventana de contexto de 64K. Las ventanas de contexto más pequeñas pueden verse bien en una prueba pequeña, pero luego fallan una vez que la salida de herramientas, el contexto de archivos y las instrucciones de múltiples pasos comienzan a acumularse.

Si alguna vez quieres cambiar esta elección más tarde, hermes model sigue siendo la forma más rápida de volver a ejecutar la selección de proveedor y modelo sin reinstalar nada.

A continuación, Hermes pregunta cuánto de la configuración más amplia quieres hacer ahora mismo. Para este inicio rápido, la opción recomendada es la correcta: configuración rápida.

Eso mantiene el artículo enfocado en la ruta principal: proveedor, modelo y las elecciones mínimas necesarias para hacer que Hermes sea utilizable.

La siguiente pantalla pregunta sobre el backend de terminal. Para una primera ejecución, mantén el backend local actual para que Hermes se ejecute directamente en esta máquina. Docker, SSH, Modal y otros backends son útiles más adelante, pero añaden complejidad antes de que hayas confirmado que el flujo base de CLI funciona.

Hermes luego ofrece la configuración de plataforma de mensajería. Para este inicio rápido, omítela. Eso mantiene la guía centrada en el flujo principal del agente CLI, y puedes agregar Telegram, Discord u otra ruta de mensajería más tarde con hermes setup gateway.

Una vez que el asistente termina, Hermes muestra dónde almacenó los archivos importantes.

La división principal a recordar es simple: config.yaml contiene configuraciones no secretas, .env contiene claves API y otros secretos, y los directorios de datos contienen sesiones, registros y estado de tiempo de ejecución relacionado. En esta captura de pantalla, las rutas están bajo /root/.hermes/ porque la instalación se realizó como root. En una instalación de usuario normal, lee esas rutas como ~/.hermes/.

Hermes luego imprime el resumen corto de listo para usar, incluidos los comandos que es más probable que uses primero.

En este punto, Hermes está tanto instalado como configurado. Lo siguiente que hay que hacer es verificar que el entorno esté en buen estado antes de continuar con la primera tarea real:

hermes doctor debería confirmar los aspectos básicos: sin avisos de seguridad activos, un entorno Python funcional y los paquetes requeridos presentes. Esa es la señal de éxito limpia que quieres antes de continuar.

Si hermes no es visible en una shell nueva todavía, recarga tu shell y verifica la ruta del comando antes de continuar. En Bash eso generalmente significa source ~/.bashrc; en Zsh, source ~/.zshrc. Si es necesario, confirma el lanzador con command -v hermes.

Con Doctor pasando, la instalación no solo está terminada — Hermes ahora está realmente listo para usar.

Ejecuta tu primera tarea segura del agente

Con Hermes ahora instalado, configurado y verificado por hermes doctor, estás listo para la primera demostración real. El primer espacio de trabajo más seguro y con alta señal es el propio directorio home de Hermes. En esta ejecución, la instalación se realizó como root, por lo que ese directorio es /root/.hermes. En una instalación de usuario normal, el mismo lugar sería ~/.hermes.

Muévete a ese directorio, confirma dónde estás y luego lanza Hermes:

Este es un buen primer espacio de trabajo porque ya está presente, está directamente relacionado con la herramienta que acabas de instalar y es de bajo riesgo en comparación con soltar un agente en un repositorio personal o de producción. La pantalla de inicio también es una verificación de cordura útil por sí misma: muestra que Hermes se lanza correctamente, el modelo activo en el pie de página y el hecho de que el agente ya puede ver sus herramientas disponibles y habilidades incluidas.

Si prefieres la interfaz más nueva, hermes –tui sigue disponible, pero esta guía se mantiene con CLI clásico primero porque es más fácil de reproducir paso a paso y ambas interfaces comparten las mismas sesiones.

Cuando Hermes se abra, dale un prompt simple y de solo lectura que le pida inspeccionar el espacio de trabajo actual e identificar el punto de entrada. En este ejemplo, el prompt apunta explícitamente a /root/.hermes porque la instalación se realizó como root. En una instalación de usuario normal, apúntalo a tu propio directorio ~/.hermes.

Usa el siguiente prompt:

Summarize this repo in 5 bullets and tell me what the main entrypoint is: ~/.hermes

Este es exactamente el tipo de primera tarea que quieres: segura, observable y fácil de verificar. En la captura de pantalla anterior, Hermes no solo adivina. Comienza leyendo archivos concretos como config.yaml, SOUL.md y .install_method, busca archivos relacionados con Hermes e inspecciona la ruta del lanzador instalado. Esa actividad visible de herramientas es la prueba real de que Hermes se está comportando como un agente en lugar de una caja de chat de un solo disparo.

Un resultado saludable debería volver con un resumen concreto vinculado al espacio de trabajo y un punto de entrada verificable. En esta ejecución, Hermes identifica el wrapper de comando instalado en /usr/local/bin/hermes, explica que conduce al punto de entrada CLI de Python y resume el entorno de Hermes circundante en cinco puntos.

Esa es la señal de éxito a buscar. La respuesta es específica, basada en archivos que Hermes realmente inspeccionó y fácil de verificar contra lo que ya puedes ver en el disco. No trates el resultado como magia — compara el resumen con los archivos visibles y la estructura de directorios. Para una primera demostración, seguro y verificable es mucho mejor que llamativo.

Reanuda la sesión y confirma que la configuración realmente funciona

El inicio rápido no está terminado cuando Hermes responde una vez. Está terminado cuando confirmas que la sesión puede reanudarse.

Usa el comando de reanudación a continuación; -c es la forma abreviada para la misma acción:

El resultado esperado es que Hermes reabra la sesión más reciente o te dé un resumen que claramente pertenezca a la tarea que acabas de ejecutar. Eso importa porque demuestra que Hermes no está actuando como un chat desechable de un solo uso. Está manteniendo una sesión de trabajo duradera a la que puedes volver.

Usa esta lista de verificación de éxito compacta antes de continuar:

• Hermes instalado y verificado
• Proveedor configurado
• Primera respuesta limpia
• Primera tarea de repositorio completada
• Sesión reanudada con éxito

Si la reanudación no funciona, primero asegúrate de estar usando el mismo perfil, luego verifica las sesiones disponibles con hermes sessions list. Una vez que hermes –continue funcione, tienes la línea base completa que este tutorial de Hermes Agent pretendía establecer.

Qué probar a continuación una vez que el flujo base funcione

Una vez que el chat base sea estable, agrega solo una nueva capa a la vez.

💡 Consejo: Resiste la urgencia de habilitar todas las funciones avanzadas de inmediato. Primero estabiliza un flujo de trabajo limpio, luego expande deliberadamente.

Aquí está el menú corto de próximos pasos sensatos:

• Prueba hermes –tui si quieres la interfaz de terminal más nueva sobre el mismo modelo de sesión.
• Ejecuta hermes setup más tarde si quieres el asistente de configuración más amplio después de entender los conceptos básicos manualmente.
• Explora hermes gateway setup si tu próximo objetivo es la integración con plataformas de mensajería.
• Revisa hermes tools y hermes skills cuando quieras una expansión controlada de capacidades.
• Muévete a un backend de terminal Docker o SSH si el agente comenzará a tocar sistemas de mayor riesgo.
• Usa los documentos oficiales para proveedores personalizados y endpoints de modelos locales una vez que la ruta alojada ya esté funcionando.

Si quieres ideas de seguimiento para uso real, aquí hay algunas buenas para investigar a continuación: notas de incorporación de bases de código, redacción de registros de cambios, planificación segura de refactorización, explicación de archivos de configuración, resúmenes de revisión de pull requests, listas de verificación de mantenimiento de VPS, redacción de runbooks de implementación, prompts de triaje de registros y búsqueda de brechas en la documentación.

Para rutas más profundas, enlaza hacia afuera en lugar de extender este inicio rápido en un segundo artículo: el inicio rápido, los documentos de instalación, la guía CLI y la guía de seguridad son las próximas paradas correctas.

Ahora tienes un inicio rápido de Hermes seguro y funcional

El hito importante no es que Hermes se instaló. El hito importante es que Hermes se volvió útil. Ahora tienes una línea base verificada: el binario está presente, el proveedor está configurado, la primera respuesta funcionó, la primera tarea segura se completó y la sesión se reanudó después.

Ese es el lugar correcto para detenerse y celebrar el logro. Mantén las aprobaciones activadas, expande una capa a la vez y avanza hacia un aislamiento más fuerte cuando el agente comience a realizar trabajos de mayor riesgo. Si eventualmente ejecutas Hermes en una estación de trabajo personal, una máquina de laboratorio o un VPS de AlexHost, AvaHost o cualquier otro lugar, la regla sigue siendo la misma: gana confianza en pequeños pasos.