Skip to content

Commit 2235b09

Browse files
sairin1202Jununn
andauthored
docs: revise README for clarity and roadmap inclusion (#86)
Co-authored-by: Jununn <jununhsu@gmail.com>
1 parent b9aef15 commit 2235b09

File tree

2 files changed

+66
-6
lines changed

2 files changed

+66
-6
lines changed

README.md

Lines changed: 64 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
![MemU Banner](assets/banner.png)
44

5-
### MemU: The Next-Gen Agentic Memory System
5+
### MemU: A Future-Oriented Agentic Memory System
66

77
[![PyPI version](https://badge.fury.io/py/memu-py.svg)](https://badge.fury.io/py/memu-py)
88
[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
@@ -11,11 +11,17 @@
1111
[![Twitter](https://img.shields.io/badge/Twitter-Follow-1DA1F2?logo=x&logoColor=white)](https://x.com/memU_ai)
1212
</div>
1313

14-
**MemU** is a next-generation Agentic Memory System that redesigns Agent memory architecture from a memory-centric perspective—abstracting it as a dynamically evolving data layer that intelligently organizes and retrieves relevant information based on context. Through adaptive retrieval and backtracking mechanisms, it dynamically extracts the most pertinent information.
15-
The system employs a **Unified Multimodal Memory** architecture with native support for diverse data types including text, images, and audio, forming a cohesive memory representation.
14+
MemU is a future-oriented Agentic Memory System that addresses the core issue of **inaccurate retrieval in traditional RAG-based memory frameworks**.
1615

17-
Visit our homepage: [memu.pro](https://memu.pro/)
16+
It redefines agent memory from a **memory-first perspective** by abstracting it as a dynamically evolving data layer. This layer intelligently organizes and surfaces relevant information based on the current task and context, dynamically extracting the most pertinent content through **adaptive retrieval** and **backtracking mechanisms**—while maintaining retrieval efficiency and ensuring information integrity and accuracy.MemU adopts a **Unified Multimodal Memory architecture** that enables AI agents to integrate and reason over diverse information sources, significantly enhancing memory performance in complex scenarios.
1817

18+
MemU offers several convenient ways to get started right away:
19+
20+
- **One call = response + memory**
21+
👉 memU Response API: https://memu.pro/docs#responseapi
22+
23+
- **Try it instantly**
24+
👉 https://app.memu.so/quick-start
1925
---
2026

2127
## ⭐ Star Us on GitHub
@@ -27,6 +33,60 @@ Star MemU to get notified about new releases and join our growing community of A
2733
**💬 Join our Discord community:** [https://discord.gg/memu](https://discord.gg/memu)
2834

2935
---
36+
## Roadmap
37+
38+
memU v0.3.0-Alpha has been released! This version initializes the memorize and retrieve workflows with the new 3-layer architecture.
39+
40+
Starting from this release, memU will roll out multiple features in the short- to mid-term:
41+
42+
### Core capabilities iteration
43+
- [ ] **Multi-modal enhancements** – Support for images, audio, and video
44+
- [ ] **Intention** – Higher-level decision-making and goal management
45+
- [ ] **Multi-client support** – Switch between OpenAI, Deepseek, Gemini, etc.
46+
- [ ] **Data persistence expansion** – Support for Postgres, S3, DynamoDB
47+
- [ ] **Benchmark tools** – Test agent performance and memory efficiency
48+
- [ ] ……
49+
50+
### Upcoming open-source repositories
51+
- [ ] **memU-ui** – The web frontend for memU, providing developers with an intuitive and visual interface
52+
- [ ] **memU-server** – Powers memU-ui with reliable data support, ensuring efficient reading, writing, and maintenance of agent memories
53+
54+
## 🧩 Why MemU?
55+
56+
Most memory systems in current LLM pipelines rely heavily on explicit modeling, requiring manual definition and annotation of memory categories. This limits AI’s ability to truly understand memory and makes it difficult to support diverse usage scenarios.
57+
58+
MemU offers a flexible and robust alternative, inspired by hierarchical storage architecture in computer systems. It progressively transforms heterogeneous input data into queryable and interpretable textual memory.
59+
60+
Its core architecture consists of three layers: **Resource Layer → Memory Item Layer → MemoryCategory Layer.**
61+
62+
<img width="1280" height="639" alt="image" src="https://github.com/user-attachments/assets/c34a1fdb-02fd-4542-9c10-121d79dba67f" />
63+
64+
- **Resource Layer**
65+
A multimodal raw data warehouse, also serving as the ground truth layer, providing a semantic foundation for the memory system.
66+
67+
- **Memory Item Layer**
68+
A unified semantic abstraction layer, functioning as the system’s semantic cache, supplying high-density semantic vectors for downstream retrieval and reasoning.
69+
70+
- **MemoryCategory Layer**
71+
A thematic document layer, mimicking human working memory mechanisms, balancing short-term response efficiency and long-term information completeness.
72+
73+
Through this three-layer design, **MemU brings genuine memory into the agent layer, achieving:**
74+
75+
- **Full Traceability**
76+
Complete traceability across the three layers—from raw data → memory items → aggregated documents. Enables bidirectional tracking of each knowledge piece’s source and evolution, ensuring transparency and interpretability.
77+
78+
- **End-to-End Memory Lifecycle Management**
79+
The three core processes correspond to the memory lifecycle: **Memorization → Retrieval → Self-evolution**.
80+
81+
- **Coherent and Scalable Memorization**
82+
During memorization, the system maintains memory coherence while automatically managing resources to support sustainable expansion.
83+
84+
- **Efficient and Interpretable Retrieval**
85+
Retrieves information efficiently while preserving interpretability, supporting cross-theme and cross-modal semantic queries and reasoning.
86+
87+
- **Self-Evolving Memory**
88+
A feedback-driven mechanism continuously adapts the memory structure according to real usage patterns.
89+
<img width="1280" height="312" alt="image" src="https://github.com/user-attachments/assets/e2c0ac0c-e5cb-44a9-b880-89be142e1ca5" />
3090

3191
## 🚀Get Started
3292

uv.lock

Lines changed: 2 additions & 2 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)