Skip to content

Commit 7dfaf59

Browse files
committed
update: add features
1 parent 402eda0 commit 7dfaf59

1 file changed

Lines changed: 78 additions & 160 deletions

File tree

README.md

Lines changed: 78 additions & 160 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
![MemU Banner](assets/banner.png)
44

55
# MemU
6-
**Your Personalized AI memory. Organized.**
6+
**Personalized memory for AI companions. Organized.**
77

88
[![PyPI version](https://badge.fury.io/py/memu.svg)](https://badge.fury.io/py/memu)
99
[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
@@ -20,12 +20,9 @@
2020

2121
<p align="center">
2222
<a href="./README.md"><img alt="English" src="https://img.shields.io/badge/English-d9d9d9"></a>
23-
<a href="./README_CN.md"><img alt="简体中文" src="https://img.shields.io/badge/简体中文-d9d9d9"></a>
24-
<a href="./README_JA.md"><img alt="日本語" src="https://img.shields.io/badge/日本語-d9d9d9"></a>
25-
<a href="./README_KR.md"><img alt="한국어" src="https://img.shields.io/badge/한국어-d9d9d9"></a>
2623
</p>
2724

28-
MemU is an open-source memory framework for personalized AI companions. We treat memory as an agent-controlled file system that stores user information as documents. It provides high-speed memory retrieval and enables self-evolution without interacting with users. The framework is easily extendable, enabling you to create AI companions that genuinely remember and grow with their users.
25+
MemU is an open-source memory framework specialized for AI companion that gives AI assistants long-term personalized memory. It acts like a "memory folder" managed by the AI itself. The framework finds memories instantly, updates and learns. With it, you can build AIs that truly memories you by continuously updating memories about who you are, what you care about, and your shared experiences, creating companions that grow alongside you.
2926

3027
![MemU Architecture](assets/architecture-overview.png)
3128

@@ -35,204 +32,141 @@ MemU is an open-source memory framework for personalized AI companions. We treat
3532

3633
## ⭐ Star Us on GitHub
3734

38-
<div align="center">
39-
4035
![star-us](https://github.com/NevaMind-AI/MemU/assets/star-us-animation.gif)
4136

4237
**🚀 Join 1,000+ developers building the future of AI memory**
4338

4439
Star MemU to get notified about new releases and join our growing community of AI developers building intelligent agents with persistent memory capabilities.
4540

46-
</div>
41+
**💬 Join our Discord community:** [https://discord.gg/hQZntfGsbJ](https://discord.gg/hQZntfGsbJ)
4742

4843
---
4944

50-
## 🏆 **Competitive Advantages**
51-
52-
<div align="center">
53-
54-
![Competitive Analysis](assets/competitive-analysis.png)
55-
56-
**Why MemU stands out from other memory solutions**
57-
58-
</div>
59-
60-
### 🎯 **Higher Memory Accuracy**
61-
62-
![Accuracy Chart](assets/accuracy-comparison-chart.gif)
63-
64-
**Industry-leading precision in memory retrieval**
65-
66-
MemU achieves **92.09% average accuracy** across all reasoning tasks, significantly outperforming competitors. Our advanced embedding and retrieval algorithms ensure that the most relevant memories are surfaced with unprecedented precision.
45+
MemU is built specifically for AI companions, creating personalized long-term memories through categorized memories, memory connections, evolving insights, and adaptive forgetting. Our framework transforms conversations into files, connects related experiences, grows understanding over time, and prioritizes what matters most - making AI companions feel truly alive and personally connected.
6746

68-
| Model | Single-Hop | Multi-Hop | Open Domain | Temporal Reasoning | Avg. Score |
69-
|-------------|------------|-----------|-------------|------------|---------------------|
70-
| **OpenAI** | 63.79 | 42.92 | 62.29 | 21.71 | 52.90 |
71-
| **Mem0** | 67.13 | 51.15 | 72.93 | 55.51 | 66.88 |
72-
| **Mem0ᵍ** | 65.71 | 47.19 | 75.71 | 58.13 | 68.44 |
73-
| **Memobase** | 70.92 | 46.88 | 77.17 | 85.05 | 75.78 |
74-
| **Zep** | 74.11 | 66.04 | 67.71 | 79.76 | 75.14 |
75-
| **MIRIX** | 85.11 | 83.70 | 65.62 | 88.39 | 85.38 |
76-
| **MemU** | **94.88** | **88.30** | **77.08** | **92.52** | **92.09** |
77-
78-
*Based on comprehensive benchmarks against 7 leading memory frameworks using gpt-4.1-mini*
47+
## ✨ Key Features
7948

8049
---
8150

82-
### 🔄 **Flexible Retrieval Strategies**
51+
## 📋 **Categorized Memories**
8352

84-
![Retrieval Strategies](assets/retrieval-strategies-demo.gif)
53+
**Your AI companion remembers everything about you, organized and ready**
8554

86-
**Multiple recall methods for every use case**
55+
![Organized Memory Demo](assets/organized-memory-demo.gif)
8756

88-
MemU provides a comprehensive suite of retrieval strategies, allowing you to choose the optimal approach for your specific scenario. From semantic similarity to temporal proximity, our flexible system adapts to your needs.
57+
MemU automatically organizes your conversations into meaningful categories - your hobbies, work life, family stories, and personal preferences. Instead of scattered chat fragments, your AI companion builds a structured understanding of who you are, making every conversation feel personal and contextual.
8958

90-
**Available Strategies:**
91-
- 🔍 **Semantic Search** - Find memories by meaning and context
92-
- 🏷️ **Category-based** - Organized retrieval conten by topics
93-
- 🔗 **Graph Traversal** - Follow memory connections and relationships
94-
- 🎯 **Hybrid Fusion** - Combine multiple strategies for optimal results
59+
**Key Benefits:**
60+
- 🗂️ **Document-based storage** - Each memory type is stored as readable documents
61+
- 🏷️ **Smart categorization** - Automatic classification by topics and contexts
62+
- 🔍 **Easy retrieval** - Quick access to relevant information through categories
9563

9664
---
9765

98-
### 📖 **Human-Readable Memory Format**
99-
100-
![Memory Format Comparison](assets/memory-format-comparison.png)
66+
## 🔗 **Memory Connections**
10167

102-
**Memories you can actually read and understand**
68+
**Your AI companion connects the dots between your stories**
10369

104-
Unlike other memory systems that store information as abstract vectors or fragmented data, MemU organizes memories as **readable documents**. This transparency enables easy debugging, manual editing, and seamless integration with existing workflows.
105-
106-
**Readability Benefits:**
107-
- 📝 **Document Structure** - Organized as markdown files with clear headers
108-
- 👁️ **Visual Inspection** - Easily browse and audit stored memories
109-
- ✏️ **Manual Editing** - Direct modification when needed
110-
- 🔍 **Debugging Support** - Trace memory issues with human-readable content
111-
- 🤝 **Team Collaboration** - Share and review memory content across teams
112-
- 📋 **Export Friendly** - Standard formats compatible with any system
70+
![Linked Connections Demo](assets/linked-connections-demo.gif)
11371

114-
---
72+
When you mention your love for hiking, your AI companion remembers you talked about buying boots last month, and connects it to your upcoming mountain trip. These connections help your AI understand the full context of your infomation, making conversations feel natural and insightful.
11573

116-
## ✨ Key Features
74+
**Key Benefits:**
75+
- 🕸️ **Smart connections** - Your AI links related memories automatically
76+
- 🔄 **Context awareness** - Previous conversations inform current ones
11777

11878
---
11979

120-
## 📋 **Organized Memory**
80+
## 🧠 **Evolving Insights**
12181

122-
<div align="center">
123-
124-
**Transform chaotic information into structured knowledge**
125-
126-
![Organized Memory Demo](assets/organized-memory-demo.gif)
82+
**Your AI companion learns about you even when you're not chatting**
12783

128-
</div>
84+
![Evolved Intelligence Demo](assets/evolved-intelligence-demo.gif)
12985

130-
MemU intelligently organizes memories into well-structured documents, creating a coherent knowledge base that grows with each interaction. Unlike traditional memory systems that store isolated fragments, MemU maintains contextual relationships and categorical organization.
86+
Even when you're not actively talking to it, your AI companion continuously analyzes your stored memories, discovering new patterns and insights about your preferences, habits, and personality. It's like having a friend who's always thinking about you and getting to know you better in the background.
13187

13288
**Key Benefits:**
133-
- 🗂️ **Document-based storage** - Each memory type is stored as readable documents
134-
- 🏷️ **Smart categorization** - Automatic classification by topics and contexts
135-
- 🔍 **Easy retrieval** - Quick access to relevant information through semantic search
136-
- 📊 **Structured format** - Consistent organization across all memory types
89+
- 🤔 **Theory of Mind** - Deep understanding of your mental states and preferences
90+
- 📝 **Self-improvement** - Automatically enhances existing memories
91+
- 🌱 **Continuous learning** - Gets smarter about you over time
92+
13793

13894
---
13995

140-
## 🔗 **Linked Connections**
96+
## 🌫️ **Adaptive Forgetting**
14197

142-
<table align="center">
143-
<tr>
144-
<td width="50%">
98+
**Your AI companion remembers what matters most**
14599

146-
**Build a web of interconnected knowledge**
100+
![Memory Fade Demo](assets/memory-fade-1.gif)
147101

148-
Different memories are interconnected through sophisticated semantic relationships, creating a rich network of contextual associations. This enables the AI to understand not just individual facts, but how concepts relate to each other across different conversations and contexts.
102+
MemU implements an intelligent LRU-like forgetting mechanism where memories naturally fade in importance without disappearing entirely. This mimics human memory patterns - rarely accessed information becomes less prominent while frequently referenced memories gain stronger relevance.
149103

150104
**Key Benefits:**
151-
- 🕸️ **Semantic linking** - Memories connect based on meaning and context
152-
- 🔄 **Cross-referencing** - Related information surfaces automatically
153-
- 🧩 **Contextual understanding** - AI grasps relationships between different topics
154-
- 📈 **Knowledge graph** - Dynamic network that expands with each interaction
155-
156-
</td>
157-
<td width="50%">
158-
159-
![Linked Connections Demo](assets/linked-connections-demo.gif)
160-
161-
</td>
162-
</tr>
163-
</table>
105+
-**Time-based decay** - Unused memories naturally fade in importance
106+
- 🔄 **Usage-based boost** - Recently accessed memories gain higher relevance
107+
- 💾 **Never truly lost** - Information fades but remains retrievable when needed
108+
- 🎯 **Smart prioritization** - Most relevant memories surface first in conversations
164109

165110
---
166111

167-
## 🧠 **Evolved Intelligence**
112+
## 🏆 **Competitive Advantages**
168113

169-
<table align="center">
170-
<tr>
171-
<td width="50%">
114+
![Competitive Analysis](assets/competitive-analysis.png)
172115

173-
![Evolved Intelligence Demo](assets/evolved-intelligence-demo.gif)
116+
**Why MemU stands out from other memory solutions**
174117

175-
</td>
176-
<td width="50%">
118+
### 🎯 **Higher Memory Accuracy**
177119

178-
**Self-improving AI that grows smarter over time**
120+
MemU achieves **92.09% average accuracy** across all reasoning tasks, significantly outperforming competitors.
179121

180-
The Memory Agent continuously performs Theory of Mind reasoning, analyzing stored memories to generate deeper insights about user preferences, behaviors, and needs. This creates an evolving understanding that enhances existing documents and generates new knowledge automatically.
122+
| Model | Single-Hop | Multi-Hop | Open Domain | Temporal Reasoning | Avg. Score |
123+
|-------------|------------|-----------|-------------|------------|---------------------|
124+
| **OpenAI** | 63.79 | 42.92 | 62.29 | 21.71 | 52.90 |
125+
| **Mem0** | 67.13 | 51.15 | 72.93 | 55.51 | 66.88 | |
126+
| **Memobase** | 70.92 | 46.88 | 77.17 | 85.05 | 75.78 |
127+
| **Zep** | 74.11 | 66.04 | 67.71 | 79.76 | 75.14 | |
128+
| **MemU** | **94.88** | **88.30** | 77.08 | **92.52** | **92.09** |
181129

182-
**Key Benefits:**
183-
- 🤔 **Theory of Mind** - Deep understanding of user mental states and preferences
184-
- 📝 **Self-enhancement** - Automatically improves existing memory documents
185-
- 💡 **Insight generation** - Creates new understanding from existing information
186-
- 🌱 **Continuous growth** - Knowledge base becomes more sophisticated over time
187-
188-
</td>
189-
</tr>
190-
</table>
130+
*Based on comprehensive benchmarks against other memory frameworks*
191131

192132
---
193133

194-
## 🌫️ **Fade Memory**
134+
### 🔄 **Flexible Retrieval Strategies**
195135

196-
<div align="center">
197136

198-
**Natural forgetting that preserves what matters**
137+
**Multiple recall methods for every use case**
199138

200-
<table>
201-
<tr>
202-
<td width="33%">
139+
MemU provides a comprehensive suite of retrieval strategies, allowing you to choose the optimal approach for your specific scenario. From semantic similarity to category search, our flexible system adapts to your needs.
203140

204-
![Memory Fade 1](assets/memory-fade-1.gif)
141+
**Available Strategies:**
205142

206-
</td>
207-
<td width="34%">
143+
- 🔍 **Semantic Search** - Find memories by meaning and context using advanced embedding models. Perfect for natural language queries and conceptual searches that go beyond keyword matching.
208144

209-
![Memory Fade 2](assets/memory-fade-2.gif)
145+
- 🏷️ **Category-based Retrieval** - Organize memories through topic category classification. Ideal for structured information retrieval and domain-specific searches.
210146

211-
</td>
212-
<td width="33%">
147+
- 🔗 **Graph Traversal** - Discover related information by following memory connections and relationship networks. Enables exploration of indirect relationships and contextual paths between concepts.
213148

214-
![Memory Fade 3](assets/memory-fade-3.gif)
149+
- 🎯 **Hybrid Fusion** - Combine multiple strategies using ensemble methods. Delivers optimal performance for complex queries requiring maximum accuracy.
215150

216-
</td>
217-
</tr>
218-
</table>
151+
- 🧠 **Active Retrieval** - Determine when to retrieve memories based on conversation context and relevance. Prevents unnecessary retrievals while ensuring important memories are surfaced when needed.
152+
---
219153

220-
</div>
154+
### 📖 **Human-Readable Memory Format**
221155

222-
MemU implements an intelligent LRU-like forgetting mechanism where memories naturally fade in importance without disappearing entirely. This mimics human memory patterns - rarely accessed information becomes less prominent while frequently referenced memories gain stronger relevance.
156+
**Memories you can actually read and understand**
223157

224-
**Key Benefits:**
225-
-**Time-based decay** - Unused memories naturally fade in importance
226-
- 🔄 **Usage-based boost** - Recently accessed memories gain higher relevance
227-
- 💾 **Never truly lost** - Information fades but remains retrievable when needed
228-
- 🎯 **Smart prioritization** - Most relevant memories surface first in conversations
158+
Unlike other memory frameworks that store information as fragmented sentences, MemU organizes memories as **coherent, readable documents**. While competitors break down information into scattered fragments, MemU maintains context and structure, enabling easy debugging, manual editing, and seamless integration with existing workflows.
159+
160+
**Readability Benefits:**
161+
- 📝 **Document Structure** - Organized as markdown files with clear headers
162+
- 🔗 **Wiki-like Links** - Documents with interconnected links enabling seamless navigation between related memories
163+
- 📋 **Export Friendly** - Standard formats compatible with any system
229164

230165
---
231166

232167

233-
## 🚀 Quick Start
234168

235-
<div align="center">
169+
## 🚀 Quick Start
236170

237171
### **Installation in 30 seconds**
238172

@@ -260,8 +194,6 @@ results = memory_agent.process_conversation("Hi, I'm learning Python", "student_
260194

261195
Try MemU instantly in your browser: [**🔗 Interactive Demo**](https://demo.nevamind.ai)
262196

263-
</div>
264-
265197
---
266198

267199
## 📚 Usage Guide & Research Highlights
@@ -293,8 +225,6 @@ Try MemU instantly in your browser: [**🔗 Interactive Demo**](https://demo.nev
293225

294226
## 🤝 Contributing
295227

296-
<div align="center">
297-
298228
![Contributing Flow](assets/contributing-flow.png)
299229

300230
### **Join Our Mission**
@@ -330,14 +260,10 @@ git push origin feature/amazing-feature
330260
- Additional embedding providers
331261
- Enterprise security features
332262

333-
</div>
334-
335263
---
336264

337265
## 🌍 Community
338266

339-
<div align="center">
340-
341267
<table>
342268
<tr>
343269
<td width="50%">
@@ -355,17 +281,15 @@ git push origin feature/amazing-feature
355281

356282
### **Connect with the MemU Community**
357283

358-
<p align="center">
359-
<a href="https://discord.gg/your-discord-server">
360-
<img src="https://img.shields.io/badge/Discord-Join%20Chat-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord">
361-
</a>
362-
<a href="https://github.com/NevaMind-AI/MemU/discussions">
363-
<img src="https://img.shields.io/badge/GitHub-Discussions-181717?style=for-the-badge&logo=github&logoColor=white" alt="GitHub Discussions">
364-
</a>
365-
<a href="https://twitter.com/nevamind_ai">
366-
<img src="https://img.shields.io/badge/X-Follow-1DA1F2?style=for-the-badge&logo=x&logoColor=white" alt="X (Twitter)">
367-
</a>
368-
</p>
284+
<a href="https://discord.gg/your-discord-server">
285+
<img src="https://img.shields.io/badge/Discord-Join%20Chat-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord">
286+
</a>
287+
<a href="https://github.com/NevaMind-AI/MemU/discussions">
288+
<img src="https://img.shields.io/badge/GitHub-Discussions-181717?style=for-the-badge&logo=github&logoColor=white" alt="GitHub Discussions">
289+
</a>
290+
<a href="https://twitter.com/nevamind_ai">
291+
<img src="https://img.shields.io/badge/X-Follow-1DA1F2?style=for-the-badge&logo=x&logoColor=white" alt="X (Twitter)">
292+
</a>
369293

370294
### **📞 Get Support**
371295

@@ -389,18 +313,12 @@ Report security issues to [security@nevamind.ai](mailto:security@nevamind.ai)
389313

390314
Licensed under [Apache License 2.0](LICENSE)
391315

392-
</div>
393-
394316
---
395317

396-
<div align="center">
397-
398318
![AI Memory Animation](assets/ai-memory-animation.gif)
399319

400320
**MemU** - Building the memory foundation for next-generation AI agents 🧠✨
401321

402322
*Made with ❤️ by the [NevaMind AI](https://nevamind.ai) team*
403323

404-
![Footer Decoration](assets/footer-decoration.png)
405-
406-
</div>
324+
![Footer Decoration](assets/footer-decoration.png)

0 commit comments

Comments
 (0)