Instalación de Hermes y configuración de OmniProxy

Hermes es un asistente que puede retener conversaciones y la experiencia de tareas, convirtiendo el trabajo completado en habilidades que pueden reutilizarse más tarde. A través de una única puerta de enlace (Gateway), también puede conectarse a Telegram, Discord, Slack, WhatsApp, Signal y la terminal. La puerta de enlace 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 regrese al repositorio y continúe trabajando.

Antes de empezar

Primero, elige un método de instalación basado en el sistema operativo de tu computadora. macOS y Windows pueden usar instaladores gráficos directamente, mientras que Linux, macOS y WSL2 pueden usar 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 cubre solo la instalación en computadoras regulares.

¿Quieres una ventana?

macOS, Windows

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

Solo terminal

Linux, macOS, WSL2

Un comando install.sh
Usa install.ps1 en Windows
Ingresa hermes después de la instalación

No uses estos todavía

pip, brew, AUR

Estos métodos de instalación no son compatibles oficialmente
También son difíciles de actualizar después de 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 comenzar, prepara una computadora con macOS, Windows o Linux y asegúrate de que pueda abrir una terminal y acceder a GitHub. Si planeas instalar Hermes en una unidad externa, conéctala primero y confirma que tiene suficiente espacio libre.

Instalación y primer inicio

Si quieres una aplicación gráfica

Ve a la sección de descarga 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 abras 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; las Mac 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, usa el comando de terminal a continuación. Después de la instalación, puedes ejecutar hermes desktop.

Si solo necesitas la terminal

Si usas Linux, macOS o WSL2, ejecuta esto en una terminal:

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

Cuando uses 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 nuevamente. Después de que finalice la instalación, cierra la terminal actual, abre una ventana nueva e ingresa:

hermes

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

Almacenar el programa en una unidad externa

El 09-10-2026, Hermes Agent v0.21.6 se instaló en una unidad externa conectada a una Mac. El programa se almacenó en /Volumes/AItools/tools/hermes-agent, el comando de inicio se ubicó en ~/.local/bin/hermes, y los datos de configuración y 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 se esté ejecutando.

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
Mantén el código aquí

Comando

~/.local/bin/hermes

Ingresa hermes en la terminal
Surte efecto después de abrir una ventana nueva

Configuración y chats

~/.hermes

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

Así es como se organizaron los archivos en esa Mac. Una instalación predeterminada coloca el programa en el directorio del usuario, con el mismo resultado: abre una terminal nueva e ingresa hermes.

Obtener valores de conexión de OmniProxy

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

Tu computadora

Hermes

Puerta de enlace local

OmniProxy

Incluye /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 la API utiliza para identificar un modelo. Usa los siguientes nombres para los dos modelos:

Para Grok, ingresa grok-4.7. La API de xAI es https://api.x.ai/v1, y las solicitudes de chat usan /v1/chat/completions. Consulta la documentación del modelo Grok.
Para Gemini, ingresa 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 usando 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 ingresa 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 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 la misma computadora, puedes usar una dirección local.

Ingresar la configuración de la herramienta

Primero, sal del chat actual, luego ejecuta esto en una 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 usar 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. Ingresa los tres valores de la sección anterior. Para usar Gemini, ingresa 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 usar 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 nuevamente e inicia un chat nuevo. En una sesión ya abierta, /model solo puede cambiar entre proveedores que ya se han guardado; no puede agregar esta configuración.

Verificar con una tarea real

hermes doctor

La verificación de instalación pasa

Envía un mensaje corto

Ve una respuesta de Hermes

Abre los registros de solicitudes

Verifica el nombre del modelo

La configuración es utilizable solo después de que se completen los tres pasos.

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

Ver que el asistente de configuración se guardó con éxito, o que la API devolvió una respuesta exitosa, no es suficiente para mostrar que Hermes puede completar tareas por ti. El nombre del modelo en el registro de solicitudes debe coincidir con el valor que ingresaste.

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 funciona solo en la computadora actual.

Errores comunes

Ingresar hermes informa que el comando no se puede encontrar: Cierra la terminal y abre una ventana nueva. Si el comando aún no se encuentra, 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 inicio agregado 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 nuevamente. Las partes ya descargadas se reutilizarán.
Hermes no responde o informa que no puede conectarse: Confirma que OmniProxy se esté ejecutando y verifica que Base URL termine con /v1. Si Hermes se ejecuta en Docker mientras OmniProxy se ejecuta en el host, no uses 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 ingreses 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 nueva de Hermes.
El programa está en una unidad externa y hermes doctor informa un error de almacenamiento después de desconectar la unidad: Vuelve a conectar la unidad primero. No permitas que Hermes cree una configuración separada 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 usando 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 ingresar los valores, usa 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 completa del Agente. Revisa la fuente y el modelo en el registro de llamadas de OmniProxy.

Fuentes oficiales · Hermes ↗