memu-py 1.0.0

AI Memory and Conversation Management Framework - Simple as mem0, Powerful as MemU

MemU

A Future-Oriented Agentic Memory System

---

MemU is an agentic memory framework for LLM and AI agent backends. It receives multimodal inputs (conversations, documents, images), extracts them into structured memory, and organizes them into a hierarchical file system that supports both embedding-based (RAG) and non-embedding (LLM) retrieval.

---

MemU is collaborating with four open-source projects to launch the 2026 New Year Challenge. 🎉Between January 8–18, contributors can submit PRs to memU and earn cash rewards, community recognition, and platform credits. 🎁Join the community here: https://discord.gg/KaWy6SBAsx

✨ Core Features

Feature	Description
🗂️ Hierarchical File System	Three-layer architecture: Resource → Item → Category with full traceability
🔍 Dual Retrieval Methods	RAG (embedding-based) for speed, LLM (non-embedding) for deep semantic understanding
🎨 Multimodal Support	Process conversations, documents, images, audio, and video
🔄 Self-Evolving Memory	Memory structure adapts and improves based on usage patterns

---

🗂️ Hierarchical File System

MemU organizes memory using a three-layer architecture inspired by hierarchical storage systems:

Layer	Description	Examples
Resource	Raw multimodal data warehouse	JSON conversations, text documents, images, videos
Item	Discrete extracted memory units	Individual preferences, skills, opinions, habits
Category	Aggregated textual memory with summaries	preferences.md, work_life.md, relationships.md

Key Benefits:

• Full Traceability: Track from raw data → items → categories and back
• Progressive Summarization: Each layer provides increasingly abstracted views
• Flexible Organization: Categories evolve based on content patterns

---

🎨 Multimodal Support

MemU processes diverse content types into unified memory:

Modality	Input	Processing
conversation	JSON chat logs	Extract preferences, opinions, habits, relationships
document	Text files (.txt, .md)	Extract knowledge, skills, facts
image	PNG, JPG, etc.	Vision model extracts visual concepts and descriptions
video	Video files	Frame extraction + vision analysis
audio	Audio files	Transcription + text processing

All modalities are unified into the same three-layer hierarchy, enabling cross-modal retrieval.

---

🚀 Quick Start

Option 1: Cloud Version

Try MemU instantly without any setup:

👉 memu.so - Hosted cloud service with full API access

For enterprise deployment and custom solutions, contact [e-mail]

Cloud API (v3)

Base URL	https://api.memu.so
Auth	Authorization: Bearer YOUR_API_KEY

Method	Endpoint	Description
POST	/api/v3/memory/memorize	Register a memorization task
GET	/api/v3/memory/memorize/status/{task_id}	Get task status
POST	/api/v3/memory/categories	List memory categories
POST	/api/v3/memory/retrieve	Retrieve memories (semantic search)

📚 Full API Documentation

---

Option 2: Self-Hosted