Files
hermes-agent/plugins/memory/mem0_local
Alexander Whitestone 3238cf4eb1
Some checks failed
Contributor Attribution Check / check-attribution (pull_request) Successful in 38s
Docker Build and Publish / build-and-push (pull_request) Has been skipped
Supply Chain Audit / Scan PR for supply chain risks (pull_request) Successful in 32s
Tests / test (pull_request) Failing after 43m54s
Tests / e2e (pull_request) Successful in 2m5s
feat: Tool investigation report + Mem0 local provider (#842)
## Investigation Report
- docs/tool-investigation-2026-04-15.md: Full report analyzing 414 tools
  from awesome-ai-tools. Top 5 recommendations with integration paths.
- docs/plans/awesome-ai-tools-integration.md: Implementation tracking plan.

## Mem0 Local Provider (P1)
- plugins/memory/mem0_local/: New ChromaDB-backed memory provider.
  No API key required - fully sovereign. Compatible tool schemas with
  cloud Mem0 (mem0_profile, mem0_search, mem0_conclude).
- Pattern-based fact extraction from conversations.
- Deterministic dedup via content hashing.
- Circuit breaker for resilience.
- tests/plugins/memory/test_mem0_local.py: Full test coverage.

## Issues Filed
- #857: LightRAG integration (P2)
- #858: n8n workflow orchestration (P3)
- #859: RAGFlow document understanding (P4)
- #860: tensorzero LLMOps evaluation (P3)

Closes #842
2026-04-15 23:04:41 -04:00
..

Mem0 Local - Sovereign Memory Provider

Local-only memory provider using ChromaDB. No API key required - all data stays on your machine.

How It Differs from Cloud Mem0

Feature Cloud Mem0 Local Mem0
API key Required Not needed
Data location Mem0 servers Your machine
Fact extraction Server-side LLM Pattern-based heuristics
Reranking Yes No
Cost Freemium Free forever

Setup

pip install chromadb
hermes config set memory.provider mem0-local

Or manually in ~/.hermes/config.yaml:

memory:
  provider: mem0-local

Config

Config file: $HERMES_HOME/mem0-local.json

Key Default Description
storage_path ~/.hermes/mem0-local/ ChromaDB storage directory
collection_prefix mem0 Collection name prefix
max_memories 10000 Maximum stored memories

Tools

Same interface as cloud Mem0:

Tool Description
mem0_profile All stored memories about the user
mem0_search Semantic search by meaning
mem0_conclude Store a fact verbatim

Data Sovereignty

All data is stored in $HERMES_HOME/mem0-local/ as a ChromaDB persistent database. No network calls are made.

To back up: copy the mem0-local/ directory. To reset: delete the mem0-local/ directory.

Limitations

  • Fact extraction is pattern-based (not LLM-powered)
  • No reranking - results ranked by embedding similarity only
  • No cross-device sync (by design)
  • Requires chromadb pip dependency (~50MB)