Hermes Agent

​

Descripción general

​

Requisitos previos

​

1. Requisitos de sistema y modelo

• Entorno de terminal: Hermes Agent se ejecuta en la línea de comandos de macOS, Linux y Windows (nativo o WSL2).
• Requisitos de contexto del modelo: Hermes Agent recomienda usar modelos con una longitud de contexto de al menos 64K (64.000) tokens. Dado que el prompt del sistema y las definiciones de herramientas ya consumen bastante contexto, una ventana demasiado pequeña puede llenarse y no dejar espacio para la conversación, provocando que el inicio sea rechazado. Si encuentras errores relacionados con el contexto, basta con cambiar a un modelo con mayor contexto (las series Claude / Gemini de EvoLink cumplen este requisito).

​

2. Obtener la clave API de EvoLink

• Inicia sesión en el Panel de EvoLink
• Busca API Keys en el panel, haz clic en el botón “Crear nueva Key” y luego copia la clave generada
• La clave API generalmente comienza con sk-, guárdala de forma segura

​

Paso 1: Instalar Hermes Agent

• macOS / Linux
• Windows

Ejecuta el script de instalación rápida en la terminal:

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

Una vez completada la instalación, recarga la configuración de la terminal para que el comando surta efecto:

source ~/.zshrc   # o source ~/.bashrc

Primera ejecución: elegir el método de instalación (Quick o Full)Al ejecutar hermes por primera vez se inicia un asistente de instalación interactivo, que primero te pregunta de qué manera deseas configurar Hermes:

• Quick Setup (Nous Portal) —— Inicia sesión mediante el OAuth gratuito de Nous, sin necesidad de clave API, configura automáticamente modelos y herramientas, y es la forma más rápida de empezar. Sin embargo, por defecto usa los modelos de Nous Portal, no EvoLink; para integrar EvoLink necesitas ejecutar hermes model por separado tras completar la instalación (consulta el Paso 2).
• Full setup —— Tú mismo configuras paso a paso los proveedores, las herramientas y las opciones (usando tu propia Key). Esta es la opción recomendada para usuarios que quieran integrar EvoLink directamente, ya que durante la instalación puedes introducir de una sola vez la dirección de la interfaz y la Key de EvoLink.

A continuación se muestran los pasos clave para integrar EvoLink eligiendo Full setup:

1

Elegir Full setup

Con las teclas de dirección selecciona Full setup — configure every provider, tool & option yourself（bring your own keys） y pulsa Enter para confirmar.

2

Elegir proveedor: Custom endpoint

En la lista de proveedores, desplázate hacia abajo y selecciona custom endpoint（enter URL manually）. Dado que EvoLink ofrece una interfaz compatible con OpenAI, aquí se accede mediante el «endpoint personalizado».

3

Introducir la dirección de la interfaz y la API Key de EvoLink

El asistente te pedirá sucesivamente la información del endpoint:

• API base URL introduce: https://direct.evolink.ai/v1
• API key introduce tu clave API de EvoLink (que comienza con sk-)

Tras introducirla, el asistente validará automáticamente el endpoint. Si ves un mensaje similar a Verified endpoint via https://direct.evolink.ai/v1/models (154 model(s) visible), significa que la interfaz está conectada y la Key es válida. Después, sigue las indicaciones para continuar seleccionando el modelo y las herramientas predeterminados.

Resultado esperado: Una vez completado el asistente se mostrará la página Installation Complete (instalación completada), que enumera la ubicación de los archivos de configuración y los comandos habituales.

Los entornos WSL2 y Android (Termux) también se instalan con el mismo script install.sh anterior.

Ejecuta el comando de instalación rápida en PowerShell:

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

Resultado esperado: Verás información de descarga e instalación y, al final, un mensaje de instalación correcta.Si ocurre un error: Si se indica una restricción de la política de ejecución, abre PowerShell como administrador, o ejecuta primero Set-ExecutionPolicy -Scope CurrentUser RemoteSigned y vuelve a intentarlo.Tras la instalación, al ejecutar hermes por primera vez también se iniciará el asistente de instalación Quick / Full; los pasos para integrar EvoLink son idénticos a los de la pestaña macOS / Linux (se recomienda elegir Full setup e introducir en el asistente la dirección de la interfaz y la Key de EvoLink).

