Hermes Open WebUI Platform

What Hermes Open WebUI Platform does

The plugin lets one Hermes gateway run several bot accounts, each mapped to its own Open WebUI channels. Messages are received and sent in real time over Socket.IO, image attachments are downloaded and passed to the agent as native vision input, and a typing indicator shows while the agent works. It can edit and delete messages for streaming and progress cleanup, keeps a separate session per thread, and reconnects individual accounts after a WebSocket drop without restarting the gateway.

Configuration works in three ways: multi-account entries in config.yaml, multi-account environment variables, or a single-account environment fallback. The bot is a normal Open WebUI user with the User role, and the channel ID is copied from the channel's URL. The README recommends turning streaming off for Open WebUI and setting image_input_mode to native for local model servers such as LM Studio or Ollama. Multiple accounts under one gateway share Hermes memory, so separate gateways with their own HERMES_HOME are needed for real isolation.

Key features

• Multiple bot accounts from a single adapter instance
• Real-time messaging over Open WebUI's Socket.IO events
• Image attachments passed to the agent as native vision input
• Typing indicator, message edit and delete support
• Thread-aware sessions and automatic per-account reconnect
• Three configuration modes: config.yaml, multi-account env vars, single-account env vars

When to use it

• Chatting with a Hermes agent from channels in a self-hosted Open WebUI
• Running two persona bots, each tied to its own channel
• Sending images in Open WebUI to a vision-capable Hermes model

Who it is for: Hermes Agent users who already run Open WebUI and want their agent available there.

How it fits with Hermes Agent

A platform plugin for the Hermes Agent gateway. The author says that, as far as they know, it is the only Open WebUI platform plugin for Hermes.

How to install Hermes Open WebUI Platform

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

cp -r hermes-openwebui-platform ~/.hermes/hermes-agent/plugins/platforms/open-webui
hermes gateway restart

Requirements: Hermes Agent with the gateway enabled, a self-hosted Open WebUI instance, and aiohttp, which is already bundled in Hermes' venv

Note: Several accounts under one gateway share the same Hermes memory, so isolation between bots needs separate gateways.

FAQ