Skip to main content

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:

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:

dotenv
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, and model.base_url; start a new session after configuration changes.
  • 401: key_env must 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.