hermes-mnemosyne

Configure, troubleshoot, and operate the Mnemosyne memory provider for Hermes Agent.

115|9|Updated Aug 5, 2026
One-click install
npx skills add https://github.com/AtlasOmnia/donna-starter --skill hermes-mnemosyne-atlasomnia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hermes-mnemosyne
Source: https://github.com/AtlasOmnia/donna-starter/tree/main/skills/hermes/hermes-mnemosyne
Command: npx skills add https://github.com/AtlasOmnia/donna-starter --skill hermes-mnemosyne-atlasomnia

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing the Mnemosyne memory provider in Hermes Agent involves non-obvious pitfalls: provider-injected tools that are not toolsets, profile databases that silently share storage, consolidation jobs that hang or corrupt recall ranking, and providers that vanish after runtime updates. This Skill provides the operational knowledge to install, configure, consolidate, and repair Mnemosyne correctly. ## Core Features & Use Cases - Installation & Repair: Verify provider status with hermes memory status, repair missing plugin symlinks, and re-verify after every Hermes runtime update. - Profile Isolation: Set explicit per-profile MNEMOSYNE_DATA_DIR paths so cloned or renamed profiles never write into a shared database. - Consolidation Management: Run safe manual or auto sleep cycles, choose the right LLM path (host LLM, remote API, or local GGUF), and avoid known ranking defects in version 3.14.0. - Use Case: After renaming a Hermes profile, recall stops working. The Skill guides you to rewrite the absolute MNEMOSYNE_DATA_DIR path in the profile's .env, restart the gateway, and verify with a write/recall smoke test. ## Quick Start Check whether Mnemosyne is installed and active by running hermes memory status, then follow the Skill's guidance to configure or repair the provider.

Frequently Asked Questions about hermes-mnemosyne

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if Mnemosyne is installed in Hermes?

Run hermes memory status to see the configured provider and whether the plugin is installed. If it reports the plugin as not installed but the CLI exists, run the mnemosyne-install script in the Hermes virtual environment to repair the symlink.

Mnemosyne vs Mem0: which memory tool should I use?

Mnemosyne fits local-first Hermes assistant setups with profile isolation, inspectable SQLite storage, and provider-injected tools. Mem0 is the safer productized choice for customer-facing SaaS apps due to its mature SDKs, hosted platform, and larger ecosystem.

Why do Mnemosyne tools not work in Hermes cron jobs?

The Mnemosyne provider skips initialization in cron, flush, subagent, background, and skill_loop contexts, so its tools are never injected there. Use a no_agent cron job calling the mnemosyne CLI directly, or enable auto-sleep for consolidation during normal sessions.

How do I give each Hermes profile its own Mnemosyne database?

Set an absolute MNEMOSYNE_DATA_DIR path in each profile's .env file before the first memory-enabled session, pointing to that profile's own directory. Without this, all profiles silently share the default database under the real home directory.

Should I enable Mnemosyne auto-sleep consolidation?

Not by default with version 3.14.0, which has a known defect where sleep-generated summaries outrank source memories in recall. Run a recall evaluation before and after a manual sleep pass, and enable auto-sleep only if recall does not regress.

Why did Mnemosyne stop working after a Hermes update?

Hermes runtime repairs can rebuild the virtual environment and remove externally installed packages while leaving the database intact. Verify hermes memory status after every update and reinstall the provider adapter if it is missing.