Skip to main content

retaindb

✓ Officialv1.0.1

RetainDB cloud memory provider — hybrid search (vector + BM25 + reranking) over seven memory types, a stable user profile, explicit remember/forget tools and a shared file store. Formerly bundled with Hermes; maintained by Nous Research.

Open in Hermes Desktop
hermes plugins install retaindb

What it adds

Environment variables it needs 1

RETAINDB_API_KEY

README

From the reviewed commit 8d7ea4d ↗; it updates when the author re-pins.

Maintained by Nous Research. This is the retaindb memory provider that used to ship inside Hermes Agent under plugins/memory/retaindb/; it now installs from the Hermes plugin catalog. Existing memory.provider: retaindb setups keep their config and data. See HANDOFF.md.

RetainDB Memory Provider

Cloud memory API with hybrid search (Vector + BM25 + Reranking) and 7 memory types.

Requirements

  • RetainDB account ($20/month) from retaindb.com
  • requests (declared in pyproject.toml; hermes plugins install puts it in the Hermes venv, and Hermes core already ships it)

Setup

hermes memory setup    # select "retaindb"

Or manually:

hermes config set memory.provider retaindb
echo "RETAINDB_API_KEY=your-key" >> ~/.hermes/.env

Config

All config via environment variables in .env:

Env Var Default Description
RETAINDB_API_KEY (required) API key
RETAINDB_BASE_URL https://api.retaindb.com API endpoint
RETAINDB_PROJECT auto (profile-scoped) Project identifier

Tools

Tool Description
retaindb_profile User's stable profile
retaindb_search Semantic search
retaindb_context Task-relevant context
retaindb_remember Store a fact with type + importance
retaindb_forget Delete a memory by ID
claude-subscription-directsdk✓ Official★ 75

Experimental model provider that runs Hermes turns on a Claude Pro/Max subscription through the official Claude Code CLI (the Agent SDK path), so no separate API key or per-token bill. Requires the claude CLI installed and logged in; the plugin checks for it at load, in hermes model, in the pickers and before every request, and refuses cleanly with the install hint when it is missing. Disclosure — every turn is billed against your Claude subscription's Agent SDK allowance, and the provider inherits whatever account claude is logged into.

Models
hermes-telegram-business✓ Official★ 41

Observe-with-approval Telegram Business Mode (secretary bot): every drafted customer reply needs owner approval before it is sent.

Platforms
hermes-memory-wiki✓ Official★ 29

Memory Wiki dashboard tab: browsable subject pages and daily logs derived from local session history, plus a read-only Persistent Memory (MEMORY.md / USER.md) audit panel.

Desktop
snyk✓ Official★ 9

Scan code (SAST), dependencies, container images, IaC and SBOMs with Snyk through its first-party MCP server (pinned snyk@1.1306.0 over npx stdio, CLI analytics disabled), with the snyk-security-scan workflow skill bundled. Portable Agent Plugins v1 package (mcp.json + skills/); needs Node.js/npm on PATH and a free Snyk account (browser login via the snyk_auth tool).

Tools
blender✓ Official★ 7

Official Blender Lab MCP server over stdio, pinned to upstream v1.0.3, with a Blender workflow skill. Requires Blender 5.1+, its separately installed MCP add-on, Git and uv. First startup downloads Python dependencies; prepare the uv environment before connecting. Disclosure: tools execute arbitrary Python in Blender with the user's privileges. No automatic application/version/liveness gate; server discovery does not prove scene readiness.

Tools
touchdesigner✓ Official★ 6

Drive a live TouchDesigner session through the twozero MCP server (Streamable HTTP on 127.0.0.1:40404), with the touchdesigner-mcp workflow skill bundled. Portable Agent Plugins v1 package (mcp.json + skills/); TouchDesigner itself runs on macOS/Windows.

Tools

← Back to the catalog · catalog built Oct 2, 2026