Files
hermes-agent/plugins/memory/mem0_local/README.md
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

61 lines
1.5 KiB
Markdown

# 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
```bash
pip install chromadb
hermes config set memory.provider mem0-local
```
Or manually in ~/.hermes/config.yaml:
```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)