diff --git a/hindsight-docs/docs-integrations/hermes-desktop.md b/hindsight-docs/docs-integrations/hermes-desktop.md new file mode 100644 index 000000000..687478266 --- /dev/null +++ b/hindsight-docs/docs-integrations/hermes-desktop.md @@ -0,0 +1,58 @@ +--- +sidebar_position: 39 +title: "Hermes Desktop App: Configure Hindsight Memory | Integration" +description: "Set up Hindsight as the memory provider for the Hermes desktop app — entirely in Settings. Pick a mode, paste an API key, and your agent has persistent long-term memory. No config files, no environment variables." +--- + +# Hermes Desktop + +Configure [Hindsight](https://vectorize.io/hindsight) as the memory provider for the **[Hermes](https://github.com/NousResearch/hermes-agent) desktop app** — entirely from Settings. No `config.json`, no `.env`, no terminal. Pick a mode, paste an API key, and Hermes remembers across every session. + +:::tip +Prefer the command line, or running Hermes as a CLI/gateway? See the [Hermes Agent integration](/sdks/integrations/hermes) for the `hermes memory setup` wizard, plugin architecture, and the full configuration reference. +::: + +## Setup + +**1. Open Settings → Memory & Context.** In the **Memory Provider** dropdown, choose **Hindsight**. + +![Selecting Hindsight as the memory provider in the Hermes desktop app's Settings → Memory & Context](/img/integrations/hermes-desktop-dropdown.png) + +**2. Fill in the Hindsight settings panel.** Selecting Hindsight reveals its configuration fields: + +![The Hindsight memory provider configuration panel in the Hermes desktop app](/img/integrations/hermes-desktop-config-panel.png) + +| Field | What it does | Default | +| ----------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------ | +| **Mode** | `Cloud` (just needs an API key) or `Local External` (connect to an existing Hindsight instance) | `Cloud` | +| **API key** | Authenticates with the Hindsight API — stored as a write-only secret | — | +| **API URL** | The Hindsight endpoint | `https://api.hindsight.vectorize.io` | +| **Bank ID** | Which memory bank this Hermes profile reads and writes | `hermes` | +| **Recall budget** | How hard recall works each turn: `low` / `mid` / `high` | `mid` | + +**3. Click Save.** That's it — Hermes now has persistent long-term memory. + +## Connection Modes + +### Cloud (recommended) + +The fast path. Choose **Cloud**, then paste an API key from [ui.hindsight.vectorize.io/connect](https://ui.hindsight.vectorize.io/connect). Nothing to host — Hindsight Cloud handles storage, extraction, and retrieval. + +### Local External + +Already running your own Hindsight instance (Docker or self-hosted)? Choose **Local External** and set the **API URL** to your instance (for example `http://localhost:8888`). Your memory never leaves your infrastructure. + +## How Memory Is Stored + +Your settings are saved to the right place automatically: + +- **API key** goes to the secret store — it's never read back into the form (you'll see an _API key set_ badge once it's saved). +- **Mode, API URL, Bank ID, and Recall budget** are written to your Hermes profile config. + +Each profile points at one **Bank ID**, so memory is isolated per profile and follows you across every machine that profile runs on. + +## Next Steps + +- **Hindsight Cloud (free):** [ui.hindsight.vectorize.io](https://ui.hindsight.vectorize.io) +- **Hermes CLI / plugin setup:** [Hermes Agent integration](/sdks/integrations/hermes) +- **Hermes Agent:** [github.com/NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent) diff --git a/hindsight-docs/docs-integrations/hermes.md b/hindsight-docs/docs-integrations/hermes.md index 135be02c3..fc9f62625 100644 --- a/hindsight-docs/docs-integrations/hermes.md +++ b/hindsight-docs/docs-integrations/hermes.md @@ -8,6 +8,10 @@ description: "Add long-term memory to Hermes Agent with Hindsight. Automatically Persistent long-term memory for [Hermes Agent](https://github.com/NousResearch/hermes-agent) using [Hindsight](https://vectorize.io/hindsight). Automatically recalls relevant context before every LLM call and retains conversations for future sessions — plus explicit retain/recall/reflect tools. +:::tip +Using the **Hermes desktop app**? You can select and configure Hindsight entirely in Settings — no terminal required. See [Hermes Desktop](/sdks/integrations/hermes-desktop). +::: + ## Quick Start **1. Get an API key** at [ui.hindsight.vectorize.io/connect](https://ui.hindsight.vectorize.io/connect). The API endpoint is `https://api.hindsight.vectorize.io`. diff --git a/hindsight-docs/src/data/integrations.json b/hindsight-docs/src/data/integrations.json index 43edd601b..ae614839f 100644 --- a/hindsight-docs/src/data/integrations.json +++ b/hindsight-docs/src/data/integrations.json @@ -90,6 +90,16 @@ "link": "/sdks/integrations/hermes", "icon": "/img/icons/hermes.png" }, + { + "id": "hermes-desktop", + "name": "Hermes Desktop", + "description": "Configure Hindsight as your memory provider directly in the Hermes desktop app — pick a mode, paste an API key, no config files.", + "type": "native", + "by": "hermes", + "category": "tool", + "link": "/sdks/integrations/hermes-desktop", + "icon": "/img/icons/hermes.png" + }, { "id": "local-mcp", "name": "MCP Server", diff --git a/hindsight-docs/static/img/integrations/hermes-desktop-config-panel.png b/hindsight-docs/static/img/integrations/hermes-desktop-config-panel.png new file mode 100644 index 000000000..68094086f Binary files /dev/null and b/hindsight-docs/static/img/integrations/hermes-desktop-config-panel.png differ diff --git a/hindsight-docs/static/img/integrations/hermes-desktop-dropdown.png b/hindsight-docs/static/img/integrations/hermes-desktop-dropdown.png new file mode 100644 index 000000000..2c25dd936 Binary files /dev/null and b/hindsight-docs/static/img/integrations/hermes-desktop-dropdown.png differ