HydraDB for Hermes Agent

A Hermes Agent memory provider backed by HydraDB: relevant context is recalled before each turn and completed turns are persisted - the proper native way to make HydraDB Hermes' long-term memory (like the supermemory / retaindb / ham providers).

How it works

Implements Hermes' MemoryProvider contract:

Public API only (recall + knowledge ingest); no HydraDB SDK required.

Prerequisites

• Python >= 3.10, a Hermes Agent install
• A HydraDB account: API key + tenant ID (hydradb.com)

Install

Directory (drop-in): copy the hydradb_hermes/ folder into ~/.hermes/plugins/memory/hydradb/ (it contains __init__.py + plugin.yaml).

pip (entry point): pip install hydradb-hermes - registered via the hermes_agent.memory_providers entry point.

Then enable it in config.yaml (memory providers are single-select):

memory:
  provider: hydradb

Credentials come from the environment:

export HYDRADB_API_KEY="your-api-key"
export HYDRADB_DATABASE="your-tenant-id"

Test

pip install -e ".[test]"
pytest

MCP alternative

For pull-style recall (agent-invoked tools) instead of automatic memory, point Hermes at the MCP server (see hermes-mcp.snippet.json). The provider gives automatic recall/retain, so MCP is optional.

License

Apache-2.0 - Copyright (c) 2026 HydraDB