Connect Hermes Agent
Configure Hermes' custom endpoint for a model publishing Chat Completions support. Choose its exact ID in Hermes Setup.
Install and configure
Install Hermes using its official project instructions.
Run hermes model outside an active chat and select Custom endpoint to enter
the base URL, key, and model. For a manual configuration, merge this into
~/.hermes/config.yaml:
model:
provider: custom
default: YOUR_LIVE_CHAT_MODEL
base_url: https://gateway.primexos.com/v1
key_env: PRIMEX_API_KEY
Place the key in the private ~/.hermes/.env file:
PRIMEX_API_KEY=YOUR_API_KEY
Preserve your existing config and protect .env from source control or sharing.
For custom endpoints, set model.base_url in the config. OPENAI_BASE_URL is
specific to Hermes' openai-api provider; the legacy LLM_MODEL environment
setting has been removed. The in-chat /model command switches previously
configured providers; use hermes model to add one.
Official references: AI providers and configuration.
Verify and inspect auxiliary models
Start a new hermes chat session and send a short text prompt. Expect an answer
and a matching request in Usage.
Then use a disposable project to verify a harmless read-only tool action and a
completed tool-result turn before relying on agent tasks.
Review Hermes' auxiliary/compression/vision settings and tool credentials separately. The primary model selection does not establish that every auxiliary call uses Primex or that every provider-run tool is available. Sessions, memory, logs and files retained by Hermes follow Hermes' configuration; Primex's privacy policy does not describe all local client storage.
Common fixes and removal
- Wrong provider or model: check
model.provider,model.default, andmodel.base_url; start a new session after configuration changes. - 401:
key_envmust name a populated key in the active Hermes profile's.env. - Tool/auxiliary failure: verify that model and operation independently; do not assume the primary text request qualifies vision, agents, or compression.
- 402/429/timeout: inspect Errors & limits and Usage before retrying.
Choose another provider with hermes model, remove unused Primex key/config
entries from the profile, and revoke the key if it should no longer authorize requests.
Need help connecting? Report a setup issue.