Guía 05 · Hermes Agent · 2026
Open source · Gratis · 100% privado

Tu propio agente de IA
viviendo dentro de tu Mac.

La guía definitiva para instalar Hermes, el agente open source de Nous Research, en tu MacBook. Memoria propia, navegador, terminal, conexión con WhatsApp, y vos decidís qué cerebro usa por dentro.

10 minutos de instalación. Cualquier Mac (Intel o Apple Silicon). Costo: cero.

Lo que vas a encontrar aquí
¿Qué es Hermes?Antes de empezarPaso 1 · Abrir la TerminalPaso 2 · Pegar el comandoPaso 3 · Instalación automáticaPaso 4 · Browser internoPaso 5 · Elegir proveedorPaso 6 · Iniciar sesiónPaso 7 · Elegir modeloPaso 8 · Tu agente está vivoComandos útilesSi algo no funcionaPreguntas frecuentes
Contexto

¿Qué es
Hermes, exactamente?

Hermes es un agente de IA open source creado por Nous Research. Imaginá tu propio ChatGPT, pero viviendo dentro de tu computadora, con memoria propia, capacidad de navegar la web, ejecutar comandos en tu terminal, gestionar archivos, generar imágenes y hasta conectarse con tu WhatsApp.

La diferencia clave con cualquier ChatGPT, Claude o Gemini que usés ahora: vos decidís qué modelo usa por dentro. Podés enchufale GPT, Claude, Gemini, DeepSeek, Grok, Qwen, lo que quieras. Y todo se queda en tu Mac. Sin suscripciones obligatorias.

29
Herramientas integradas
25+
Proveedores de IA disponibles
∞
Memoria persistente

Lo que viene de fábrica

01
Navegador
Busca en internet, lee páginas, extrae datos. Sin abrir tu Chrome.
02
Terminal
Ejecuta comandos en tu Mac. Te ayuda a programar o automatizar tareas.
03
Memoria
Recuerda tus preferencias y conversaciones anteriores entre sesiones.
04
WhatsApp
Háblale por WhatsApp y mantén contexto entre conversaciones.
05
Imágenes
Genera imágenes desde texto sin salir del agente.
06
Skills
Creá habilidades personalizadas para tareas que repetís todo el tiempo.
Antes de empezar

Qué necesitás
tener listo.

No te asustes, no hace falta saber programar ni nada raro. Esto es lo único que necesitás:

Un Mac. Da igual si es Intel o Apple Silicon (M1, M2, M3, M4). Funciona en cualquiera con macOS razonablemente actualizado.
Conexión a internet decente. La instalación descarga unos 200-300 MB de cosas.
Una cuenta del proveedor de IA que vayas a usar. Si tenés ChatGPT Plus o Claude Pro, ya está. Si no, casi todos tienen capa gratuita.
10 minutos de tu tiempo y nada más. Lo demás se instala solo.
Paso 01 · Abrir la Terminal

Primero, abrí
la Terminal.

— Tranqui
Si nunca abriste la Terminal de tu Mac, no pasa nada. La Terminal solo es una ventana donde escribís comandos, no rompe nada.

Para abrirla:

1.Presioná Cmd + Espacio para abrir Spotlight.
2.Escribí Terminal y dale Enter.
3.Se va a abrir una ventana negra con texto. Esa es.
Paso 02 · Pegar el comando

Pegá este comando
y dale Enter.

Este es el comando mágico. Copialo entero, pegalo en la Terminal y presioná Enter:

terminal
$ curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
— Importante
El comando curl descarga un script y | bash lo ejecuta. Es seguro porque viene del repositorio oficial de Nous Research, pero como regla general: no ejecutés comandos así de webs random.
Paso 03 · Instalación automática

Hermes se instala solo.

Lo primero que ves es el banner del instalador. Hermes empieza a montar todo lo que necesita. Detecta tu sistema, instala uv (un gestor de paquetes de Python rapidísimo) y prepara el terreno. Vas a ver muchísimo texto pasando por la pantalla, es totalmente normal, no toques nada.

terminal · output del instalador
  ┌─────────────────────────────────────┐
  │   ÷ Hermes Agent Installer          │
  │   An open source AI agent by Nous.  │
  └─────────────────────────────────────┘

