Hermes Agent

Ejecuta Hermes Agent mediante su opción de endpoint personalizado compatible con OpenAI.

Hermes Agent de Nous Research

Qué funciona

Hermes usa OneProvider mediante un proveedor personalizado en modo Chat Completions y un ID de modelo compatible que eliges del catálogo.

Limitación del cliente

Deja API mode en Chat Completions; los demás modos de proveedor de Hermes no usan esta conexión compatible con OpenAI.

Configuración

1. Abre la configuración de modelos de Hermes

   Ejecuta el asistente de modelos y elige Custom endpoint (self-hosted / VLLM / etc.).

   hermes model

2. Introduce la conexión de OneProvider

   Usa https://api.oneprovider.dev/v1, tu clave de OneProvider dedicada, un ID de modelo compatible que elijas del catálogo y Chat Completions como modo de API.

   Endpoint: https://api.oneprovider.dev/v1
   API key: sk-your-key-here
   Model: gpt-6.1-terra
   Mode: Chat Completions

3. O configura Hermes manualmente

   Guarda ONEPROVIDER_API_KEY=… en ~/.hermes/.env y luego define el bloque model en ~/.hermes/config.yaml.

   # ~/.hermes/.env
   ONEPROVIDER_API_KEY=sk-your-key-here
   # ~/.hermes/config.yaml
   model:
   default: gpt-6.1-terra
   provider: custom
   base_url: https://api.oneprovider.dev/v1
   key_env: ONEPROVIDER_API_KEY

Verifica la conexión

Empieza una sesión nueva de Hermes

Haz una pregunta corta y luego confirma en el Dashboard de OneProvider el ID del modelo configurado, el consumo de tokens y el importe cobrado.

Datos de conexión

Protocolo

openai-chat

Endpoint

https://api.oneprovider.dev/v1

Seguridad de la clave

Usa una clave de inferencia dedicada, limitada al modelo necesario, con controles de frecuencia, gasto y caducidad. Guarda la clave en ~/.hermes/.env y no en config.yaml.

Qué modelo elegir

Define default en el bloque model de config.yaml. gpt-6.1-terra es una buena opción diaria por defecto, gpt-6.1-sol es el nivel de gama alta para tareas difíciles y gpt-5.6-luna es barato para trabajo rápido o de gran volumen. Usa Chat Completions como modo de API y copia los ID de la página de modelos .

Errores frecuentes y soluciones

401

No se lee la clave: comprueba que ONEPROVIDER_API_KEY=… esté en ~/.hermes/.env y que key_env en config.yaml nombre la misma variable.

404

base_url debe ser https://api.oneprovider.dev/v1 con /v1.

“Model not found”

El ID no está en el catálogo o tiene un error de escritura. Cópialo de la página de modelos.

429 “Insufficient balance”

Se agotó el saldo o el límite de la clave. Recarga el saldo del panel.

El asistente no lista OneProvider

Elige Custom endpoint en hermes model: OneProvider se añade como un endpoint personalizado compatible con OpenAI.

Preguntas frecuentes

¿Dónde guardo la clave?

En ~/.hermes/.env, no en config.yaml.

¿Puedo usar modelos Claude?

Sí, introduce un ID de Claude como claude-sonnet-5-5 en el mismo endpoint personalizado; las capacidades dependen del modelo.

¿Cómo compruebo que funciona?

Empieza una sesión nueva, haz una pregunta corta y busca la solicitud en Consumo del Dashboard.

Respuestas rápidas

¿Qué base URL uso?

Claude Code y los SDK de Anthropic usan https://api.oneprovider.dev. Los SDK de OpenAI y los clientes compatibles con OpenAI usan https://api.oneprovider.dev/v1. Una misma clave funciona con ambas; la lista de modelos está en la página de modelos y las tarifas, en la página de precios .

¿Cómo me autentico?

Envía la clave sk-… tal cual en x-api-key o en Authorization: Bearer: en uno de los dos, nunca en ambos. Guarda la clave en una variable de entorno, no en un archivo que se suba al repositorio. Más sobre la autenticación .

¿Dónde obtengo una clave?

Abre tu panel en el bot de Telegram @oneprovider_robot o en app.oneprovider.dev, recarga el saldo y pulsa “Emitir una clave”. Cada clave puede tener su propio límite de gasto. Panel y claves de API .

¿Qué significan 401, 404 y 429?

401: falta la clave, está mal escrita o se envió en un encabezado equivocado; pega la clave completa, sin comillas ni espacios. 404: casi siempre es una base URL incorrecta, por ejemplo con /v1 ausente o duplicado. 429 con “Insufficient balance”: se agotó el saldo del panel o el límite de gasto de la clave, así que recarga en lugar de reintentar; cualquier otro 429 es un límite de frecuencia, así que espera según Retry-After. Detalles: códigos de error y solución de problemas .

¿Por qué se cortan o se reinician los streams?

Las VPN y los proxies VLESS suelen almacenar SSE en búfer o romper la negociación de HTTP/2. OneProvider no tiene restricciones regionales y no almacena los streams en búfer: desactiva el proxy y reintenta.

¿Dónde pregunto si esto no basta?

Escribe a @Oneproviderhelpbot en Telegram o abre “Soporte” en el panel web, con el código de estado HTTP y el mensaje de error exacto. Cómo funciona el soporte .