diff --git a/website/docs/integrations/providers.md b/website/docs/integrations/providers.md index 643cdbf5b..ca6a0c511 100644 --- a/website/docs/integrations/providers.md +++ b/website/docs/integrations/providers.md @@ -846,6 +846,7 @@ You can switch between providers at any time with `hermes model` — no restart | OpenAI TTS + voice transcription | [OpenAI](https://platform.openai.com/api-keys) | `VOICE_TOOLS_OPENAI_KEY` | | RL Training | [Tinker](https://tinker-console.thinkingmachines.ai/) + [WandB](https://wandb.ai/) | `TINKER_API_KEY`, `WANDB_API_KEY` | | Cross-session user modeling | [Honcho](https://honcho.dev/) | `HONCHO_API_KEY` | +| Semantic long-term memory | [Supermemory](https://supermemory.ai) | `SUPERMEMORY_API_KEY` | ### Self-Hosting Firecrawl diff --git a/website/docs/reference/cli-commands.md b/website/docs/reference/cli-commands.md index 5fbe921b5..55983b1c6 100644 --- a/website/docs/reference/cli-commands.md +++ b/website/docs/reference/cli-commands.md @@ -383,7 +383,7 @@ Subcommands: hermes memory ``` -Set up and manage external memory provider plugins. Available providers: honcho, openviking, mem0, hindsight, holographic, retaindb, byterover. Only one external provider can be active at a time. Built-in memory (MEMORY.md/USER.md) is always active. +Set up and manage external memory provider plugins. Available providers: honcho, openviking, mem0, hindsight, holographic, retaindb, byterover, supermemory. Only one external provider can be active at a time. Built-in memory (MEMORY.md/USER.md) is always active. Subcommands: diff --git a/website/docs/reference/environment-variables.md b/website/docs/reference/environment-variables.md index fb2a67523..899349325 100644 --- a/website/docs/reference/environment-variables.md +++ b/website/docs/reference/environment-variables.md @@ -98,6 +98,7 @@ For native Anthropic auth, Hermes prefers Claude Code's own credential files whe | `GITHUB_TOKEN` | GitHub token for Skills Hub (higher API rate limits, skill publish) | | `HONCHO_API_KEY` | Cross-session user modeling ([honcho.dev](https://honcho.dev/)) | | `HONCHO_BASE_URL` | Base URL for self-hosted Honcho instances (default: Honcho cloud). No API key required for local instances | +| `SUPERMEMORY_API_KEY` | Semantic long-term memory with profile recall and session ingest ([supermemory.ai](https://supermemory.ai)) | | `TINKER_API_KEY` | RL training ([tinker-console.thinkingmachines.ai](https://tinker-console.thinkingmachines.ai/)) | | `WANDB_API_KEY` | RL training metrics ([wandb.ai](https://wandb.ai/)) | | `DAYTONA_API_KEY` | Daytona cloud sandboxes ([daytona.io](https://daytona.io/)) | diff --git a/website/docs/user-guide/features/memory-providers.md b/website/docs/user-guide/features/memory-providers.md index 3c4150ffd..3396c70e7 100644 --- a/website/docs/user-guide/features/memory-providers.md +++ b/website/docs/user-guide/features/memory-providers.md @@ -1,12 +1,12 @@ --- sidebar_position: 4 title: "Memory Providers" -description: "External memory provider plugins — Honcho, OpenViking, Mem0, Hindsight, Holographic, RetainDB, ByteRover" +description: "External memory provider plugins — Honcho, OpenViking, Mem0, Hindsight, Holographic, RetainDB, ByteRover, Supermemory" --- # Memory Providers -Hermes Agent ships with 7 external memory provider plugins that give the agent persistent, cross-session knowledge beyond the built-in MEMORY.md and USER.md. Only **one** external provider can be active at a time — the built-in memory is always active alongside it. +Hermes Agent ships with 8 external memory provider plugins that give the agent persistent, cross-session knowledge beyond the built-in MEMORY.md and USER.md. Only **one** external provider can be active at a time — the built-in memory is always active alongside it. ## Quick Start @@ -20,7 +20,7 @@ Or set manually in `~/.hermes/config.yaml`: ```yaml memory: - provider: openviking # or honcho, mem0, hindsight, holographic, retaindb, byterover + provider: openviking # or honcho, mem0, hindsight, holographic, retaindb, byterover, supermemory ``` ## How It Works @@ -382,6 +382,47 @@ hermes config set memory.provider byterover --- +### Supermemory + +Semantic long-term memory with profile recall, semantic search, explicit memory tools, and session-end conversation ingest via the Supermemory graph API. + +| | | +|---|---| +| **Best for** | Semantic recall with user profiling and session-level graph building | +| **Requires** | `pip install supermemory` + [API key](https://supermemory.ai) | +| **Data storage** | Supermemory Cloud | +| **Cost** | Supermemory pricing | + +**Tools:** `supermemory_store` (save explicit memories), `supermemory_search` (semantic similarity search), `supermemory_forget` (forget by ID or best-match query), `supermemory_profile` (persistent profile + recent context) + +**Setup:** +```bash +hermes memory setup # select "supermemory" +# Or manually: +hermes config set memory.provider supermemory +echo 'SUPERMEMORY_API_KEY=your-key-here' >> ~/.hermes/.env +``` + +**Config:** `$HERMES_HOME/supermemory.json` + +| Key | Default | Description | +|-----|---------|-------------| +| `container_tag` | `hermes` | Container tag used for search and writes | +| `auto_recall` | `true` | Inject relevant memory context before turns | +| `auto_capture` | `true` | Store cleaned user-assistant turns after each response | +| `max_recall_results` | `10` | Max recalled items to format into context | +| `profile_frequency` | `50` | Include profile facts on first turn and every N turns | +| `capture_mode` | `all` | Skip tiny or trivial turns by default | +| `api_timeout` | `5.0` | Timeout for SDK and ingest requests | + +**Key features:** +- Automatic context fencing — strips recalled memories from captured turns to prevent recursive memory pollution +- Session-end conversation ingest for richer graph-level knowledge building +- Profile facts injected on first turn and at configurable intervals +- Trivial message filtering (skips "ok", "thanks", etc.) + +--- + ## Provider Comparison | Provider | Storage | Cost | Tools | Dependencies | Unique Feature | @@ -393,13 +434,14 @@ hermes config set memory.provider byterover | **Holographic** | Local | Free | 2 | None | HRR algebra + trust scoring | | **RetainDB** | Cloud | $20/mo | 5 | `requests` | Delta compression | | **ByteRover** | Local/Cloud | Free/Paid | 3 | `brv` CLI | Pre-compression extraction | +| **Supermemory** | Cloud | Paid | 4 | `supermemory` | Context fencing + session graph ingest | ## Profile Isolation Each provider's data is isolated per [profile](/docs/user-guide/profiles): - **Local storage providers** (Holographic, ByteRover) use `$HERMES_HOME/` paths which differ per profile -- **Config file providers** (Honcho, Mem0, Hindsight) store config in `$HERMES_HOME/` so each profile has its own credentials +- **Config file providers** (Honcho, Mem0, Hindsight, Supermemory) store config in `$HERMES_HOME/` so each profile has its own credentials - **Cloud providers** (RetainDB) auto-derive profile-scoped project names - **Env var providers** (OpenViking) are configured via each profile's `.env` file diff --git a/website/docs/user-guide/features/memory.md b/website/docs/user-guide/features/memory.md index 8be3f748f..77f74d28a 100644 --- a/website/docs/user-guide/features/memory.md +++ b/website/docs/user-guide/features/memory.md @@ -209,7 +209,7 @@ memory: ## External Memory Providers -For deeper, persistent memory that goes beyond MEMORY.md and USER.md, Hermes ships with 7 external memory provider plugins — including Honcho, OpenViking, Mem0, Hindsight, Holographic, RetainDB, and ByteRover. +For deeper, persistent memory that goes beyond MEMORY.md and USER.md, Hermes ships with 8 external memory provider plugins — including Honcho, OpenViking, Mem0, Hindsight, Holographic, RetainDB, ByteRover, and Supermemory. External providers run **alongside** built-in memory (never replacing it) and add capabilities like knowledge graphs, semantic search, automatic fact extraction, and cross-session user modeling.