✓ Detected: macos (macos)
→ Checking for uv package manager...
→ Installing uv (fast Python package manager)...
installing to /Users/juana/.local/bin
  uv
  uvx
everything's installed!

✓ uv installed (uv 0.11.7)
→ Checking Python 3.11...
→ Python 3.11 not found, installing via uv...
Installed Python 3.11.15 in 1.30s
+ cpython-3.11.15-macos-arm64-none
— Truco
Aprovechá estos minutos para ir por un café. Tarda entre 2 y 5 minutos según tu internet. Si parece que se queda colgado, casi siempre es solo que está descargando algo grande.
Paso 04 · Browser interno

Le instala su propio Chrome
sin que abras nada.

Esta parte siempre sorprende. Hermes se descarga su propio navegador headless (sin ventana visible) para poder navegar la web por vos cuando se lo pidas. No interfiere con tu Chrome ni con tu Safari, vive aparte.

terminal · descarga del browser
Downloading FFmpeg (playwright ffmpeg v1011)
FFmpeg downloaded to ~/Library/Caches/ms-playwright
Downloading Chrome Headless Shell 147.0.7727.15
Chrome Headless Shell downloaded successfully
✓ Browser engine setup complete
→ Installing TUI dependencies...
Paso 05 · Elegir proveedor

Elegí qué cerebro
va a tener tu agente.

Cuando termina la instalación, Hermes te muestra la lista de proveedores de IA. Decidís qué modelo va a estar pensando por dentro de tu agente. Te movés con las flechas ↑↓ y seleccionás con Enter.

terminal · selección de proveedor
Select provider:
 ↑↓ navigate    ENTER/SPACE select    ESC cancel

   (●) Nous Portal (Nous Research subscription)
   (○) OpenRouter (100+ models, pay-per-use)
   (○) Vercel AI Gateway (200+ models, $5 free)
   (○) Anthropic (Claude models — API key)
   (○) OpenAI Codex
   (○) Google Gemini via OAuth + Code Assist (free)
   (○) DeepSeek (DeepSeek-V3, R1, coder)
   (○) xAI (Grok models — direct API)
   (○) Custom endpoint (enter URL manually)
   ... y muchos más

¿Cuál elegir? Mi recomendación rápida

Ya pagás Claude Pro
→ Anthropic
Es lo que recomiendo. Metés tu API key.
Ya pagás ChatGPT Plus
→ OpenAI Codex
Reusás tu cuenta, no pagás nada extra.
Querés gratis sin tarjeta
→ Google Gemini via OAuth
Tiene capa gratuita generosa.
Querés flexibilidad total
→ OpenRouter
100+ modelos, pagás por uso. Suele ser centavos.
Te importa la privacidad
→ Nous Portal
Del propio equipo que hace Hermes.
Paso 06 · Iniciar sesión

Vinculá tu cuenta con
un código de 9 caracteres.

Una vez elegís el proveedor, Hermes te genera un enlace y un código corto. Es un sistema de login muy seguro que no requiere copiar API keys ni nada.

terminal · login
◆ Inference Provider
  Choose how to connect to your main chat model.

Current model:    anthropic/claude-opus-4-7
Active provider:  none

Not logged into Anthropic. Starting login...

To continue, follow these steps:

  1. Open this URL in your browser:
     https://auth.anthropic.com/device

  2. Enter this code:
     0D9N-GQ3JU

Waiting for sign-in... (press Ctrl+C to cancel)
1.Abrís el enlace en tu navegador.
2.Pegás el código exacto que ves en la terminal.
3.Autorizás la conexión. Volvés a la terminal.
— El código caduca rápido
El código de 9 caracteres caduca en unos 3-5 minutos. Si tardás mucho en pegarlo te toca repetir el paso de login. No pasa nada, no rompe nada.
Paso 07 · Elegir modelo

Elegí el modelo
correcto para tu uso.

Después del login, Hermes te muestra los modelos disponibles del proveedor que elegiste. Para uso general:

Uso general y razonamiento
claude-opus-4-7
El más potente de Anthropic.
Producción y escritura
claude-sonnet-4-6
Buen equilibrio velocidad/calidad.
Tareas rápidas y repetitivas
claude-haiku-4-5
El más rápido y barato.
Paso 08 · Tu agente está vivo

