NousResearch/hermes-plugin-retaindb

NousResearch/hermes-plugin-retaindb

Description: Handoff: standalone Hermes memory provider plugin (retaindb). RetainDB — cloud memory API with hybrid search and 7 memory types.

Language: Python

License: MIT

Stars: 0

Forks: 0

Open issues: 0

Created: 2026-09-17T16:02:22Z

Pushed: 2026-09-17T16:02:25Z

Default branch: main

Fork: no

Archived: no

README: > Handoff repository. This is the standalone copy of the retaindb memory provider formerly bundled with Hermes Agent, published so its upstream maintainers can take it over. Not an official Nous Research plugin. See [HANDOFF.md](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
• pip install requests

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 |