Hermes Atlas
Memory & knowledge

YantrikDB Hermes Plugin

yantrikos/yantrikdb-hermes-plugin

Self-maintaining memory provider for Hermes Agent with contradiction tracking and explainable recall

In short

YantrikDB Hermes Plugin is a memory provider that plugs YantrikDB into Hermes Agent. It deduplicates memories, surfaces contradictions and explains why each memory was recalled, with an in-process backend as the default since v0.2.0.

What YantrikDB Hermes Plugin does

YantrikDB Hermes Plugin makes YantrikDB the memory provider for Hermes Agent. The README describes self-maintaining memory that canonicalizes duplicates, surfaces contradictions through a conflicts() call, ranks with recency in mind, and attaches a why_retrieved reason to each recalled item. As of v0.2.0 the default backend runs in-process, so installing the package is enough, with no separate server, token or GPU. An HTTP backend is available for high-availability clusters.

An on_pre_compress hook injects the highest-salience memories before Hermes compresses its context, so earlier constraints survive long sessions. The plugin also offers agent-authored skills stored in the database with an outcome ledger, through the yantrikdb_skill_define, _search and _outcome tools, as a peer to Hermes' filesystem Markdown skills. According to the README, Hermes maintainer guidance is that new memory providers are not merged upstream, so this repository is the canonical distribution and is installed with pip. The same engine also ships as an MCP server for Claude Code, Cursor and other MCP-capable agents.

Key features

  • In-process YantrikDB backend by default, with an HTTP backend for high-availability clusters
  • Duplicate canonicalization and contradiction tracking through conflicts()
  • Recency-aware ranking with a why_retrieved reason on each recall
  • on_pre_compress hook that keeps high-salience memories through context compression
  • Database-native agent skills with an outcome ledger
  • One-command registration with Hermes through yantrikdb-hermes install

When to use it

  • Keeping constraints and preferences available across long Hermes sessions
  • Telling Hermes a preference once and having it recalled in a later session
  • Spotting superseded or contradictory facts in an agent's long-term memory

Who it is for: Hermes Agent users who want a memory provider that deduplicates, tracks contradictions and explains recall.

How it fits with Hermes Agent

Built for Hermes Agent as a memory provider plugin, selected through hermes memory setup.

How to install YantrikDB Hermes Plugin

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

pip install yantrikdb-hermes-plugin
yantrikdb-hermes install
hermes memory setup

Requirements: Install into the same Python environment as Hermes; the default in-process backend needs no server, token or GPU

FAQ

What is YantrikDB Hermes Plugin?

YantrikDB Hermes Plugin is a memory provider for Hermes Agent backed by YantrikDB. It canonicalizes duplicate memories, surfaces contradictions and explains each recall with a why_retrieved reason.

How do I install YantrikDB Hermes Plugin?

Run pip install yantrikdb-hermes-plugin in the same Python environment as Hermes, then yantrikdb-hermes install, then hermes memory setup and select yantrikdb.

Is YantrikDB Hermes Plugin free and open source?

Yes. The repository is released under the MIT license.

Similar memory for Hermes Agent

All memory

Related guides: SOUL.md for Hermes Agent: what it is and how to write one · Run multiple Hermes agents with profiles