ai2saveai2save

Guía de configuración Hermes Agent

El modelo Hermes Agent, el proveedor y el endpoint personalizado se guardan en ~/.hermes/config.yaml; la información sensible como API Key se guarda en ~/.hermes/.env. ai2save utiliza la interfaz OpenAI Compatible, Base URL es https://ai2save.com/v1.

1. Crear API Key

  1. Abre https://ai2save.com/keys.
  2. Crea una clave y selecciona el grupo que contiene el modelo objetivo.
  3. Copia la Key completa sk-....
  4. Anota el ID de modelo real que aparece en la consola, por ejemplo, gpt-5.5.

2. Se recomienda usar el asistente incorporado

Ejecuta en la terminal:

hermes model

Seleccione según las indicaciones:

Custom endpoint (self-hosted / vLLM / etc.)

Ingrese en orden:

API base URL: https://ai2save.com/v1
API key: sk-tu-api-key
Model name: gpt-5.5

El guía escribirá estos valores en ~/.hermes/config.yaml. No escriba Base URL en .env; según el acuerdo oficial de Hermes, la configuración del endpoint del modelo proviene de config.yaml.

3. Edición manual del archivo de configuración

Edite ~/.hermes/config.yaml:

model:
  provider: custom
  default: gpt-5.5
  base_url: https://ai2save.com/v1
  key_env: AI2SAVE_API_KEY

Descripción de los campos:

  • provider: custom: usa cualquier endpoint OpenAI Compatible.
  • default: ID de modelo predeterminado, debe coincidir exactamente con el ID de modelo abierto en la consola.
  • base_url: debe acompañarse de /v1, Hermes hará solicitudes de /chat/completions basándose en esto.
  • key_env: apunta al nombre de la variable de entorno que guarda la clave.

Editar ~/.hermes/.env:

AI2SAVE_API_KEY=sk-tu-api-key

.env guarda información sensible, config.yaml guarda configuración de modelo no sensible. No envíes .env a Git.

4. Usar comandos de configuración para escribir

También puedes usar los comandos incorporados de Hermes para evitar errores de sangría de YAML:

hermes config set model.provider custom
hermes config set model.default gpt-5.5
hermes config set model.base_url https://ai2save.com/v1
hermes config set model.key_env AI2SAVE_API_KEY
hermes config set AI2SAVE_API_KEY sk-tu-api-key
hermes config check

AI2SAVE_API_KEY es el nombre de la variable de entorno en mayúsculas, Hermes escribirá automáticamente ~/.hermes/.env.

5. Reiniciar y verificar

  1. Salir completamente de la sesión actual de Hermes o Gateway.
  2. Reiniciar Hermes.
  3. Crear una nueva sesión y enviar una pregunta corta.
  4. En la sesión, ingresar /model para confirmar que el modelo actual es custom/gpt-5.5 o gpt-5.5.

Uso temporal del modelo especificado:

hermes chat --provider custom --model gpt-5.5

Se recomienda cerrar las tareas paralelas y las herramientas complejas durante la primera verificación, y solo enviar textos cortos. Después de la autenticación y la conexión del modelo, se pueden habilitar gradualmente herramientas como terminal, web, archivo, etc.

6. Errores comunes

  • 401 / invalid_api_key: AI2SAVE_API_KEY no existe o su valor está incompleto. Ejecute hermes config get model.key_env para verificar la referencia.
  • 404 / model not found: model.default no es un ID de modelo real abierto en la consola.
  • Conexión fallida: base_url debería ser https://ai2save.com/v1; no escriba https://ai2save.com.
  • Configuración no aplicada: El antiguo OPENAI_BASE_URL solo afecta a openai-api Provider, y no se aplica automáticamente a custom; revise config.yaml en model.base_url.
  • Fallo en la resolución de YAML: No debe haber bloques duplicados de model:, consolide todos los campos en un mismo bloque.
  • Excepción al invocar herramientas: Primero confirme que el modelo soporta tool calling y use solicitudes de texto corto para establecer una línea base antes de habilitar el conjunto de herramientas.