> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes

> Conecta Hermes al endpoint de la API de LLM compatible con OpenAI de Novita.

Hermes es una herramienta de agente de Nous Research. Puede conectarse a un endpoint personalizado compatible con OpenAI, por lo que puedes usar modelos LLM de Novita dentro de Hermes para flujos de trabajo de agentes locales.

## Requisitos previos

Antes de comenzar, prepara los siguientes valores:

* **Clave de API**: Crea o copia una clave de API desde [Key Management](https://novita.ai/settings/key-management).
* **URL base**: `https://api.novita.ai/openai/v1`
* **ID del modelo**: Copia el ID del modelo que quieres usar desde Model Hub, como `deepseek/deepseek-v3.1`.

<Tip>
  Hermes almacena localmente la configuración del endpoint y de la clave de API. No confirmes en el repositorio ninguna configuración generada que contenga tu clave de API.
</Tip>

## Instalar Hermes

Hermes ofrece opciones de instalación para terminal y escritorio. Elige la que se ajuste a tu flujo de trabajo.

### Linux / macOS / WSL2

```bash theme={"system"}
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
```

### Windows PowerShell

```bash theme={"system"}
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
```

### Escritorio

También puedes descargar Hermes Desktop desde:

```text theme={"system"}
https://hermes-agent.nousresearch.com/desktop
```

## Configurar el endpoint de Novita

Después de la instalación, ejecuta el flujo de configuración de Hermes. El comando exacto puede variar según la versión de Hermes, así que sigue las indicaciones de la terminal de la versión que instalaste.

Durante la configuración, usa las siguientes opciones y valores:

1. Selecciona **Custom endpoint** o la opción que te permita introducir manualmente una URL de proveedor.
2. Establece la URL base en `https://api.novita.ai/openai/v1`.
3. Introduce tu clave de API de Novita.
4. Para el tipo de API, conserva la opción predeterminada de detección automática. Si necesitas elegir manualmente, selecciona el modo compatible con OpenAI o Chat Completions.
5. Selecciona un modelo de la lista, o introduce manualmente un ID de modelo de Novita, como `deepseek/deepseek-v3.1`.
6. Configura los tokens máximos según la longitud de contexto del modelo. Si no tienes seguridad, conserva el valor predeterminado o detectado automáticamente.
7. Asigna a la configuración del modelo un nombre reconocible, como `novita-deepseek-v3.1`.
8. Si solo quieres ejecutar Hermes localmente, elige el runtime predeterminado Local.
9. Si no necesitas canales como Telegram, Slack o Matrix, omite los canales de integración.

## Recargar tu shell

Si Hermes te pide que recargues tu shell, ejecuta:

```bash theme={"system"}
source ~/.zshrc
```

## Iniciar Hermes

Inicia Hermes desde tu terminal:

```bash theme={"system"}
hermes
```

Envía un mensaje de prueba, por ejemplo:

```text theme={"system"}
Hello, briefly describe what coding tasks you can help with.
```

Si la solicitud falla, comprueba que:

* Tu clave de API sea correcta.
* La URL base sea `https://api.novita.ai/openai/v1`.
* El ID del modelo coincida con el que se muestra en Model Hub de Novita.
* El tipo de API seleccionado sea compatible con un endpoint compatible con OpenAI.