Los usuarios de macOS y Windows también pueden descargar el paquete de instalación de escritorio Hermes Desktop desde el sitio oficial de Hermes e instalarlo con doble clic.

​

Verificar la instalación

hermes doctor

​

Paso 2: Configurar EvoLink API (usuarios de Quick o reconfiguración)

• ~/.hermes/.env —— almacena claves secretas como la API Key
• ~/.hermes/config.yaml —— almacena configuraciones no secretas como modelos, proveedores, etc.

• Asistente de configuración (recomendado)
• Configuración por línea de comandos
• Editar archivos de configuración manualmente

Hermes ofrece un asistente de configuración interactivo, adecuado para usuarios nuevos (especialmente quienes eligieron Quick Setup). Ejecuta en la terminal:

hermes model

1

Elegir proveedor: Custom endpoint

En la lista de proveedores, desplázate hacia abajo y selecciona custom endpoint（enter URL manually）, para integrar el endpoint compatible con OpenAI de EvoLink.

2

Introducir la dirección de la interfaz, la Key y elegir el modo de compatibilidad

Introduce sucesivamente la información del endpoint y, una vez superada la validación, selecciona el modo de compatibilidad de la API:

• API base URL introduce: https://direct.evolink.ai/v1
• API key introduce tu clave API de EvoLink (que comienza con sk-)
• API compatibility mode selecciona Chat Completions（standard OpenAI-compatible endpoints）

Ver un mensaje similar a Verified endpoint via https://direct.evolink.ai/v1/models (163 model(s) visible) indica que la interfaz está conectada y la Key es válida.

3

Elegir el modelo predeterminado

Por último, introduce el nombre del modelo que quieras usar como predeterminado (por ejemplo, claude-sonnet-4-6, claude-opus-4-8, etc.) y pulsa Enter para confirmar.

El asistente escribirá automáticamente la API Key en ~/.hermes/.env y la configuración de modelo y endpoint en ~/.hermes/config.yaml, sin necesidad de editar archivos manualmente.

hermes model es el paso más importante para que los usuarios de Quick integren EvoLink. Una vez completado, puedes pasar directamente al siguiente paso para comenzar a usarlo.

Si ya tienes tu clave API de EvoLink, puedes escribir la configuración directamente por línea de comandos.

​

1. Configurar la API Key (escribir en .env)

hermes config set OPENAI_API_KEY tu_API_Key_de_EvoLink

​

2. Configurar la dirección de la interfaz y el modelo (escribir en config.yaml)

hermes config set OPENAI_BASE_URL https://direct.evolink.ai/v1
hermes config set model claude-sonnet-4-6

hermes config set escribe automáticamente las claves secretas como la API Key en .env y el resto de la configuración en config.yaml, así que no tienes que preocuparte por en qué archivo se guarda.

Una vez completado, puedes ejecutar hermes config para verificar si la configuración actual es correcta.

Usuarios avanzados: Los métodos siguientes editan directamente los archivos de configuración. Para la mayoría de los usuarios se recomienda usar el “asistente de configuración” anterior.

​

1. Editar ~/.hermes/.env

Abre (o crea) ~/.hermes/.env e introduce la API Key y la dirección de la interfaz:

OPENAI_API_KEY=tu_API_Key_de_EvoLink
OPENAI_BASE_URL=https://direct.evolink.ai/v1

​

2. Editar ~/.hermes/config.yaml

Abre (o crea) ~/.hermes/config.yaml y configura el modelo principal como endpoint personalizado:

model:
  provider: custom
  default: claude-sonnet-4-6
  base_url: https://direct.evolink.ai/v1
  api_mode: chat_completions

⚠️ Importante:

• Reemplaza tu_API_Key_de_EvoLink con tu clave API real
• base_url debe ser https://direct.evolink.ai/v1 (la dirección de la interfaz compatible con OpenAI de EvoLink)
• No introduzcas signos de puntuación con un teclado de chino (como los dos puntos chinos ：)

