Instalación de Hermes y configuración de OmniProxy

Hermes es un asistente capaz de conservar conversaciones y experiencias de tareas. Puede organizar lo que ya ha hecho como habilidades que podrás volver a utilizar más adelante. También puede conectarse mediante un mismo Gateway a Telegram, Discord, Slack, WhatsApp, Signal y la terminal; el Gateway funciona como un punto de entrada unificado que recibe y reenvía mensajes. Desde tus herramientas de chat habituales puedes encargarle revisiones de código, registros de incidentes o documentación de clientes, y después hacer que continúe trabajando en el repositorio.

Preparativos antes de la instalación

Primero, elige el método de instalación según el sistema operativo de tu ordenador. En macOS y Windows puedes utilizar directamente un instalador con interfaz gráfica; en Linux, macOS y WSL2 puedes usar el script para terminal. WSL2 es una función que permite ejecutar un entorno Linux dentro de Windows. Termux en teléfonos Android y Docker también tienen sus propios métodos de instalación, pero esta guía solo explica la instalación en ordenadores convencionales.

Si quieres una ventana

macOS, Windows

macOS: abre el DMG
Windows: abre el instalador
Instala la aplicación en el sistema

Si solo quieres el terminal

Linux, macOS, WSL2

Un único install.sh
En Windows, usa install.ps1
Cuando termine, escribe hermes

No los uses por ahora

pip, brew, AUR

Estos métodos de instalación no tienen soporte oficial
También dificultan las actualizaciones
Usa una de las dos opciones de la izquierda

Esta guía utiliza dos métodos: el instalador con interfaz gráfica y el script para terminal. pip, brew y AUR no se encuentran entre los métodos de instalación admitidos oficialmente.

Antes de comenzar, prepara un ordenador con macOS, Windows o Linux y confirma que puede abrir una terminal y acceder a GitHub. Si vas a instalar el programa en una unidad externa, conéctala primero y comprueba que tenga suficiente espacio disponible.

Instalación y primer inicio

Si quieres una interfaz gráfica

Ve a la sección de descargas del sitio web de Hermes y descarga el instalador correspondiente a tu sistema. El instalador ya incluye el entorno de ejecución, por lo que no es necesario compilarlo en el ordenador al abrirlo por primera vez.

macOS: abre el archivo DMG y coloca Hermes.app en «Aplicaciones». DMG es un formato de imagen de instalación utilizado habitualmente en macOS. Este instalador solo admite equipos con chips Apple; los Mac con Intel no son compatibles.
Windows: abre el archivo .appinstaller con el Instalador de aplicaciones de Windows. Este instala un MSIX firmado, que es un tipo de paquete de instalación de aplicaciones utilizado por Windows.
Linux: los instaladores de escritorio son para macOS y Windows. En Linux, utiliza el comando de terminal que aparece a continuación. Después de la instalación, puedes ejecutar hermes desktop.

Si solo necesitas la terminal

Si utilizas Linux, macOS o WSL2, ejecuta lo siguiente en la terminal:

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

Si utilizas el PowerShell incluido con Windows, ejecuta:

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

El instalador descargará el código de Hermes y los programas necesarios para ejecutarlo. Si la descarga se interrumpe, vuelve a ejecutar el mismo comando. Una vez completada la instalación, cierra la terminal actual, abre una ventana nueva e introduce:

hermes

Si aparece el indicador de Hermes, significa que el comando ya está disponible. A continuación, puedes ejecutar hermes doctor; esta comprobación de la instalación te indicará qué componentes siguen faltando.

Instalar el programa en una unidad externa

El 9 de octubre de 2026, Hermes Agent v0.21.6 se instaló en una unidad externa conectada a un Mac. El programa se encontraba en /Volumes/AItools/tools/hermes-agent, el comando de inicio en ~/.local/bin/hermes, y la configuración y las conversaciones seguían almacenadas en ~/.hermes.

