Instalación de Hermes y configuración de OmniProxy

Hermes es un asistente que puede retener conversaciones y experiencia en tareas, convirtiendo el trabajo completado en habilidades que pueden reutilizarse más tarde. A través de una única Pasarela (Gateway), también puede conectarse a Telegram, Discord, Slack, WhatsApp, Signal y el terminal. La Pasarela sirve como un punto de entrada unificado para recibir y reenviar mensajes. Puedes enviarle revisiones de código, notas de incidentes o materiales de clientes desde tus herramientas de chat habituales, y luego hacer que vuelva al repositorio y continúe trabajando.

Antes de empezar

Primero, elige un método de instalación basado en el sistema operativo de tu ordenador. macOS y Windows pueden utilizar instaladores gráficos directamente, mientras que Linux, macOS y WSL2 pueden utilizar un script de terminal. WSL2 es una característica de Windows para ejecutar un entorno Linux. Termux en teléfonos Android y Docker tienen sus propios métodos de instalación, pero esta guía solo cubre la instalación en ordenadores normales.

Quieres una ventana

macOS, Windows

macOS: abrir el DMG
Windows: abrir el instalador
Instalar la aplicación en el sistema

Solo terminal

Linux, macOS, WSL2

Un comando install.sh
Usar install.ps1 en Windows
Introducir hermes tras la instalación

No usar estos todavía

pip, brew, AUR

Estos métodos de instalación no son compatibles oficialmente
También son difíciles de actualizar tras la instalación
Usa una de las dos opciones de la izquierda en su lugar

Esta guía cubre dos rutas: instaladores gráficos y scripts de terminal. pip, brew y AUR no son métodos de instalación compatibles oficialmente.

Antes de empezar, prepara un ordenador con macOS, Windows o Linux y asegúrate de que puede abrir un terminal y acceder a GitHub. Si planeas instalar Hermes en una unidad externa, conecta la unidad primero y confirma que tiene suficiente espacio libre.

Instalación y lanzamiento por primera vez

Si quieres una aplicación gráfica

Ve a la sección de descargas en el sitio web de Hermes y descarga el instalador para tu sistema operativo. El instalador ya incluye el entorno de ejecución, por lo que no es necesario compilar nada localmente cuando lo abres por primera vez.

macOS: Abre el DMG y mueve Hermes.app a Aplicaciones. Un DMG es una imagen de instalación comúnmente utilizada en macOS. Este instalador solo admite silicio de Apple; los Macs con Intel no son compatibles.
Windows: Abre el archivo .appinstaller con el Instalador de aplicaciones de Windows. Instala un MSIX firmado, un tipo de paquete de aplicación utilizado por Windows.
Linux: Los instaladores de escritorio son para macOS y Windows. En Linux, utiliza el comando de terminal a continuación. Tras la instalación, puedes ejecutar hermes desktop.

Si solo necesitas el terminal

Si utilizas Linux, macOS o WSL2, ejecuta esto en un terminal:

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

Cuando utilices el PowerShell incluido con Windows, ejecuta:

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

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

hermes

Si ves el aviso de Hermes, el comando está listo para usar. Luego puedes ejecutar hermes doctor; esta comprobación de instalación te indica qué falta todavía.

Almacenar 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 almacenó en /Volumes/AItools/tools/hermes-agent, el comando de lanzamiento se ubicó en ~/.local/bin/hermes, y la configuración y los datos de conversación permanecieron en ~/.hermes.

Si tu unidad tiene un nombre diferente, reemplaza la ruta después de --dir con tu propia carpeta. La unidad debe permanecer conectada mientras Hermes esté en ejecución.

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

Programa

Unidad externa

tools/hermes-agent
Mantener el código aquí

Comando

~/.local/bin/hermes

Introducir hermes en el terminal
Surte efecto tras abrir una ventana nueva

Configuración y chats

~/.hermes

config.yaml está aquí
Salir antes de desconectar la unidad

Así es como se organizaron los archivos en ese Mac. Una instalación predeterminada coloca el programa en el directorio del usuario, con el mismo resultado: abre un terminal nuevo e introduce hermes.

Obtener valores de conexión de OmniProxy

Aquí, Hermes se conecta a OmniProxy en lugar de directamente a Grok o Gemini. Configura las URLs de servicio de Grok y Gemini en OmniProxy; no las introduzcas directamente en Hermes.

Tu ordenador

Hermes

Pasarela local

OmniProxy

Incluir /v1 en la dirección

Grok

grok-4.7

Gemini

gemini-3.8-flash

Hermes ve a OmniProxy. OmniProxy reenvía las solicitudes a Grok y Gemini.

Un ID de modelo es el nombre exacto que utiliza la API para identificar un modelo. Utiliza 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 del modelo Grok.
Para Gemini, introduce gemini-3.8-flash. La API compatible con OpenAI de Google es https://generativelanguage.googleapis.com/v1beta/openai/. Consulta la documentación de compatibilidad con OpenAI de Gemini.

Para cambiar Hermes a Gemini, solo cambia el nombre del modelo a gemini-3.8-flash. Continúa utilizando la dirección de OmniProxy como punto de conexión de la API.

