Como instalar Hermes Agent paso a paso

Que es Hermes Agent?

Hermes Agent es un agente de IA autónomo open-source de Nous Research. Es una alternativa a OpenClaw con mejor seguridad, soporte para modelos open-source, y memoria persistente. Puede navegar la web, ejecutar código, usar herramientas, y mantener conversaciones persistentes.

En esta guia completa te enseñaremos a instalarlo desde cero, configurarlo con diferentes proveedores de IA, asegurarlo correctamente, y sacarle el maximo partido con consejos profesionales y flujos de trabajo reales. Al final, como bonus, te explicamos como potenciarlo con las 1136 skills de SKILLSBUNDLE.

Requisitos del sistema

Antes de empezar, asegurate de que tu sistema cumple estos requisitos:

• Sistema operativo: macOS 12+, Windows 10+ (64-bit) o Ubuntu 20+ / Debian 11+ / Fedora 38+
• RAM: 8 GB minimo (16 GB recomendado para proyectos grandes)
• Disco: 500 MB para la herramienta + espacio para tus proyectos
• Node.js 18+ (si la instalacion es via npm)
• Python 3.9+ (para herramientas como Aider y Hermes Agent)
• Git (para herramientas que trabajan con repositorios)
• Conexion a internet (para descargar e instalar; para IA en la nube)
• Terminal: bash, zsh o PowerShell

Metodos de instalacion

Hay varias formas de instalar Hermes Agent. Elige la que mejor se adapte a tu sistema y preferencias:

Instalador oficial (recomendado)

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Funciona en macOS, Linux y WSL2.

npm

npm install -g hermes-agent
Requiere Node.js 18+ y Python 3.11.

Desktop app

Descarga Hermes Desktop desde hermes-agent.nousresearch.com. Disponible para macOS y Windows. Incluye instalación guiada.

Desde GitHub

git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent && npm install && npm run build

Verificar la instalacion

Una vez instalado, verifica que todo funciona:

hermes --version

Si ves un error, revisa la seccion de solucion de problemas al final de la guia.

Configurar autenticacion y proveedores de IA

La mayoria de herramientas de IA requieren configurar al menos un proveedor de modelos. Aqui tienes las opciones disponibles para Hermes Agent:

Nous Portal (recomendado)

hermes setup --portal
Una suscripción cubre 300+ modelos y Tool Gateway. Es el método más rápido y recomendado.

OpenRouter

export OPENROUTER_API_KEY=sk-or-...
hermes setup --provider openrouter
Acceso a 300+ modelos con una API key. Ideal para probar diferentes modelos.

Anthropic / OpenAI

export ANTHROPIC_API_KEY=... o OPENAI_API_KEY=...
hermes setup --provider anthropic (o openai).

Ollama (local)

hermes setup --provider ollama
Usa modelos locales. Privacidad total, sin coste de API.

Google Gemini

export GEMINI_API_KEY=...
hermes setup --provider google

Proveedores alternativos

No tienes por que limitarte a un solo proveedor. Aqui tienes una comparativa de los principales proveedores de IA que puedes usar:

Seguridad: mejores practicas

La seguridad es critica cuando usas herramientas de IA que tienen acceso a tu sistema. Sigue estas recomendaciones:

• Skills: Hermes carga skills de ~/.hermes/skills/ automáticamente. Verifica el contenido de las skills antes de cargarlas.
• API keys: se almacenan en ~/.hermes/.env. Protege este archivo: chmod 600 ~/.hermes/.env
• Gateway: nunca expongas el gateway de Hermes a internet. Usa Tailscale para acceso remoto.
• Memoria persistente: Hermes almacena conversaciones en SQLite. Los datos no salen de tu máquina.
• Ejecución de código: Hermes puede ejecutar código. Configura aprobación manual para acciones destructivas.
• Telegram gateway: si conectas Telegram, configura un canal privado y usuarios permitidos.
• Para entornos de producción: ejecuta Hermes en un contenedor Docker con permisos limitados.
• Actualizaciones: mantén Hermes actualizado para los últimos parches de seguridad.

Consejos profesionales

Una vez que Hermes Agent funciona, estos consejos te ayudaran a usarlo como un experto:

• Skills: Hermes carga skills de ~/.hermes/skills/ automáticamente. Solo tienes que copiarlos ahí.
• Perfiles: configura ~/.hermes/profiles/ para diferentes contextos de trabajo (personal, trabajo, investigación).
• Gateway: conecta Telegram, Discord y otros canales. Configura en ~/.hermes/config.yaml.
• Memoria: Hermes recuerda conversaciones anteriores. Puedes referenciar sesiones pasadas.
• Slash commands: /model (cambiar modelo), /search (buscar en sesiones), /memory (gestionar memoria).
• Plugin system: Hermes tiene un sistema de plugins para extender funcionalidades.
• Herramientas: Hermes puede buscar en web, navegar, ejecutar código, procesar imágenes, y más.
• Configura fallback providers para que Hermes siga funcionando si un proveedor falla.

Flujos de trabajo recomendados

Estos son los casos de uso mas potentes de Hermes Agent:

• Asistente personal: usa skills de productividad, finanzas, y organización personal para gestionar tu día
• Desarrollo asistido: skills de code review, testing, debugging, y CI/CD para desarrollo de software
• Marketing y contenido: skills de copywriting, SEO, análisis de competencia, y estrategia de contenido
• Investigación: skills de búsqueda web, extracción de datos, análisis de mercado y tendencias
• Automatización: programa tareas recurrentes con cron jobs integrados en Hermes
• Análisis financiero: skills de análisis de inversiones, unit economics, y modelos financieros
• Gestión de proyectos: skills de planificación, seguimiento, y reporting de proyectos
• Educación: skills de tutoría, explicación de conceptos, y generación de material educativo