Descripción de los campos de configuración:

• provider: custom: usa un endpoint personalizado compatible con OpenAI (es decir, EvoLink)
• base_url: dirección de la interfaz de la API de EvoLink
• api_mode: chat_completions: usa la interfaz estándar Chat Completions
• default: nombre del modelo usado por defecto

​

Paso 3: Comenzar a usar y verificar

​

1. Iniciar Hermes Agent

hermes          # modo clásico de línea de comandos

hermes --tui    # interfaz de terminal moderna

​

2. Verificar la configuración

¿quién eres?

• Ves el contenido de la respuesta de la IA (unas pocas líneas de texto)
• No aparecen errores como 401, 403, API key inválida o context length (longitud de contexto)

• 401 Unauthorized: la API Key no está configurada o no es válida → revisa OPENAI_API_KEY en ~/.hermes/.env
• 403 Forbidden: la API Key tiene permisos insuficientes o ha expirado → revisa la API Key
• errores relacionados con context length: el modelo seleccionado tiene menos de 64K de contexto → cambia a un modelo que cumpla el requisito
• No API key / provider not found: no se encontró la Key → vuelve a ejecutar hermes config set OPENAI_API_KEY ...

​

3. Restaurar sesiones anteriores

hermes --continue    # restaurar la sesión más reciente
hermes -c            # forma abreviada

​

Configuración avanzada (opcional)

​

Modelos de reserva (Fallback)

fallback_providers:
  - provider: custom
    model: claude-sonnet-4-6
    base_url: https://direct.evolink.ai/v1
  - provider: custom
    model: claude-haiku-4-5-20251001
    base_url: https://direct.evolink.ai/v1

​

Modelos auxiliares (Auxiliary)

auxiliary:
  title_generation:
    provider: custom
    model: claude-haiku-4-5-20251001
    base_url: https://direct.evolink.ai/v1
    api_key: tu_API_Key_de_EvoLink
  compression:
    provider: custom
    model: claude-haiku-4-5-20251001
    base_url: https://direct.evolink.ai/v1
    api_key: tu_API_Key_de_EvoLink

​

Preguntas frecuentes

​

1. ¿Qué es Hermes Agent? ¿Para qué se usa principalmente?

​

2. ¿Hermes Agent y los modelos Hermes 3 / Hermes 4 son lo mismo?

​

3. ¿Por qué hay que usar provider: custom para integrar EvoLink?

​

4. ¿Qué hago si al iniciar se indica que la longitud de contexto (context length) es insuficiente?

​

5. ¿Cuáles suelen ser las causas de los errores 401 / 403?

• Error 401: OPENAI_API_KEY no está configurada o la API Key no es válida
• Error 403: la API Key tiene permisos insuficientes o ha expirado
• Revisa la Key en ~/.hermes/.env, y si base_url es https://direct.evolink.ai/v1

​

6. ¿Por qué no surten efecto mis cambios después de modificar la configuración?

• Confirma que la configuración se escribió en el archivo correcto: la API Key en ~/.hermes/.env, el modelo/endpoint en ~/.hermes/config.yaml
• Puedes ejecutar hermes config para ver la configuración que está realmente en vigor
• Revisa si la indentación y la sintaxis de config.yaml son correctas (YAML es sensible a la indentación)
• Reinicia Hermes

​

7. ¿Cómo cambio de modelo?

• Interactivo: ejecuta hermes model para volver a seleccionar
• Línea de comandos: ejecuta hermes config set model nombre_del_modelo
• Edita directamente el valor de model.default en ~/.hermes/config.yaml

​

8. ¿Qué modelos comunes admite EvoLink?

​

9. ¿Cómo consulto el uso?

​

10. ¿Dónde están el archivo de configuración y el archivo de claves respectivamente?

• Claves (API Key): ~/.hermes/.env
• Configuración de modelos y proveedores: ~/.hermes/config.yaml
• Puedes ejecutar hermes config edit para abrir directamente el archivo de configuración y editarlo.

​

11. ¿Cómo abrir la terminal de línea de comandos?

​

Notas