Si tu unidad tiene un nombre diferente, sustituye la ruta situada después de --dir por la de tu propia carpeta. La unidad debe permanecer conectada mientras se ejecuta Hermes.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh -o install.sh
bash install.sh --dir /Volumes/AItools/tools/hermes-agent --non-interactive

Programa

Disco externo

tools/hermes-agent
El código se guarda aquí

Comando

~/.local/bin/hermes

Escribe hermes en el terminal
Se aplicará al abrir una ventana nueva

Configuración y conversaciones

~/.hermes

config.yaml está aquí
Sal antes de desconectar el disco

Esta es la distribución utilizada en ese Mac. La instalación predeterminada coloca el programa en el directorio del usuario, pero el resultado es el mismo: abre una terminal nueva e introduce hermes.

Obtener los parámetros de conexión de OmniProxy

En esta configuración, Hermes se conecta a OmniProxy, no directamente a Grok o Gemini. Las direcciones de servicio de Grok y Gemini se configuran en OmniProxy; no las introduzcas directamente en Hermes.

Tu ordenador

Hermes

Puerta de enlace local

OmniProxy

La dirección debe incluir /v1

Grok

grok-4.7

Gemini

gemini-3.8-flash

Hermes solo ve OmniProxy. OmniProxy se encarga de reenviar las solicitudes a Grok y Gemini.

El ID del modelo es el nombre exacto que utiliza la API para identificarlo. Usa los siguientes nombres para los dos modelos:

Para Grok, introduce grok-4.7. La API de xAI es https://api.x.ai/v1 y las solicitudes de chat utilizan /v1/chat/completions. Consulta la documentación de modelos de Grok.
Para Gemini, introduce gemini-3.8-flash. La API compatible con OpenAI de Google es https://generativelanguage.googleapis.com/v1beta/openai/. Consulta la información sobre compatibilidad de Gemini con OpenAI.

Para cambiar a Gemini en Hermes, solo tienes que sustituir el nombre del modelo por gemini-3.8-flash; la dirección de la API debe seguir siendo la de OmniProxy.

Copia de OmniProxy la dirección de la API y la clave, y después introduce el ID del modelo correspondiente:

Base URL: https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: grok-4.7

Base URL es la dirección de la API a la que Hermes envía las solicitudes; en este caso debe terminar en /v1. API Key es la clave que OmniProxy proporciona a Hermes. Sustitúyela por tu propia clave y no la publiques en páginas accesibles al público.

Si la instancia local de OmniProxy no requiere una clave, puedes dejar API Key en blanco. Si otras personas pueden acceder a la dirección, debes configurar una clave. También debes confirmar que la dirección sea accesible desde el entorno donde se ejecuta Hermes. Si Hermes y OmniProxy se encuentran en el mismo ordenador, puedes usar una dirección local.

Introducir la configuración de la herramienta

Primero, sal del chat en curso y ejecuta lo siguiente en la terminal:

hermes model

Selecciona Custom endpoint (self-hosted / VLLM / etc.). Custom endpoint es un endpoint personalizado que permite conectar Hermes a la dirección de servicio que especifiques, en lugar de usar un proveedor preconfigurado.

El asistente solicitará, en este orden, la dirección de la API, la clave y el nombre del modelo. Introduce los tres valores indicados en la sección anterior. Para utilizar Gemini, introduce gemini-3.8-flash como nombre del modelo.

También puedes editar directamente ~/.hermes/config.yaml. YAML es un formato de texto que utiliza la sangría para representar las relaciones entre los elementos de configuración. Esta es la configuración para Grok:

model:
  default: grok-4.7
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

Para utilizar Gemini, cambia default a gemini-3.8-flash y deja sin cambios los otros tres valores:

model:
  default: gemini-3.8-flash
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

Después de guardar, vuelve a ejecutar hermes e inicia un chat nuevo. En una sesión que ya esté abierta, /model solo permite cambiar entre proveedores que ya estén guardados; no sirve para añadir esta configuración.

