Skip to content

Commit 2bf84c9

Browse files
committed
docs: marketing-ready README with v2 highlights, images, and updated roadmap
1 parent ae58b9c commit 2bf84c9

1 file changed

Lines changed: 28 additions & 1 deletion

File tree

README.md

Lines changed: 28 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,25 @@
3030

3131
Born from a production setup where [OpenClaw](https://github.com/openclaw/openclaw) agents, Claude Code, and n8n workflows needed to share memory across separate machines. Nothing existed that did this well, so we built it.
3232

33+
### What's New in v2.0
34+
35+
- **Per-Client Knowledge Base** — Fingerprint-based client identification with accent normalization. One tool call (`brain_client`) returns everything known about a client: brand, strategy, meetings, content, technical details, relationships. Fuzzy name resolution ("JL" resolves to "jetloans").
36+
- **Gemini Embedding 2** — Task-type-aware embeddings at 3072 dimensions. Uses `RETRIEVAL_DOCUMENT` for storage, `RETRIEVAL_QUERY` for search. Matryoshka support for flexible dimensionality (3072/1536/768).
37+
- **Import/Export** — Full backup and migration support. Export all memories as JSON, import with automatic deduplication. Never lose data when switching embedding providers again.
38+
- **Webhook Notifications** — Real-time dispatch when memories are stored, superseded, or deleted. Fire-and-forget to any HTTP endpoint.
39+
- **Entity Relationship Graph** — Track how entities connect through co-occurrence. Interactive D3.js visualization with dark theme, force-directed layout, search, and PNG export — a showpiece you can share with clients.
40+
- **Auto-Resolve Client Context** — Memories without explicit client_id are automatically tagged using fingerprint matching against the content.
41+
- **Smarter Consolidation** — The 6-hour LLM pass now reclassifies knowledge categories and infers entity relationship types (contact_of, same_owner, uses, works_on, competitor_of).
42+
43+
<p align="center">
44+
<img src=".github/shared memory.jpg" alt="Shared Memory Architecture" width="340" />
45+
<img src=".github/dual-database.jpg" alt="Dual Database Design" width="340" />
46+
</p>
47+
<p align="center">
48+
<img src=".github/4 memory type.jpg" alt="4 Memory Types" width="340" />
49+
<img src=".github/memory life cycle flow.jpg" alt="Memory Lifecycle" width="340" />
50+
</p>
51+
3352
## The Problem
3453

3554
You run multiple AI agents — Claude Code for development, OpenClaw for autonomous tasks, n8n for automation. They each maintain their own context and forget everything between sessions. When one agent discovers something important, the others never learn about it.
@@ -45,7 +64,8 @@ cd multi-agent-memory
4564

4665
# 2. Configure
4766
cp .env.example .env
48-
# Edit .env — set BRAIN_API_KEY, OPENAI_API_KEY, and QDRANT_API_KEY
67+
# Edit .env — set BRAIN_API_KEY and QDRANT_API_KEY
68+
# For embeddings: GEMINI_API_KEY (free tier) or OPENAI_API_KEY
4969

5070
# 3. Start services
5171
docker compose up -d
@@ -784,6 +804,13 @@ multi-agent-memory/
784804

785805
## Roadmap
786806

807+
**Shipped in v2.0:**
808+
- ~~Entity relationships + graph~~ — Done
809+
- ~~Import/Export~~ — Done
810+
- ~~Webhook notifications~~ — Done
811+
- ~~Client knowledge base~~ — Done
812+
813+
**Coming next:**
787814
- **Web dashboard** — Browse, search, and manage memories visually
788815
- **Python SDK**`pip install multi-agent-memory`
789816
- **Automatic memory capture** — System learns what's worth remembering vs what's noise

0 commit comments

Comments
 (0)