v1.0.0 — First Stable Release

Hermes Agent by Nous Research, packaged as a Home Assistant add-on/app.

Highlights

• Persistent AI agent with SQLite FTS5 long-term memory, self-improving skills, and multi-platform messaging
• OpenAI-compatible API (/v1/) — connect Open WebUI, SillyTavern, or any chat frontend
• Persistent web terminals — tmux-backed Hermes + Terminal tabs via the HA sidebar
• HTTP + HTTPS — direct LAN access with auto-generated TLS certificates and optional Basic Auth
• Full persistence — source code, venv, Homebrew, npm, Go, and all agent data survive add-on updates
• Self-modifiable source — editable install lets the agent read and modify its own code
• Plugin architecture — custom tools, commands, and hooks without forking

Container Toolchain

Go 1.26, Node.js 22, Python 3.11, Chromium, GitHub CLI, Homebrew, uv, and 30+ dev tools pre-installed.

Supported Architectures

• amd64
• aarch64

Installation

1. Add this repository to Home Assistant: Settings > Apps > Install app > ⋮ > Repositories
2. Paste https://github.com/WolframRavenwolf/hermes-ha-addon and click Add
3. Find Hermes Agent in the store and click Install
4. Start the add-on and open Hermes Agent from the sidebar

See the README for full documentation.