Hermes Agent no se instala haciendo clic en un botón de descarga. Se ejecuta en un terminal — una ventana de texto donde escribes comandos — y la instalación implica unos cuantos pasos que presuponen cierta familiaridad con la línea de comandos. La mayoría de la gente no tiene esa familiaridad.

La solución es sencilla: usa un asistente de IA web (ChatGPT, Claude o cualquier otro) para que te guíe en tiempo real. Describes tu equipo y tu sistema operativo, pegas los mensajes de error que ves y la IA te dice qué escribir a continuación. Esta guía explica exactamente cómo hacerlo.

Consulta también: la guía completa de instalación de Hermes Agent para el recorrido técnico completo, y la guía de seguridad de Hermes Agent antes de conectar tus cuentas.

Por qué hay un terminal de por medio

Hermes Agent es software de código abierto — lo que significa que el código está disponible gratuitamente y lo ejecutas tú mismo, en lugar de usar un servicio alojado. Las herramientas de código abierto como esta casi siempre se instalan y se ejecutan desde un terminal, porque las crean desarrolladores que asumen una audiencia técnica y porque los terminales son universales: los mismos comandos funcionan sea cual sea el equipo que utilices.

La buena noticia es que, para la instalación, no necesitas entender qué hacen los comandos. Necesitas poder abrir un terminal, copiar texto con precisión, pegarlo y pulsar Enter. Si puedes hacer eso, puedes instalar Hermes.

Cómo abrir un terminal en tu equipo. En una Mac, pulsa Cmd + Espacio y escribe «Terminal»; luego pulsa Enter. En Windows, pulsa Win + X y haz clic en «Terminal» o «PowerShell». En Linux, pulsa Ctrl + Alt + T. Esa es la aplicación en la que trabajarás.

La idea: usar IA para instalar IA

El enfoque es este: abres una conversación con ChatGPT (o Claude, o cualquier otro asistente de IA que ya uses) y le cuentas tu situación. Describes tu equipo, qué intentas instalar y en qué punto del proceso estás. Cuando obtienes un resultado — ya sea un mensaje de éxito o un error — lo pegas en el chat y preguntas qué hacer a continuación.

Esto funciona bien porque los errores de instalación son precisos. El terminal imprime exactamente qué salió mal, y un asistente de IA puede leer esa salida y decirte el comando específico para solucionarlo. No necesitas entender el error tú mismo.

Aquí tienes un prompt inicial que puedes copiar y adaptar:

Prompt inicial

Quiero instalar Hermes Agent en mi equipo. Uso [una Mac / un PC con Windows / una máquina Linux]. No soy programador. Tengo un terminal abierto. ¿Puedes guiarme por la instalación paso a paso y explicarme qué hace cada paso en lenguaje sencillo? Si algo sale mal, pegaré aquí el error y me ayudas a solucionarlo.

Sustituye la parte entre corchetes por tu sistema operativo real. Después, sigue las indicaciones de la IA, pegando la salida de error siempre que la veas.

Qué asistente de IA usar. ChatGPT (chatgpt.com), Claude (claude.ai) y Grok (grok.com) funcionan bien para esto. Si ya tienes una cuenta en alguno de ellos, usa ese. Todos entienden los comandos de terminal y pueden interpretar los mensajes de error con precisión.

Guía paso a paso

Este es el flujo general de lo que implica la instalación. Úsalo para entender la forma de la tarea — deja que el asistente de IA se encargue de los comandos específicos para tu sistema operativo.

1. Instala los requisitos previos

Hermes requiere que primero estén instaladas algunas piezas de software: Git (para descargar el código), Python o Node (según la versión) y, a veces, un gestor de paquetes como pip o npm. La IA te dirá cuáles te faltan y cómo instalarlos. En una Mac, esto suele implicar una herramienta llamada Homebrew; en Windows, puede implicar Winget o descargar los instaladores directamente.

2. Descarga Hermes

Con los requisitos previos en su sitio, usas un comando git clone para descargar el código de Hermes a tu equipo. La IA te dará el comando exacto. Esto crea una carpeta llamada hermes-agent (o similar) en algún lugar de tu equipo.

3. Instala las dependencias

A continuación, entras en esa carpeta y ejecutas un comando de instalación — algo como npm install o pip install -r requirements.txt. Esto descarga las bibliotecas de código adicionales que Hermes necesita para funcionar. Puede tardar unos minutos y produce mucha salida; eso es normal.

4. Añade tu clave API

Hermes necesita al menos una clave API de un modelo de IA para hacer cualquier cosa. El punto de partida más común es una clave de OpenAI. Creas un archivo llamado .env en la carpeta de Hermes y añades una línea como OPENAI_API_KEY=your-key-here. El asistente de IA te dirá exactamente cómo hacerlo, incluido dónde obtener la clave en el panel de OpenAI.

5. Ejecuta Hermes

Por último, ejecutas un comando de inicio — algo como npm start o python main.py. Si todo está configurado correctamente, verás un prompt en el terminal y podrás empezar a conversar con Hermes directamente.

¿Cuánto tiempo lleva esto? La mayoría de las personas que siguen este proceso lo completan en 30–60 minutos en su primer intento. La variable más importante es si falla algún paso de la instalación y cuántas rondas de corrección de errores se necesitan. El asistente de IA hace que esto sea considerablemente más rápido que intentar diagnosticar los errores por tu cuenta.

Cuando algo sale mal

Los pasos de instalación fallan con bastante frecuencia al primer intento, y eso es completamente normal. La clave está en saber cómo responder cuando ocurre.

Pega el error completo en el chat. No intentes interpretarlo tú mismo. Copia el mensaje de error entero — no solo la última línea — y pégaselo a tu asistente de IA. Los mensajes de error que parecen intimidantes suelen ser fáciles de solucionar una vez que una IA los lee.

Incluye la versión de tu sistema operativo. Algunos errores ocurren solo en versiones concretas de Windows o macOS. Mencionarlo de antemano, o cuando aparezca un error, ayuda a la IA a darte la solución correcta en lugar de una genérica.

Un comando cada vez. Si la IA te da varios comandos seguidos, ejecútalos uno por uno y pega la salida después de cada uno. Esto facilita identificar exactamente qué paso causó el problema.

Pídele que te explique cualquier cosa de la que no estés seguro. Si te pide ejecutar un comando que no entiendes, pregunta qué hace antes de ejecutarlo. Un buen asistente de IA te lo explicará con claridad. No estás obligado a ejecutar comandos que no entiendes.

No copies comandos de sitios web aleatorios. El asistente de IA te dará comandos basados en la documentación oficial de instalación de Hermes. Si encuentras otras guías en línea con comandos diferentes, consúltalo con la IA antes de ejecutarlos. Los scripts de instalación maliciosos existen, y aquí la cautela está justificada.

Una vez que Hermes esté en marcha, el siguiente paso es entender qué puede hacer realmente por ti. La guía de funciones de Hermes Agent para usuarios no técnicos cubre las capacidades principales en lenguaje sencillo, incluido cómo configurar soul.md, programar tareas y cambiar entre modelos de IA.