Copia la URL del punto de conexión y la clave de OmniProxy, luego introduce el ID de modelo correspondiente:

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

Base URL es el punto de conexión al que Hermes envía las solicitudes. Debe terminar con /v1 aquí. API Key es la clave que OmniProxy emite a Hermes. Reemplaza el marcador de posición con tu propio valor y no lo publiques en una página pública.

Si tu instancia local de OmniProxy no requiere una clave, puedes dejar API Key vacía. Si la dirección es accesible para cualquier otra persona, deberías usar una clave. Confirma también que la dirección sea alcanzable desde el entorno donde se ejecuta Hermes. Si Hermes y OmniProxy están en el mismo ordenador, puedes usar una dirección local.

Introducir la configuración de la herramienta

Primero, sal del chat actual, luego ejecuta esto en un terminal:

hermes model

Selecciona Custom endpoint (self-hosted / VLLM / etc.). Custom endpoint significa que Hermes se conecta a una dirección de servicio que tú especificas en lugar de utilizar un proveedor preestablecido.

El asistente de configuración solicita la URL del punto de conexión, la clave y el nombre del modelo en secuencia. Introduce los tres valores de la sección anterior. Para utilizar Gemini, introduce gemini-3.8-flash como nombre del modelo.

También puedes editar ~/.hermes/config.yaml directamente. YAML es un formato de texto que utiliza sangría para representar relaciones de configuración. La siguiente configuración utiliza 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 los otros tres valores sin cambios:

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, ejecuta hermes de nuevo e inicia un chat nuevo. En una sesión ya abierta, /model solo puede cambiar entre proveedores que ya se han guardado; no puede añadir esta configuración.

Verificar con una tarea real

hermes doctor

La comprobación de instalación pasa

Enviar un mensaje corto

Ver una respuesta de Hermes

Abrir los registros de solicitudes

Verificar el nombre del modelo

La configuración solo es utilizable después de completar los tres pasos.

Ejecuta hermes doctor para comprobar si la instalación está completa.
Ejecuta hermes y pídele que explique en una frase lo que puede hacer. Deberías ver una respuesta.
Abre el registro de solicitudes de OmniProxy, confirma que la solicitud provino 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 se guardó correctamente, o que la API devolvió una respuesta exitosa, no es suficiente para demostrar que Hermes puede completar tareas por ti. El nombre del modelo en el registro de solicitudes debe coincidir con el valor que introdujiste.

Para chatear en un navegador, ejecuta lo siguiente localmente:

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

Luego abre http://127.0.0.1:9119. Esta dirección solo funciona en el ordenador actual.

Errores comunes

Introducir hermes informa de que no se puede encontrar el comando: Cierra el terminal y abre una ventana nueva. Si el comando sigue sin encontrarse, confirma que ~/.local/bin está en PATH. PATH es la lista de directorios donde el sistema busca comandos. En Windows, confirma que el directorio de lanzamiento añadido por el instalador está en PATH.
La descarga de la instalación se detiene a mitad de camino: Ejecuta el mismo comando de instalación de nuevo. Las partes ya descargadas se reutilizarán.
Hermes no responde o informa de que no puede conectarse: Confirma que OmniProxy está en ejecución y comprueba que Base URL termina con /v1. Si Hermes se ejecuta en Docker mientras OmniProxy se ejecuta en el host, no utilices 127.0.0.1 si solo es válido dentro del contenedor.
Aparece un error de clave: Actualiza la clave de OmniProxy, luego cambia api_key en config.yaml. La clave de xAI o Google pertenece a la configuración de proveedor de OmniProxy; no la introduzcas en este campo de Hermes.
El modelo se informa como no disponible: Abre la lista de modelos actual en OmniProxy y copia grok-4.7 o gemini-3.8-flash exactamente como aparece en la lista.
Hermes responde pero no puede realizar tareas como leer archivos o ejecutar comandos: Cambia a otro modelo en OmniProxy que tenga esas capacidades, luego inicia una sesión de Hermes nueva.
El programa está en una unidad externa y hermes doctor informa de un error de almacenamiento después de desconectar la unidad: Vuelve a conectar la unidad primero. No dejes que Hermes cree una configuración independiente mientras la unidad está desconectada.

Referencias

Para los pasos de instalación, consulta la documentación de instalación de Hermes y el soporte de plataforma. Para la configuración de Custom endpoint, consulta la documentación del Proveedor de Hermes. Para los IDs de modelos, consulta la documentación del modelo Grok y la documentación de compatibilidad con OpenAI de Gemini.

El proceso de instalación en macOS se completó el 09-10-2026 utilizando Hermes Agent v0.21.6. grok-4.7 y gemini-3.8-flash eran los IDs de modelos estándar en la documentación de xAI y Google en esa fecha. Al introducir los valores, utiliza los nombres mostrados 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 prueba la compatibilidad total del Agente. Comprueba el origen y el modelo en el registro de llamadas de OmniProxy.

Fuentes oficiales · Hermes ↗