Skip to main content
Hermes speaks Chat Completions. Private AI Proxy configures it automatically.

With Private AI Proxy

  1. Install Private AI Proxy, sign in, and turn on Protected.
  2. On the Agents screen, connect Hermes.
  3. Start a new Hermes session; existing sessions stay on their original provider.
The app writes the provider into ~/.hermes/config.yaml with an agent-scoped token for its local API, and restores the file when you disconnect or stop Protected. From the CLI, the same connection is:

Without the Proxy

Define and select a named provider. Hermes reads the key from its process environment or ~/.hermes/.env; do not put it in config.yaml.
~/.hermes/config.yaml
This changes the main text and tool-calling loop only; image, speech, embedding, search, and browser providers stay separate. This path does not verify ACI locally. For confidential-only routing, use an is_tee: true model with https://tee.redpill.ai/v1. See Verified ACI clients.

Check the connection

Start hermes, run /model, and confirm the active provider, then run one harmless tool task.

Troubleshooting

References