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 toma 15. Los pasos críticos que la mayoría de las personas 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 |
|---|---|
| Operating System | 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 |
| Terminal access | 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 de 1 a 3 minutos dependiendo de tu conexión.
Paso 2: Configura tu proveedor de LLM.
Después de 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 significativamente más — y Anthropic ha estado restringiendo el uso intensivo por terceros.
Paso 3: Habilita las funciones que importan.
Aquí es donde la mayoría de los tutoriales fallan. Abre tu archivo de configuración de Hermes y habilita estas dos configuraciones:
Sin estas, Hermes olvida todo entre sesiones y nunca crea habilidades reutilizables. Se convierte en solo otro envoltorio de chatbot. Con ellas habilitadas, cada tarea compleja (5+ llamadas a herramientas) crea automáticamente un archivo de habilidad, y todas las conversaciones son buscables entre sesiones.
---📬 ¿Estás obteniendo 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 viñetas." — verifica que el llamado a herramientas funcione.
Prueba creación de habilidades: "Investiga los 5 principales frameworks de agentes de IA en 2026, compara sus características 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 a la 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 agregó 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 de "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 más comunes de configuración?
| Error | Síntoma | Solución |
|---|---|---|
| persistent_memory not enabled | El agente olvida todo entre sesiones | Set persistent_memory: true in config |
| skill_generation not enabled | No se crean archivos de habilidades después de tareas complejas | Set skill_generation: true in config |
| Using low effort model settings | La calidad de la salida parece un retroceso | Set effort to high or xhigh |
| Running on a public VPS without hardening | Exposición de seguridad | Enable container isolation, read-only root |
| Not setting up checkpoint/rollback | No se puede recuperar de errores del agente | Enable filesystem checkpoints in 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.