Hermes

Hermes es un agente de código abierto de Nous Research. Su asistente integrado hermes model puede añadir HiAPI como endpoint personalizado, así que no necesitas una herramienta de gestión de terceros. Los pasos siguientes usan claude-opus-5-5 como ejemplo; este tutorial se verificó en Windows con Hermes 0.22.5.

1. Instala Hermes

1.1 Requisitos

1.2 Windows (PowerShell)

Salta el asistente de configuración y configura el modelo solo después de instalar:

& ([scriptblock]::Create((irm https://hermes-agent.nousresearch.com/install.ps1))) -SkipSetup

Instalación estándar (abre el asistente de configuración):

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

1.3 macOS / Linux

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

1.4 Comprueba la instalación

Vuelve a abrir la terminal y ejecuta:

hermes --version

Basta con ver el número de versión; continúa cuando haya salida.

1.5 Otras formas de instalación

El script de instalación y los requisitos de versión siguen la documentación oficial de instalación de Hermes.

2. Configura el endpoint de HiAPI

Hermes tiene dos comandos relacionados con modelos con propósitos distintos; no los confundas:

Para añadir HiAPI, usa hermes model, así que sal primero de la sesión (Ctrl+C o /quit).

2.1 Ejecuta el asistente de configuración

hermes model

Elige Custom endpoint (self-hosted / VLLM / etc.) (algunas versiones muestran Custom endpoint (enter URL manually)).

2.2 Rellena cada pregunta

Para los modelos Claude, elige Anthropic Messages como API compatibility mode. Con claude-opus-5-5 como ejemplo:

En el modo Anthropic Messages, configura la API base URL como la dirección raíz https://api.hiapi.ai sin /v1; Hermes añade /v1/messages por su cuenta. La HiAPI API key se oculta o se muestra como asteriscos mientras la escribes; pégala y pulsa Enter.

2.3 Conecta GPT, DeepSeek y otros modelos

Para GPT, DeepSeek y otros modelos, rellena el resto de elementos como en la tabla de arriba, cambia solo los dos de abajo y sustituye Model name por el nombre del modelo correspondiente. Ten en cuenta que aquí la dirección incluye /v1.

Las combinaciones probadas para este tutorial son: Anthropic Messages para Claude, Chat Completions para GPT y DeepSeek. Si un modelo no admite el protocolo elegido, obtienes un 400.

2.4 Cambia a otro modelo

Para cambiar de modelo con el mismo endpoint, escribe esto directamente en una sesión:

/model custom:<model-id>

O vuelve a ejecutar hermes model para cambiar el modelo predeterminado. Al cambiar a otro modelo, busca su nombre en la lista de modelos de texto y confirma que su contexto es de al menos 64K. Hay más opciones para endpoints personalizados en la documentación de endpoints personalizados de Hermes.

3. Configuración manual (opcional)

La configuración manual de abajo sirve para GPT, DeepSeek y otros modelos que usen Chat Completions; para Claude, usa el asistente hermes model de arriba. Si no puedes usar el asistente, edita directamente ~/.hermes/config.yaml (base_url debe incluir /v1):

model:
  default: <model-id>
  provider: custom
  base_url: https://api.hiapi.ai/v1
  api_key: YOUR_HIAPI_API_KEY

También puedes usar una variable de entorno en lugar de la clave en texto plano; key_env es la forma en que Hermes lee una variable de entorno, así que déjalo como está:

model:
  default: <model-id>
  provider: custom
  base_url: https://api.hiapi.ai/v1
  key_env: HIAPI_API_KEY

Luego escribe esto en ~/.hermes/.env:

HIAPI_API_KEY=YOUR_HIAPI_API_KEY

Sustituye YOUR_HIAPI_API_KEY por tu HiAPI API key. Después de cambiar la configuración, inicia una sesión nueva con /new o reinicia Hermes antes de probar.

4. Verificar

4.1 Chat

Abre Hermes, confirma que usa el proveedor de HiAPI y envía “Hola, preséntate en una frase.” Una respuesta normal significa que la conexión funciona.

4.2 Llamadas a herramientas

Primero crea tool-call-test.txt en la carpeta desde la que inicias Hermes, escribe una línea hello hiapi y guárdalo. Luego envía “Llama a una herramienta una sola vez. Lee todo el contenido de tool-call-test.txt y devuélvelo exactamente tal cual. No adivines el contenido a partir del nombre del archivo.” Confirma que aparece una llamada a herramienta que devuelve hello hiapi.

5. Solución de problemas

Aquí solo se recogen los problemas propios de Hermes. Para errores comunes como 401, 404 y 429, consulta Errores comunes.

Esta página solo cubre los modelos de texto; para las capacidades de herramientas consulta la guía de MCP.