How do I open Hermes Agent API Server?

The Hermes Agent API Server is used to expose Hermes as an OpenAI-compatible interface, making it easy to open WebUI or build your own front-end calls. The basic configuration given by the official Open WebUI documentation is to open the API Server and set a key.

Shortest opening method

Join at ~/.hermes/.env:

API_SERVER_ENABLED=true
API_SERVER_KEY=your-secret-key

Then launch:

hermes gateway

Normally, listening is http://127.0.0.1:8642, and the OpenAI-compatible path is usually /v1/chat/completions.

Attention newbies

The machine should not be directly exposed to the public network for personal use. For remote access, at a minimum, set up strong keys, reverse proxies, HTTPS, and access controls. CORS is also considered for browser direct connections, and CORS is generally not required for Open WebUI server-to-server connections.

In a word: API Server switches are API_SERVER_ENABLED, and access protection depends on API_SERVER_KEY.

Official open source address: https://github.com/NousResearch/hermes-agent; Official document entry: https://hermes-agent.nousresearch.com/.