abundantbeing/hermes-browser-extension

Hermes Browser Extension – Quick Overview

What it is – A browser side‑panel (Chrome/Edge/Chromium, with limited support in Firefox) that lets you talk to a Hermes Agent – an open‑source LLM‑powered AI assistant from Nous Research. The extension does not contain its own model; it connects to a Hermes runtime that you run locally, on a remote server, or via the Hermes Cloud dashboard.

Key capabilities

• Bot Mode – Switch between multiple Hermes agents, edit their profiles, and run group chats where several agents reply in the same room. (Page‑context is only available for single‑bot chats.)
• Context capture – Attach files, take a screenshot of the current tab, or select which tabs the agent should read from. The extension never captures pages automatically.
• Live sessions – Re‑open an ongoing chat, see tool calls (e.g., function calls, web‑search) in a collapsible list, and control the session (steer, queue, stop).
• Hermes Assist – Drafts text next to supported text fields; you must manually send it.
• Customization – Light/Dark/System themes, 12 built‑in colour schemes, text zoom, font list, and a background illustration that adapts to the panel width.

How it connects

Mode	Where it points	What you can do
Local gateway	http://127.0.0.1:8642 (Hermes API server on the same machine)	Full feature set – tools, skills, memory, multi‑agent control.
Hermes Cloud	A signed‑in Hermes Cloud tab provides a short‑lived WebSocket ticket	Chat‑only; no page text, screenshots, or file attachments.
Remote gateway	Self‑hosted Hermes API on another machine (requires token & CORS allow‑list)	Same as local, but over the network.

Security stance – The extension is deliberately conservative:

• No automatic page control; actions like clicking or scrolling require explicit user interaction.
• Tokens/keys are stored only in the extension’s local storage; remote connections use short‑lived tickets.
• Permissions are limited to side‑panel UI, content scripts for reading page text, and downloads for user‑initiated saves.
• Sensitive pages (banking, health, passwords, etc.) are blocked from being sent.

Installation steps

1. Build the source (npm install && npm run build). The compiled extension appears in dist/.
2. Load unpacked in Chrome/Edge (chrome://extensions → Developer mode → Load unpacked → select dist/).
3. For Firefox, install the signed add‑on from AMO; the side‑panel works but tab‑control features are unavailable.

Typical workflow

1. Ensure a Hermes Agent is running and its API server is enabled.
2. Open the side‑panel, choose a connection mode, and test the link.
3. In any web page, click the panel’s Attach → Screenshot or File button, then ask the agent, e.g., “Summarize this page in one sentence.”
4. Review the assistant’s reply, inspect any tool calls, and optionally edit or copy the response.

Who it’s for – Developers or power users who already use Hermes Agent and want a tight, browser‑embedded UI for chatting, sending page context, and managing multiple agents without leaving the browser.

License – MIT.

---

All details are taken directly from the repository’s README; no additional features are inferred.