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
- Abre https://ai2save.com/keys.
- Crea una clave y selecciona el grupo que contiene el modelo objetivo.
- Copia la Key completa
sk-.... - 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/completionsbasá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
- Salir completamente de la sesión actual de Hermes o Gateway.
- Reiniciar Hermes.
- Crear una nueva sesión y enviar una pregunta corta.
- En la sesión, ingresar
/modelpara confirmar que el modelo actual escustom/gpt-5.5ogpt-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_KEYno existe o su valor está incompleto. Ejecutehermes config get model.key_envpara verificar la referencia. - 404 / model not found:
model.defaultno es un ID de modelo real abierto en la consola. - Conexión fallida:
base_urldebería serhttps://ai2save.com/v1; no escribahttps://ai2save.com. - Configuración no aplicada: El antiguo
OPENAI_BASE_URLsolo afecta aopenai-apiProvider, y no se aplica automáticamente acustom; reviseconfig.yamlenmodel.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.