# Conecta Hermes Agent con MandAPI

Añade MandAPI a Hermes como endpoint personalizado de Chat Completions.

## Configura el proveedor personalizado

Utiliza una instalación actual de Hermes Agent y un modelo de MandAPI visible para tu cuenta que admita Chat Completions. Para programar, confirma también sus llamadas a herramientas.

Fuera de un chat activo, ejecuta `hermes model` y elige la opción de endpoint personalizado. Introduce la base de MandAPI, tu clave privada y el identificador exacto del modelo. Este asistente añade proveedores; el comando `/model` del chat cambia entre configuraciones ya creadas.

## Conserva una configuración reproducible

Para configurarlo a mano, combina lo siguiente en `~/.hermes/config.yaml` y sustituye `MODEL_ID`:

```yaml
model:
  provider: custom
  base_url: https://api.mandapi.com/v1
  default: MODEL_ID
  key_env: MANDAPI_API_KEY
```

Proporciona `MANDAPI_API_KEY` mediante el entorno que recibe Hermes. Para una terminal de Bash:

```bash
read -rsp "Clave de MandAPI: " MANDAPI_API_KEY
printf '\n'
export MANDAPI_API_KEY
```

O en PowerShell:

```powershell
$env:MANDAPI_API_KEY = [Net.NetworkCredential]::new('', (Read-Host 'Clave de MandAPI' -AsSecureString)).Password
```

Inicia Hermes desde esa misma terminal. Con el proveedor personalizado, el endpoint va en `model.base_url`; no dependas de la antigua variable `LLM_MODEL` ni de una variable de URL de otro proveedor.

## Comprueba texto y después herramientas

Inicia `hermes`, pide una explicación breve de un fragmento de código y revisa el consumo correspondiente en MandAPI. Después abre un proyecto pequeño y pide un resumen del README sin cambiar archivos. Así podrás distinguir un problema de conexión del modelo de uno de ejecución de herramientas.

## Resuelve el fallo y vuelve al modelo anterior

Si falta la clave, comprueba que el proceso recibió la variable indicada sin mostrar su valor. Si `/model` no permite añadir el endpoint, sal del chat y utiliza `hermes model`. Si falta el modelo, compara el ID exacto visible para tu cuenta, sin añadir prefijos de otros proveedores. Conserva una copia de los ajustes anteriores para recuperarlos.

## Referencias

- [https://hermes-agent.nousresearch.com/docs/integrations/providers](https://hermes-agent.nousresearch.com/docs/integrations/providers)
- [https://openrouter.ai/docs/cookbook/coding-agents/hermes-integration](https://openrouter.ai/docs/cookbook/coding-agents/hermes-integration)