Hermes Agent se instala con un solo comando y funciona en Linux, macOS o WSL2. Pero la instalación es la parte fácil: la diferencia entre "funciona" y "mejora realmente con el tiempo" está en la configuración. La mayoría de los usuarios que consideran Hermes poco impresionante nunca activaron las funciones que lo hacen diferente.
Esta guía cubre todo, desde la primera instalación hasta tu primera tarea automatizada, con los pasos de configuración que la mayoría de los tutoriales omiten.
Idea clave
La instalación toma 2 minutos. La configuración, 15. Los pasos críticos que la mayoría pasa por alto: activar persistent_memory y skill_generation en el config. Sin estos, Hermes se comporta como cualquier otro agente de sesión única.
¿Qué necesitas antes de instalar?
Casi nada. El instalador de Hermes maneja las dependencias automáticamente. Necesitas:
| Requisito | Detalles |
|---|---|
| Sistema operativo | Linux, macOS o Windows con WSL2 |
| LLM API Key | Al menos una: Anthropic (Claude), OpenAI (GPT), Google (Gemini) o OpenRouter |
| Hardware | Cualquier máquina moderna. Para siempre activo: un VPS de $5-10/mes funciona bien |
| Acceso a terminal | Familiaridad básica con la línea de comandos |
¿Cómo instalas Hermes Agent?
Paso 1: Ejecuta el instalador.
Esto descarga y configura todo: Node.js, dependencias de Python, SQLite y el runtime de Hermes. Toma 1-3 minutos según tu conexión.
Paso 2: Configura tu proveedor de LLM.
Tras la instalación, Hermes te pregunta qué proveedor de LLM usar. Las opciones más comunes:
📋 EJEMPLOS DE CONFIGURACIÓN DE PROVEEDOR
# Para Claude (mejor calidad, mayor costo) provider: anthropic model: claude-sonnet-4-20250514 api_key: sk-ant-... # Para GPT (buen equilibrio) provider: openai model: gpt-5.4 api_key: sk-... # Para configuraciones económicas (gratis vía OpenRouter) provider: openrouter model: qwen/qwen-3.5 api_key: sk-or-...
Consenso de la comunidad sobre modelos: GPT 5.4 con modo de pensamiento en medio+ es el más popular para uso diario. Qwen 3.5 en OpenRouter es gratis y lo suficientemente capaz para automatizaciones rutinarias. Claude Opus produce la mejor calidad, pero cuesta mucho más, y Anthropic ha estado restringiendo el uso intensivo de terceros.
Paso 3: Activa las funciones que importan.
Aquí es donde fallan la mayoría de los tutoriales. Abre tu archivo de configuración de Hermes y activa estas dos opciones:
Sin estas, Hermes olvida todo entre sesiones y nunca crea habilidades reutilizables. Se convierte en solo otro envoltorio de chatbot. Con ellas activadas, cada tarea compleja (5+ llamadas a herramientas) crea automáticamente un archivo de habilidad, y todas las conversaciones son buscables entre sesiones.
---📬 ¿Estás sacando valor de esto? Publicamos guías semanales sobre herramientas y flujos de trabajo de IA. Recíbelo en tu bandeja →
---¿Cómo ejecutas tu primera tarea?
Inicia Hermes en tu terminal:
Ahora estás en una sesión interactiva. Prueba estas tareas iniciales para verificar que todo funcione:
Prueba conversación básica: "¿Con qué puedes ayudarme?" — verifica que la conexión LLM funcione.
Prueba búsqueda web: "Busca las últimas noticias sobre Nous Research y resúmelas en 3 puntos." — verifica que las llamadas a herramientas funcionen.
Prueba creación de habilidades: "Investiga los 5 principales frameworks de agentes de IA en 2026, compara sus funciones y escribe un informe resumen." — esto debería activar 5+ llamadas a herramientas, lo que significa que Hermes creará automáticamente un archivo de habilidad al terminar. Revisa tu directorio de habilidades para verificar que se creó el archivo.
Prueba memoria: Cierra la sesión, inicia una nueva y pregunta "¿De qué hablamos la última vez?". Si la memoria persistente funciona, Hermes recordará la conversación anterior.
¿Cómo conectas plataformas de mensajería?
Hermes soporta Discord, Telegram, Slack, Microsoft Teams y más. Cada plataforma requiere crear un token de bot y agregarlo al config. Aquí Discord como ejemplo:
1. Crea un bot de Discord en discord.com/developers/applications
2. Copia el token del bot
3. Agrégalo a tu config de Hermes:
4. Reinicia Hermes. Tu bot aparece en tu servidor de Discord, listo para responder.
El mismo patrón aplica a Telegram (token de BotFather), Slack (token OAuth de app) y otras plataformas. Hermes v0.10.0 añadió Microsoft Teams como plataforma con plugin incluido y soporta un total de 18+ plataformas de mensajería.
¿Cómo configuras perfiles para múltiples casos de uso?
Hermes v0.6.0 introdujo perfiles: instancias aisladas con configuración, memoria, habilidades y conexiones de gateway separadas. Esto te permite ejecutar un perfil "trabajo" con integración de Slack y un perfil "personal" con Telegram, cada uno con su propia memoria y habilidades aprendidas.
¿Cuáles son los errores de configuración más comunes?
| Error | Síntoma | Solución |
|---|---|---|
| persistent_memory no activado | El agente olvida todo entre sesiones | Establece persistent_memory: true en el config |
| skill_generation no activado | No se crean archivos de habilidades tras tareas complejas | Establece skill_generation: true en el config |
| Usar configuraciones de modelo de bajo esfuerzo | La calidad de salida parece un retroceso | Establece esfuerzo en high o xhigh |
| Ejecutar en VPS público sin endurecimiento | Exposición de seguridad | Activa aislamiento de contenedores, root de solo lectura |
| No configurar checkpoint/rollback | No se puede recuperar de errores del agente | Activa checkpoints del sistema de archivos en el config |
Para una comprensión más amplia de cómo funcionan los agentes de IA y dónde encaja Hermes en el ecosistema, consulta nuestra guía completa. Y para mejores prompts al interactuar con cualquier agente de IA, prueba el gratuito Prompt Optimizer.
---📬 ¿Quieres más como esto? Guías prácticas de configuración de IA, semanalmente. Suscríbete gratis →
---Preguntas frecuentes
¿Cuánto tiempo toma la configuración?
La instalación son 2 minutos. La configuración básica de LLM, 5 minutos. Activar memoria, habilidades e integraciones de mensajería toma otros 10-15 minutos. Total: menos de 30 minutos para un agente completamente funcional.
¿Puedo ejecutar Hermes Agent en una Raspberry Pi?
Técnicamente sí (funciona en Linux), pero el rendimiento será limitado. Un VPS de $5-10/mes de DigitalOcean o Hetzner ofrece mejor rendimiento y capacidad siempre activa.
¿Qué pasa si cambio de proveedor de LLM más adelante?
Cambiar es solo un ajuste en el config: no se necesitan modificaciones de código. Tu memoria, habilidades e historial de conversaciones se preservan. Solo las respuestas del LLM cambiarán en calidad/estilo según el nuevo modelo.
¿Necesito Docker?
No. La instalación estándar no requiere Docker. Docker es opcional y recomendado solo para despliegues en producción donde quieras aislamiento de contenedores por seguridad.
Divulgación: Algunos enlaces en este artículo son enlaces de afiliados. Solo recomendamos herramientas que hemos probado personalmente y usamos regularmente. Consulta nuestra política de divulgación completa.