|
| 1 | +--- |
| 2 | +sidebar_position: 39 |
| 3 | +title: "Hermes Desktop App: Configure Hindsight Memory | Integration" |
| 4 | +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." |
| 5 | +--- |
| 6 | + |
| 7 | +# Hermes Desktop |
| 8 | + |
| 9 | +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. |
| 10 | + |
| 11 | +:::tip |
| 12 | +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. |
| 13 | +::: |
| 14 | + |
| 15 | +## Setup |
| 16 | + |
| 17 | +**1. Open Settings → Memory & Context.** In the **Memory Provider** dropdown, choose **Hindsight**. |
| 18 | + |
| 19 | + |
| 20 | + |
| 21 | +**2. Fill in the Hindsight settings panel.** Selecting Hindsight reveals its configuration fields: |
| 22 | + |
| 23 | + |
| 24 | + |
| 25 | +| Field | What it does | Default | |
| 26 | +| ----------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------ | |
| 27 | +| **Mode** | `Cloud` (just needs an API key) or `Local External` (connect to an existing Hindsight instance) | `Cloud` | |
| 28 | +| **API key** | Authenticates with the Hindsight API — stored as a write-only secret | — | |
| 29 | +| **API URL** | The Hindsight endpoint | `https://api.hindsight.vectorize.io` | |
| 30 | +| **Bank ID** | Which memory bank this Hermes profile reads and writes | `hermes` | |
| 31 | +| **Recall budget** | How hard recall works each turn: `low` / `mid` / `high` | `mid` | |
| 32 | + |
| 33 | +**3. Click Save.** That's it — Hermes now has persistent long-term memory. |
| 34 | + |
| 35 | +## Connection Modes |
| 36 | + |
| 37 | +### Cloud (recommended) |
| 38 | + |
| 39 | +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. |
| 40 | + |
| 41 | +### Local External |
| 42 | + |
| 43 | +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. |
| 44 | + |
| 45 | +## How Memory Is Stored |
| 46 | + |
| 47 | +Your settings are saved to the right place automatically: |
| 48 | + |
| 49 | +- **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). |
| 50 | +- **Mode, API URL, Bank ID, and Recall budget** are written to your Hermes profile config. |
| 51 | + |
| 52 | +Each profile points at one **Bank ID**, so memory is isolated per profile and follows you across every machine that profile runs on. |
| 53 | + |
| 54 | +## Next Steps |
| 55 | + |
| 56 | +- **Hindsight Cloud (free):** [ui.hindsight.vectorize.io](https://ui.hindsight.vectorize.io) |
| 57 | +- **Hermes CLI / plugin setup:** [Hermes Agent integration](/sdks/integrations/hermes) |
| 58 | +- **Hermes Agent:** [github.com/NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent) |
0 commit comments