Back to Hermes Agent

RetainDB Memory Provider

plugins/memory/retaindb/README.md

2026.6.51.0 KB
Original Source

RetainDB Memory Provider

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

Requirements

  • RetainDB account ($20/month) from retaindb.com
  • pip install requests

Setup

bash
hermes memory setup    # select "retaindb"

Or manually:

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

Config

All config via environment variables in .env:

Env VarDefaultDescription
RETAINDB_API_KEY(required)API key
RETAINDB_BASE_URLhttps://api.retaindb.comAPI endpoint
RETAINDB_PROJECTauto (profile-scoped)Project identifier

Tools

ToolDescription
retaindb_profileUser's stable profile
retaindb_searchSemantic search
retaindb_contextTask-relevant context
retaindb_rememberStore a fact with type + importance
retaindb_forgetDelete a memory by ID