Cómo instalar Hermes Agent en tu PC: guía paso a paso 2026

Requisitos previos

• Un PC con Windows 10/11, macOS o Linux
• Al menos 4 GB de RAM (8 GB recomendados)
• Conexión a internet
• Una suscripción o API key de algún modelo de IA (opcional al instalar, obligatorio para usar)
• Una cuenta de Telegram (opcional, pero recomendado para mensajería remota)

Paso 1 — Descargar e instalar Hermes Agent

Tienes dos caminos: el instalador de escritorio (recomendado) o la instalación por línea de comandos.

Opción A: Instalador de escritorio (recomendado para macOS y Windows)

La forma más sencilla es descargar el Hermes Desktop installer desde el sitio oficial y ejecutarlo. El instalador se encarga de todo: instala la CLI, la aplicación de escritorio y todas las dependencias necesarias.

Opción B: Instalación por línea de comandos

Windows (PowerShell nativo)

Abre PowerShell y ejecuta:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

El instalador descarga automáticamente todo lo necesario: uv, Python 3.11, Node.js, ripgrep, ffmpeg y un Git Bash portátil (MinGit). No requiere permisos de administrador.

Windows con WSL2 (alternativa recomendada para usuarios técnicos)

Si prefieres usar WSL2, primero instálalo desde PowerShell como administrador:

wsl --install

Reinicia el PC cuando se te pida. Luego abre la terminal de Ubuntu y ejecuta el mismo comando de Linux:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc

macOS (Intel y Apple Silicon)

Abre la terminal y ejecuta:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.zshrc

El instalador detecta automáticamente si estás en Apple Silicon (M1/M2/M3/M4) o Intel y descarga los binarios correctos.

Linux

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc

Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"

Paso 2 — Verificar la instalación

Después de instalar, recarga tu terminal y verifica que todo esté correcto:

hermes version
hermes doctor

hermes doctor hace un chequeo completo del sistema. Si todas las líneas están en verde, estás listo para continuar.

Paso 3 — Configurar el modelo de IA (Quick Setup)

Ejecuta el asistente de configuración:

hermes setup

El asistente te ofrece tres modos:

• Quick Setup (Nous Portal) — El camino más rápido. Login con OAuth, sin API keys. Recomendado para empezar.
• Full Setup — Configura cada proveedor, herramienta y opción manualmente. Trae tus propias API keys.
• Blank Slate — Todo desactivado excepto lo mínimo: proveedor, modelo, operaciones de archivos y terminal. Para usuarios avanzados que quieren control total.

Proveedores disponibles

Hermes soporta más de 300 modelos a través de múltiples proveedores:

• Nous Portal — Una suscripción, 300+ modelos, incluye Tool Gateway (búsqueda web, generación de imágenes, TTS, navegador cloud)
• OpenAI / Codex — GPT-5 y modelos recientes
• Anthropic — Claude
• Google AI — Gemini
• DeepSeek — Modelos económicos
• Ollama — Modelos locales gratuitos
• OpenRouter — Acceso a múltiples proveedores

Para activar Nous Portal en un comando:

hermes setup --portal

Esto te da una URL y un código. Ábrela en el navegador, autentícate y autoriza. Listo.

Puedes cambiar de proveedor en cualquier momento con:

hermes model

Paso 4 — Tu primera conversación

Inicia el chat:

hermes

O usa la interfaz TUI moderna:

hermes --tui

Verás un banner de bienvenida con tu modelo, herramientas disponibles y skills. Prueba con un prompt específico:

Resume este repositorio en 5 puntos y dime cuál es el archivo principal.

Si Hermes responde sin errores y puede usar herramientas (terminal, lectura de archivos, búsqueda web), ya tienes un agente funcional.

Verificar que las sesiones funcionan

Antes de continuar, verifica que puedes retomar sesiones:

hermes --continue

Debería llevarte de vuelta a la conversación anterior.

Paso 5 — Conectar Telegram (opcional pero recomendado)

Para hablar con tu agente desde Telegram, necesitas dos cosas:

1. Crear un bot en Telegram

1. Busca a @BotFather en Telegram (el oficial, con check azul)
2. Pulsa Start y usa el comando /newbot
3. Dale un nombre (ej. "My Hermes Agent")
4. Copia el token que te devuelve

2. Obtener tu User ID

1. Busca a @userinfobot en Telegram
2. Pulsa Start
3. Copia el ID que te muestra

3. Configurar el gateway

hermes gateway setup

Selecciona Telegram, pega el token del bot, luego tu User ID. Marca Telegram como tu canal home.

4. Iniciar el gateway

hermes gateway

Ahora abre tu bot en Telegram, pulsa Start y empieza a chatear con tu agente. La primera respuesta puede tardar un poco mientras carga.

Paso 6 — Comandos esenciales

Una vez instalado, estos son los comandos que más vas a usar:

Comandos dentro del chat (slash commands)

Paso 7 — Funciones avanzadas (capa siguiente)

Una vez que el chat base funciona, puedes añadir más capacidades:

Skills (habilidades)

Las skills son documentos de instrucciones que enseñan a Hermes a hacer tareas específicas — desplegar en Kubernetes, abrir un PR en GitHub, fine-tunear un modelo, buscar GIFs. Cada skill es un archivo SKILL.md que el agente carga solo cuando la tarea lo requiere.

hermes skills browse          # listar todas las disponibles
hermes skills search kubernetes  # buscar por palabra clave
hermes skills install openai/skills/k8s  # instalar una

Modo voz

Para dictar tareas a tu agente por voz:

cd ~/.hermes/hermes-agent
uv pip install -e ".[voice]"

Luego en el CLI activa voz con /voice on y pulsa Ctrl+B para grabar.

Tareas programadas (cron)

Hermes puede ejecutar tareas programadas. Solo configura cron después de que tu setup sea estable:

hermes tools   # ajustar acceso a herramientas
hermes skills   # instalar workflows reutilizables

Servidores MCP

Hermes soporta MCP (Model Context Protocol). Para añadir un servidor MCP, edita ~/.hermes/config.yaml:

mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

Solución de problemas

Si algo no funciona, sigue este orden de diagnóstico:

1. hermes doctor — chequeo completo del sistema
2. hermes model — verificar que el proveedor está configurado
3. hermes setup — reconfigurar desde cero
4. hermes sessions list — verificar sesiones guardadas
5. hermes --continue — retomar la última sesión
6. hermes gateway status — estado del gateway de mensajería

Problemas comunes

• "Command not found: hermes" — Recarga tu shell: source ~/.bashrc o source ~/.zshrc
• "Provider error: invalid API key" — Ejecuta hermes model y reconfigura el proveedor
• Windows: "bad interpreter" — Usa WSL2 o verifica que PowerShell está actualizado
• "Permission denied" durante la instalación — En Linux/macOS usa sudo solo si es necesario; en Windows ejecuta PowerShell como administrador
• Antivirus marca uv.exe — Falso positivo. Añade exclusión en Windows Defender

Conclusión

Hermes Agent representa un cambio de paradigma: en lugar de depender de servicios cerrados y limitados, puedes tener un agente de IA personal que se ejecuta en tu propia máquina, con el modelo que tú elijas, y que aprende y mejora con cada interacción.

La instalación toma menos de 10 minutos y los resultados son inmediatos. Si buscas un asistente de IA que respete tu privacidad, sea completamente personalizable y no te ate a un único proveedor, Hermes Agent es la respuesta.