Hermes Agent connects to Open WebUI, essentially populating Hermes' API Server as an OpenAI-compatible interface into Open WebUI. For those who want to use a web chat interface, but know that Open WebUI and CLI sessions are usually separate.
Basic steps
- Turn on
API_SERVER_ENABLED=trueon~/.hermes/.env. - Set up
API_SERVER_KEY=your-secret-key. - Start
hermes gateway. - Add OpenAI-compatible connection to Open WebUI.
- Fill in the Base URL
http://host.docker.internal:8642/v1or your server address, and the Key in API_SERVER_KEY.
Common limitations
File uploads, cross-interface history, cron proactive messaging don't necessarily work the way a normal chat product does. Open WebUI is primarily a chat portal and is not a complete replacement for the Hermes CLI and gateway.
In a word: Open WebUI connects to Hermes, the key is API Server, /v1 address, and API_SERVER_KEY.
Official open source address: https://github.com/NousResearch/hermes-agent; Official document entry: https://hermes-agent.nousresearch.com/.
