Hermes Agent Home Assistant Add-on

What Hermes Agent Home Assistant Add-on does

Hermes Agent Home Assistant Add-on packages Hermes Agent as a Home Assistant add-on, which the README also calls an app. After the repository is added in Home Assistant, the agent is installed from the store and opened from the sidebar, where a setup wizard runs for model and API key configuration. Features listed include SQLite FTS5 long-term memory that survives restarts, self-improving skills, the messaging gateway for Telegram, Discord, WhatsApp and more, and a plugin architecture for custom tools, commands and hooks.

Optional extras are switched on in the add-on configuration: a browser-based dashboard for config, API keys, sessions, analytics, logs, cron and skills; a persistent tmux-backed web terminal through ttyd; an OpenAI-compatible API under /v1/ for frontends such as Open WebUI or SillyTavern; and a remote backend for the official Hermes Desktop app. Source code, the virtual environment and agent data persist across add-on updates. Other options include the git URL and ref for the Hermes source, auto-update on restart, a Home Assistant URL and token, and single-profile or multi-profile mode.

Key features

• Persistent SQLite FTS5 memory that survives restarts
• Messaging gateway for Telegram, Discord, WhatsApp and more
• Opt-in web dashboard and tmux-backed web terminal
• OpenAI-compatible API under /v1/ for chat frontends, protected by an access password
• Opt-in remote backend for the official Hermes Desktop app
• Single-profile or multi-profile mode, with data kept across updates

When to use it

• Running an always-on Hermes agent on a Home Assistant machine
• Connecting Open WebUI or SillyTavern to Hermes through the OpenAI-compatible endpoint
• Opening a Hermes terminal from the Home Assistant sidebar

Who it is for: Home Assistant users who want to host Hermes Agent on the same machine and manage it from the Home Assistant interface.

How it fits with Hermes Agent

Built specifically to run Hermes Agent as a Home Assistant add-on, cloning NousResearch/hermes-agent by default.

Requirements: A Home Assistant installation that supports add-ons (apps) and a model API key entered in the setup wizard

FAQ