Skip to content

Commit 331e511

Browse files
committed
docs(hermes): add standalone Hermes Desktop integration page
Split the desktop-app setup into its own integration: a new 'Hermes Desktop' gallery card + page (/sdks/integrations/hermes-desktop) covering the in-app config flow (select Hindsight in Settings, fill Mode/API key/ API URL/Bank ID/Recall budget) with the two UI screenshots. Cross-linked with the CLI/plugin Hermes page; the Hermes page keeps a tip pointing to the desktop guide. Signed-off-by: Ben <ben.bartholomew@vectorize.io>
1 parent c7e5095 commit 331e511

5 files changed

Lines changed: 72 additions & 0 deletions

File tree

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
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+
![Selecting Hindsight as the memory provider in the Hermes desktop app's Settings → Memory & Context](/img/integrations/hermes-desktop-dropdown.png)
20+
21+
**2. Fill in the Hindsight settings panel.** Selecting Hindsight reveals its configuration fields:
22+
23+
![The Hindsight memory provider configuration panel in the Hermes desktop app](/img/integrations/hermes-desktop-config-panel.png)
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)

hindsight-docs/docs-integrations/hermes.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,10 @@ description: "Add long-term memory to Hermes Agent with Hindsight. Automatically
88

99
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.
1010

11+
:::tip
12+
Using the **Hermes desktop app**? You can select and configure Hindsight entirely in Settings — no terminal required. See [Hermes Desktop](/sdks/integrations/hermes-desktop).
13+
:::
14+
1115
## Quick Start
1216

1317
**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`.

hindsight-docs/src/data/integrations.json

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -90,6 +90,16 @@
9090
"link": "/sdks/integrations/hermes",
9191
"icon": "/img/icons/hermes.png"
9292
},
93+
{
94+
"id": "hermes-desktop",
95+
"name": "Hermes Desktop",
96+
"description": "Configure Hindsight as your memory provider directly in the Hermes desktop app — pick a mode, paste an API key, no config files.",
97+
"type": "native",
98+
"by": "hermes",
99+
"category": "tool",
100+
"link": "/sdks/integrations/hermes-desktop",
101+
"icon": "/img/icons/hermes.png"
102+
},
93103
{
94104
"id": "local-mcp",
95105
"name": "MCP Server",
127 KB
Loading
349 KB
Loading

0 commit comments

Comments
 (0)