mnemosyne-memory-provider

Implement a local memory backend for Hermes Agent using fastembed and sqlite-vec.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/Toqsick/MaxClaw --skill mnemosyne-memory-provider
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mnemosyne-memory-provider
Source: https://github.com/Toqsick/MaxClaw/tree/main/.claude/skills/mnemosyne-memory-provider
Command: npx skills add https://github.com/Toqsick/MaxClaw --skill mnemosyne-memory-provider

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires fastembed, sqlite, numpy, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a native memory backend for the Hermes Agent, enabling efficient embedding generation, vector search, and consolidation of working memories.

Core Features & Use Cases

  • Embedding Engine Setup: Utilizes fastembed for local embeddings, offering fast and efficient embedding generation.
  • Vector Search Setup: Facilitates setup of vector search using sqlite-vec extension for performance optimization.
  • Consolidation Workflow: Automates the consolidation of working memories into episodic summaries, enhancing memory efficiency.
  • Troubleshooting Guide: Provides detailed troubleshooting steps for common issues like missing embeddings, database locks, and recall problems.

Quick Start

Run the 'mnemosyne_stats' command to check the status of the Mnemosyne memory provider.

Frequently Asked Questions about mnemosyne-memory-provider

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

FAQPage Schema
How do I set up a local memory backend with vector search for my agent?

Set up a local memory backend by using fastembed for embedding generation and sqlite-vec for vector search. This provides efficient memory retrieval directly on Linux and macOS platforms without external API dependencies.

What is memory consolidation in agent workflows and when do I need it?

Memory consolidation automates the conversion of working memories into episodic summaries. You need it when your agent accumulates excessive interaction data, requiring summarization to maintain recall performance and reduce storage overhead.

Does fastembed work with sqlite for local vector search on macOS?

Fastembed works with sqlite-vec to provide local vector search on macOS. This stack utilizes Python libraries and numpy for data processing, ensuring embedding generation and retrieval without requiring dedicated external database servers.

How do I troubleshoot missing embeddings and database locks during vector search?

Troubleshoot missing embeddings and database locks by following the built-in diagnostic guide. It details steps to resolve recall problems, database lock contentions, and embedding generation failures within the local memory backend.

What are the limitations of using sqlite-vec for agent memory management?

Limitations of using sqlite-vec include potential database locks during concurrent access and platform optimization restricted to Linux and macOS. It is not designed for distributed environments, relying entirely on local Python resources.

Do I need numpy to run the Mnemosyne memory provider?

You need numpy along with fastembed and sqlite to run the memory provider. These dependencies support local embedding generation, vector search optimization, and the underlying numerical data processing.