memu-py 0.1.8

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

MemU: The Next-Gen Memory Framework for AI Companions

MemU is an open-source memory framework for AI companions—high accuracy, fast retrieval, low cost. It acts as an intelligent "memory folder" that adapts to different AI companion scenarios.

With memU, you can build AI companions that truly remember you. They learn who you are, what you care about, and grow alongside you through every interaction.

Visit our homepage: memu.pro

🥇 92% Accuracy - 💰 90% Cost Reduction - 🤖 AI Companion Specialized

• ✅ AI Companion Specialization - Adapt to AI companions application
• ✅ 92% Accuracy - State-of-the-art score in Locomo benchmark
• ✅ Up to 90% Cost Reduction - Through optimized online platform
• ✅ Advanced Retrieval Strategies - Multiple methods including semantic search, hybrid search, contextual retrieval
• ✅ 24/7 Support - For enterprise customers

---

⭐ Star Us on GitHub

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

💬 Join our Discord community: https://discord.gg/memu

---

🚀Get Started

There are three ways to get started with MemU:

☁️ Cloud Version (Online Platform)

The fastest way to integrate your application with memU. Perfect for teams and individuals who want immediate access without setup complexity. We host the models, APIs, and cloud storage, ensuring your application gets the best quality AI memory.

• Instant Access - Start integrating AI memories in minutes
• Managed Infrastructure - We handle scaling, updates, and maintenance for optimal memory quality
• Premium Support - Subscribe and get priority assistance from our engineering team

Step-by-step

Step 1: Create account

Create account on https://app.memu.so

Then, go to https://app.memu.so/api-key/ for generating api-keys.

Step 2: Add three lines to your code

pip install memu-py

# Example usage
from memu import MemuClient

Step 3: Quick Start

# Initialize
memu_client = MemuClient(
    base_url="https://api.memu.so", 
    api_key=os.getenv("MEMU_API_KEY")
)
memu_client.memorize_conversation(
    conversation=conversation_text, # Recommend longer conversation (~8000 tokens), see https://memu.pro/blog/memu-best-practice for details
    user_id="user001", 
    user_name="User", 
    agent_id="assistant001", 
    agent_name="Assistant"
)

Check API reference or our blog for more details.

📖 See example/client/memory.py for complete integration details

✨ That's it! MemU remembers everything and helps your AI learn from past conversations.

🏢 Enterprise Edition

For organizations requiring maximum security, customization, control and best quality:

• Commercial License - Full proprietary features, commercial usage rights, white-labeling options
• Custom Development - SSO/RBAC integration, dedicated algorithm team for scenario-specific framework optimization
• Intelligence & Analytics - User behavior analysis, real-time production monitoring, automated agent optimization
• Premium Support - 24/7 dedicated support, custom SLAs, professional implementation services

📧 Enterprise Inquiries: [e-mail]

🏠 Self-Hosting (Community Edition)

For users and developers who prefer local control, data privacy, or customization:

• Data Privacy - Keep sensitive data within your infrastructure
• Customization - Modify and extend the platform to fit your needs
• Cost Control - Avoid recurring cloud fees for large-scale deployments

See self hosting README

---

✨ Key Features

🎥 Demo Video

Click to watch the MemU demonstration video

---

Memory as file system

Organize - Autonomous Memory File Management

Your memories are structured as intelligent folders managed by a memory agent. We do not do explicit modeling for memories. The memory agent automatically decides what to record, modify, or archive. Think of it as having a personal librarian who knows exactly how to organize your thoughts.

Link - Interconnected Knowledge Graph

Memories don't exist in isolation. Our system automatically creates meaningful connections between related memories, building a rich network of hyperlinked documents and transforming memory discovery from search into effortless recall.

Evolve - Continuous Self-Improvement

Even when offline, your memory agent keeps working. It generates new insights by analyzing existing memories, identifies patterns, and creates summary documents through self-reflection. Your knowledge base becomes smarter over time, not just larger.

Never Forget - Adaptive Forgetting Mechanism

The memory agent automatically prioritizes information based on usage patterns. Recently accessed memories remain highly accessible, while less relevant content is deprioritized or forgotten. This creates a personalized information hierarchy that evolves with your needs.

---

😺 Advantages

Higher Memory Accuracy

MemU achieves 92.09% average accuracy in Locomo dataset across all reasoning tasks, significantly outperforming competitors. Technical Report will be published soon!

(1) Single-hop questions require answers based on a single session; (2) Multi-hop questions require synthesizing information from multiple different sessions; (3) Temporal reasoning questions can be answered through temporal reasoning and capturing time-related data cues within the conversation; (4) Open-domain knowledge questions can be answered by integrating a speaker’s provided information with external knowledge such as commonsense or world facts;

Fast Retrieval

We categorize important information into documents, and during retrieval, we only need to find the relevant document content, eliminating the need for extensive embedding searches for fragmented sentences.

Low cost

We can process hundreds of conversation turns at once, eliminating the need for developers to repeatedly call memory functions, thus saving users from wasting tokens on multiple memory operations. See best practice.

---

🎓 Use Cases

AI Companion	AI Role Play	AI IP Characters	AI Education
AI Therapy	AI Robot	AI Creation	More...

---

🤝 Contributing

We build trust through open-source collaboration. Your creative contributions drive memU's innovation forward. Explore our GitHub issues and projects to get started and make your mark on the future of memU.

📋 Read our detailed Contributing Guide →

📄 License

By contributing to MemU, you agree that your contributions will be licensed under the Apache License 2.0.

---

🌍 Community

For more information please contact [e-mail]

• GitHub Issues: Report bugs, request features, and track development. Submit an issue

• Discord: Get real-time support, chat with the community, and stay updated. Join us

• X (Twitter): Follow for updates, AI insights, and key announcements. Follow us