Primeros Pasos

Instalar Hermes Agent

En funcionamiento en menos de 2 minutos. Un comando, sin requisitos previos (excepto Git). Funciona en Linux, macOS, WSL2 y Windows.

Terminal
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Works on macOS 12+. The installer handles all dependencies automatically.

Instalación — Paso a Paso

Step 01

1. Ejecutar el Instalador

Abre tu terminal y pega el comando. El instalador detecta tu sistema operativo y lo gestiona todo automáticamente.

# macOS / Linux / WSL2

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

# Windows (PowerShell)

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

2. Elige tu Modelo

Después de la instalación, elige tu proveedor LLM. Nous Portal (OAuth), OpenRouter, OpenAI, Anthropic, Gemini o un endpoint personalizado.

# Choose your LLM provider interactively

hermes model

# Or use Nous Portal (OAuth, no API key needed)

hermes setup --portal
Step 03

3. Conecta tus Plataformas

Configura el gateway de mensajería para contactar a tu agente por Telegram, Discord, Slack, WhatsApp o Signal — todo desde un proceso de gateway unificado.

# Interactive gateway setup wizard

hermes gateway setup

# Start the messaging gateway

hermes gateway
Step 04

4. Empieza a Chatear

Escribe hermes en tu terminal y comienza tu primera conversación. El agente empieza a aprender inmediatamente — construyendo memoria y creando habilidades.

# Reload your shell first, then:

source ~/.bashrc # or: source ~/.zshrchermes

Requisitos Previos

En plataformas no Windows, solo necesitas Git. En Linux, asegúrate de que curl y xz-utils estén disponibles. El instalador se encarga del resto automáticamente.

Lo que el Instalador Gestiona Automáticamente

Dependencias auto-instaladas:

uv (gestor de paquetes Python), Python 3.11, Node.js v22, ripgrep (búsqueda rápida de archivos), ffmpeg (conversión de audio)

Estructura de Instalación

Dónde se encuentran los archivos después de la instalación:

Tipo de instalaciónUbicación del códigoBinarioDirectorio de datos
Usuario (git)~/.hermes/hermes-agent/~/.local/bin/hermes~/.hermes/
Root (sudo)/usr/local/lib/hermes-agent//usr/local/bin/hermes/root/.hermes/

Ruta más Rápida: Nous Portal

Una suscripción cubre más de 300 modelos más el Tool Gateway (búsqueda web, generación de imágenes, TTS, navegador en la nube). Ejecuta hermes setup --portal para inicio de sesión OAuth + configuración del proveedor + activación del Tool Gateway en un solo comando.

hermes setup --portal

Después de la Instalación

Recarga tu shell y empieza a chatear

source ~/.bashrc # or: source ~/.zshrchermes # Start chatting!

Solución de Problemas

ProblemaSolución
hermes: command not foundRecarga tu shell (source ~/.bashrc o source ~/.zshrc) o revisa tu PATH.
API key not setEjecuta hermes model para configurar tu proveedor, o hermes config set PROVIDER_API_KEY tu_clave.
Configuración perdida tras actualizarEjecuta hermes config check y luego hermes config migrate.

Ejecuta hermes doctor en cualquier momento para diagnosticar tu instalación. Te dice exactamente qué falta y cómo solucionarlo.