Solucion de errores comunes

hermes: command not found

npm global no está en PATH. Solución: export PATH=$PATH:$(npm config get prefix)/bin

Error: 'No provider configured'

No has configurado ningún proveedor de IA. Solución: hermes setup --portal o hermes setup --provider openrouter

El gateway de Telegram no conecta

Verifica que el token de Telegram sea correcto y que el gateway esté configurado en config.yaml. Solución: hermes gateway restart

Hermes no encuentra skills

Revisa que el directorio ~/.hermes/skills/ exista. Solución: mkdir -p ~/.hermes/skills y copia las skills ahí.

Error de conexión con OpenRouter

Verifica tu API key de OpenRouter y tu saldo. Solución: export OPENROUTER_API_KEY=...

La memoria no funciona

Hermes usa SQLite para persistencia. Si el archivo state.db está corrupto, solución: hermes reset --memory

Error: 'Provider rejected'

El modelo solicitado puede estar caído o bloqueado. Solución: cambia de modelo con /model o configura un fallback provider.

El agente no ejecuta código

Verifica que Python 3.11 esté instalado. Hermes necesita Python para ejecutar código. Solución: instala Python 3.11.

Preguntas frecuentes

¿Puedo usar varios proveedores a la vez?

Si, la mayoria de herramientas permiten configurar multiples modelos. Puedes usar uno rapido (Haiku, GPT-4o-mini) para tareas simples y uno potente (Opus, GPT-5) para tareas complejas.

¿Funciona sin conexion a internet?

Solo si usas modelos locales con Ollama, LM Studio o llama.cpp. Los modelos en la nube requieren conexion permanente.

¿Cual es el mejor proveedor para empezar?

OpenRouter: una sola API key, 300+ modelos, facturación consolidada. Puedes probar todos los modelos sin comprometerte con uno.

¿Como protejo mis API keys?

Usa variables de entorno (export CLAVE=valor), nunca las incluyas en el codigo, anade .env a .gitignore, y usa un gestor de secrets como 1Password o Bitwarden.

¿Puedo compartir mi configuracion con el equipo?

Comparte el archivo de configuracion sin las API keys. Usa variables de entorno para los secrets y documenta que variables necesita cada miembro del equipo.

Comparativa: como se compara con otras herramientas

Configuracion avanzada

Hermes Agent ofrece configuracion flexible:

• Perfiles: ~/.hermes/profiles/ para diferentes contextos de trabajo (personal, trabajo, investigacion).
• Plugins: sistema de plugins para extender funcionalidades (navegador, email, calendario).
• Gateway: conecta Telegram, Discord, WhatsApp y otros canales desde un solo gateway.
• Fallback providers: configura modelos de respaldo para que Hermes siga funcionando si un proveedor falla.
• Memoria: Hermes recuerda conversaciones anteriores y puede referenciar sesiones pasadas.
• Cron jobs: programa tareas recurrentes que Hermes ejecuta automaticamente.

Ejemplos de uso reales

Estos son prompts reales que puedes usar para empezar a trabajar inmediatamente con tu herramienta recien instalada. Copia y pega, adapta segun tu proyecto:

# 1. Asistente personal con skills
"Usa las skills de productividad para organizar mi semana:
- Revisa mi calendario de los proximos 7 dias
- Prioriza las tareas segun deadlines
- Sugiere bloques de tiempo para trabajo profundo"

# 2. Investigacion automatizada
"Busca las ultimas 5 noticias sobre IA en desarrollo web,
resumelas en 3 puntos cada una, y crea un informe en markdown."

# 3. Analisis financiero con skills
"Usa las skills de finanzas para analizar mi cartera:
- Calcula el rendimiento YTD de cada activo
- Identifica los 3 activos con peor rendimiento
- Sugiere rebalanceo segun tolerancia al riesgo"

# 4. Automatizacion con cron
"Crea un cron job que cada lunes a las 9am:
- Revise mi bandeja de entrada de email
- Identifique los 5 emails mas importantes
- Genere un resumen ejecutivo"

# 5. Desarrollo de contenido
"Usa las skills de copywriting y SEO para crear un articulo de blog
de 1500 palabras sobre 'Tendencias de IA en marketing 2026'."

Bonus: Potencia Hermes Agent con 1136 skills de SKILLSBUNDLE

Ahora que Hermes Agent funciona perfectamente con tu proveedor de IA favorito, es momento de llevarlo al siguiente nivel. SKILLSBUNDLE te ofrece 1136 skills profesionales listos para usar.

Los skills son archivos de instrucciones que tu herramienta carga automaticamente segun el contexto. Con SKILLSBUNDLE obtienes:

• 40 verticales: marketing, finanzas, desarrollo web, SEO, diseno, y mas
• 15 tipos de uso: creacion de contenido, analisis de datos, automatizacion
• Skills transversales: code review, testing, documentacion, seguridad
• Optimizados y probados: cada skill ha sido refinado para dar resultados consistentes

Instalar los skills es directo:

# 1. Compra SKILLSBUNDLE en skillsbundle.com
# 2. Descarga skills.zip
# 3. Descomprime y copia las skills al directorio de tu herramienta
unzip skills.zip -d ~/skillsbundle-pack
cp -r ~/skillsbundle-pack/skills/* ~/hermes-agent/skills/
# 4. Verifica
ls ~/hermes-agent/skills/ | wc -l   # Deberias ver 1136

Una vez copiados, cada vez que uses Hermes Agent con un prompt que toque una vertical, la skill correspondiente se cargara automaticamente.

Incluye 1136 skills, actualizaciones gratuitas y soporte prioritario