Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
58 changes: 58 additions & 0 deletions hindsight-docs/docs-integrations/hermes-desktop.md
Original file line number Diff line number Diff line change
@@ -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)
4 changes: 4 additions & 0 deletions hindsight-docs/docs-integrations/hermes.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`.
Expand Down
10 changes: 10 additions & 0 deletions hindsight-docs/src/data/integrations.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.