This plugin wires YantrikDB in as a memory provider for the Hermes Agent, aimed at long-running agents where plain vector memory fails: duplicates pile up, contradictions silently overwrite each other, and stale facts outrank fresh ones. YantrikDB's substrate addresses each of these — a maintenance pass canonicalizes duplicate facts, contradictions are surfaced as first-class conflicts the agent can inspect and resolve, ranking is recency-aware without deleting anything, and graph edges between memories boost related recall. Every recall result carries a why_retrieved list of scoring reasons, so the model can explain its own retrieval without extra prompt engineering.
Since v0.2.0 the default backend runs in-process: no separate server, token, or GPU, with a bundled ~8 MB static embedder (larger and multilingual embedders are optional tiers). An HTTP backend against yantrikdb-server exists for setups where multiple Hermes instances share one store. The agent gets twelve default tools (remember, recall, forget, think, conflicts, resolve_conflict, relate, stats, plus a trigger lifecycle for acknowledging or acting on maintenance signals), and three opt-in skill tools that let the agent author, search, and record outcomes for reusable procedural skills in a shared substrate. Lifecycle hooks consolidate at session end, inject high-salience memories before Hermes compresses context, and mirror built-in memory-file writes.
The repo emphasizes verifiability: a reproducible recall benchmark scores recall@k and MRR against a bundled corpus with CI-guarded floors, a 1000-fact comparison harness against other Hermes memory providers publishes its raw captures and honest caveats (including a bounded ingest-queue limitation hit during the burst test), and end-to-end verification transcripts against an unmodified Hermes install are included. It is distributed as a standalone plugin by design — Hermes is not merging new memory providers upstream — installed via the Hermes plugin manager or pip into the same Python environment Hermes runs from.
