Hermes Agent
Use an OpenAI-compatible endpoint with user-level configuration.Before you connect
- Install and launch the tool.
- Create an API key and save the plaintext value shown once.
- Choose a model ID whose protocol and capability match the tool.
Minimal configuration
Store the key in ~/.hermes/.env and the provider/default model in ~/.hermes/config.yaml.
.env + YAML
.env + YAML
# ~/.hermes/.env
OPENAI_API_KEY=sk-your-api-key
# ~/.hermes/config.yaml
model:
provider: custom
base_url: https://api.noxgate.net/v1
api_key: ${OPENAI_API_KEY}
default: YOUR_MODEL_ID- When configuration already exists, keep its YAML hierarchy and replace the relevant values only.
Verify the connection
- Save both files and restart Hermes Agent.
- Send a minimal prompt with a known available model.
Limitations and common issues
- If YAML fields differ, follow the structure generated by the installed version.
- For 401 errors, confirm the process loaded ~/.hermes/.env.