Verificar una tarea real

hermes doctor

La comprobación de la instalación se ha superado

Envía una frase corta

Comprueba que aparece la respuesta de Hermes

Abre el registro de llamadas

Verifica el nombre del modelo

La configuración solo se considera operativa después de completar los tres pasos.

Ejecuta hermes doctor para comprobar que la instalación esté completa.
Ejecuta hermes y pídele que explique en una sola frase qué puede hacer. Deberías recibir una respuesta.
Abre el registro de solicitudes de OmniProxy, confirma que la solicitud procede de Hermes y comprueba si el nombre del modelo es grok-4.7 o gemini-3.8-flash.

Ver que el asistente de configuración guardó los datos correctamente o que la API devolvió una respuesta satisfactoria no basta para demostrar que Hermes ya puede completar tareas por ti. El nombre del modelo que aparece en el registro de solicitudes debe coincidir con el valor introducido.

Para chatear desde el navegador, ejecuta lo siguiente en el ordenador local:

hermes dashboard --no-open --host 127.0.0.1 --port 9119

Después, abre http://127.0.0.1:9119. Esta dirección solo funciona en el ordenador actual.

Errores frecuentes

Al introducir hermes, aparece un mensaje que indica que no se encuentra el comando: cierra la terminal y abre una ventana nueva. Si sigue sin encontrarse, confirma que ~/.local/bin esté incluido en PATH; PATH es la lista de ubicaciones donde el sistema busca los directorios que contienen comandos. En Windows, confirma que el directorio de inicio añadido por el instalador esté incluido en PATH.
La descarga de la instalación se interrumpe a la mitad: vuelve a ejecutar el mismo comando de instalación; se reutilizará la parte que ya se haya descargado.
Hermes no responde o indica que no puede conectarse: confirma que OmniProxy esté en ejecución y comprueba que Base URL termine en /v1. Si Hermes se ejecuta dentro de Docker y OmniProxy se encuentra en el sistema anfitrión, no utilices 127.0.0.1, ya que esa dirección solo es válida dentro del contenedor.
Aparece un error de clave: actualiza la clave de OmniProxy y modifica el valor api_key de config.yaml. Las claves de xAI o Google forman parte de la configuración de proveedores de OmniProxy; no las introduzcas en este campo de Hermes.
Aparece un mensaje que indica que el modelo no existe: abre la lista actual de modelos de OmniProxy y copia grok-4.7 o gemini-3.8-flash exactamente como aparezca en la lista.
Hermes responde, pero no puede leer archivos, ejecutar comandos ni realizar tareas similares: cambia a otro modelo de OmniProxy que disponga de esas capacidades y abre una nueva sesión de Hermes.
El programa está instalado en una unidad externa y hermes doctor muestra un error de almacenamiento después de desconectarla: vuelve a conectar primero esa unidad. No permitas que Hermes cree otra configuración mientras la unidad esté desconectada.

Referencias oficiales

Para conocer los pasos de instalación, consulta la documentación de instalación de Hermes y la compatibilidad con plataformas. Para configurar Custom endpoint, consulta la documentación de proveedores de Hermes. Los ID de los modelos aparecen respectivamente en la documentación de modelos de Grok y en la información sobre compatibilidad de Gemini con OpenAI.

La instalación en macOS se completó el 2026-10-09 con Hermes Agent v0.21.6. grok-4.7 y gemini-3.8-flash eran los ID de modelo estándar indicados ese día en la documentación de xAI y Google. Al introducirlos, utiliza como referencia los nombres que aparezcan en OmniProxy.

Reemplaza cada marcador de posición con valores de tu propia configuración de OmniProxy. Nunca publiques una clave real.

Un resultado guardado o HTTP 200 por sí solo no demuestra compatibilidad total con el Agente. Verifica el origen y el modelo en el registro de llamadas de OmniProxy.

Fuentes oficiales · Hermes ↗