Tu agente
está vivo.

Si llegaste hasta acá y la pantalla tiene el prompt de Hermes activo, ya está. Tu agente está vivo. Probalo con algo concreto:

hermes · primeras pruebas
> hermes
Hermes Agent v0.8.2 · claude-opus-4-7

¿En qué trabajamos hoy?

> busca en internet qué tiempo hace mañana en Buenos Aires

> abre el archivo README.md de este directorio y resumilo

> crea un archivo llamado notas.md con las ideas que discutimos

> recuerda que mi nombre es Nico y que trabajo con React
Comandos útiles

Los comandos
que vas a usar más.

hermesArranca el agente (interfaz TUI en la terminal).
hermes modelCambia el modelo activo.
hermes configAbre la configuración interactiva.
hermes memory listMuestra lo que el agente recuerda de vos.
hermes memory clearBorra toda la memoria.
hermes skillsLista tus skills instalados.
hermes whatsapp connectConecta WhatsApp (escaneas QR).
rm -rf ~/.hermes ~/.local/bin/hermesDesinstalación completa.
Troubleshooting

Si algo
no funciona.

La instalación se cuelga sin hacer nada
Casi siempre es solo lentitud de conexión. Esperá 2-3 minutos antes de cancelar. Si se te acaba la paciencia, dale Ctrl+C, esperá unos segundos y volvé a lanzar el comando de instalación. Lo que ya descargó no lo vuelve a bajar.
Error de autenticación
El código de 9 caracteres caduca rápido (unos 3-5 minutos). Si tardás mucho en pegarlo te toca repetir el paso de login. No pasa nada, no rompe nada.
"Permission denied" al instalar
Macs nuevos a veces piden permisos extra. Si sale ese error, probá ejecutar: sudo [el mismo comando]. Te va a pedir tu contraseña de Mac. La escribís (no se ve, es normal) y le das Enter.
Hermes responde raro o muy corto
Probablemente tenés un modelo haiku o mini activo. Cambiá a uno más potente con hermes model y elegí claude-opus-4-7 o claude-sonnet-4-6.
Quiero desinstalarlo
Borrá estas carpetas: rm -rf ~/.hermes ~/.local/bin/hermes — y queda como nuevo.
FAQ

Lo que me
preguntan siempre.

¿Es seguro? ¿Mis datos van a alguna parte rara?
El código de Hermes es open source y podés revisarlo. Tus conversaciones van al proveedor de IA que elegiste (Anthropic, OpenAI, etc.) bajo sus términos. La memoria, la configuración y las skills se quedan en tu Mac, en la carpeta ~/.hermes.
¿Cuesta dinero?
Hermes en sí es gratis. Lo que cuesta es el modelo que elijas: si usás tu cuenta de Claude Pro o ChatGPT Plus, no pagás extra. Si usás APIs pay-per-use como OpenRouter, pagás por consumo (suele ser centavos). Si querés totalmente gratis, Google Gemini tiene capa gratuita decente.
¿Puedo usarlo en Windows o Linux?
Sí, pero esta guía es específica para Mac. La instalación en Linux es muy parecida. En Windows necesitás WSL (Windows Subsystem for Linux) o Git Bash.
¿Puedo cambiar de modelo después?
Sí, cuando quieras. Solo escribí hermes model en la terminal y elegís otro. Podés tener varios proveedores configurados a la vez.
¿Funciona offline?
El agente sí, pero el modelo no (a menos que uses uno local con Ollama). La mayoría lo usa online porque los modelos buenos son los de la nube. Si te importa la privacidad total, configurá Hermes con Ollama y un modelo local como Llama o Qwen.
¿Va a ralentizar mi Mac?
No. Hermes solo consume recursos cuando lo estás usando, y muy poco. La carga real está en el servidor del proveedor de IA, no en tu máquina. Excepción: si usás un modelo local con Ollama, ahí sí consume CPU/GPU/RAM.
— el siguiente paso

Ya tenés el agente.
Ahora aprendé a sacarle dinero.

Esta guía te lo deja instalado. La comunidad te enseña a usarlo de verdad: skills personalizadas, automatizaciones reales, casos de clientes y soporte directo cuando te atascarás.

Ver todas las guías →