💡 Why DeepBrain?

Memory solutions like Mem0 store facts. DeepBrain evolves knowledge.

DeepBrain is a standalone, embeddable knowledge engine that gives any AI agent long-term, self-evolving memory — in 3 lines of code, with zero dependencies.

✨ Key Features

• 🏗️ 6-Layer Memory Architecture — From flash memory to meta-knowledge, just like the human brain
• 🚪 4-Gate Quality Control — Every piece of knowledge passes Relevance → Novelty → Consistency → Utility gates
• 📦 Zero Dependencies — Pure Python stdlib. No numpy, no torch, no API keys
• 💾 100% Local — SQLite storage. Your knowledge never leaves your machine
• 🔌 Embeddable — Drop into any Python agent framework in 3 lines
• 🔄 Auto-Evolution — Knowledge automatically promotes, consolidates, and archives

🚀 Quick Start

pip install opc-deepbrain

from opc_deepbrain import DeepBrain

# Initialize
brain = DeepBrain("./my_brain.db")

# Learn
brain.learn("User prefers concise, technical answers", source="conversation")

# Recall
results = brain.recall("What communication style does the user prefer?")
print(results[0].content)  # → "User prefers concise, technical answers"

That's it. No API keys. No config. No cloud. 3 lines to persistent, evolving memory.

🏗️ 6-Layer Memory Architecture

┌─────────────────────────────────────────────────┐
│  Layer 5: 🔮 Meta-Knowledge                     │
│  "I know that I know X well, but Y is uncertain"│
├─────────────────────────────────────────────────┤
│  Layer 4: 🗄️ Archived                           │
│  Historical reference, low-access but preserved  │
├─────────────────────────────────────────────────┤
│  Layer 3: 🏗️ Consolidated                       │
│  Cross-session patterns, validated over time     │
├─────────────────────────────────────────────────┤
│  Layer 2: 📚 Long-Term                          │
│  Validated knowledge, frequently accessed        │
├─────────────────────────────────────────────────┤
│  Layer 1: 📝 Short-Term                         │
│  Recent interactions, hours to days              │
├─────────────────────────────────────────────────┤
│  Layer 0: ⚡ Flash Memory                        │
│  Current session buffer, minutes                 │
└─────────────────────────────────────────────────┘
         ↑ Auto-promotion based on relevance,
           frequency, and validation scores

How Knowledge Evolves

1. Ingestion → New knowledge enters Layer 0 (Flash)
2. 4-Gate Check → Relevance, Novelty, Consistency, Utility scoring
3. Promotion → High-quality knowledge moves up layers over time
4. Consolidation → Related facts merge into coherent understanding
5. Meta-Learning → The system learns its own knowledge strengths/gaps

🚪 4-Gate Quality Control

Every piece of knowledge must pass through 4 gates:

📖 API Reference

Core API

from opc_deepbrain import DeepBrain

brain = DeepBrain(db_path="./brain.db")

# Learn — store knowledge
brain.learn(
    content="FastAPI is preferred over Flask for new projects",
    source="architecture-review",
    category="tech-decisions",
    tags=["python", "web", "architecture"]
)

# Recall — retrieve relevant knowledge
results = brain.recall(
    query="Which web framework should we use?",
    top_k=5,
    min_score=0.3
)

# Search — keyword search
results = brain.search("FastAPI", category="tech-decisions")

# Stats — memory statistics
stats = brain.stats()
print(f"Total entries: {stats['total']}")
print(f"By layer: {stats['by_layer']}")

# Evolve — trigger manual evolution cycle
brain.evolve()

# Export / Import
brain.export("backup.json")
brain.load("backup.json")

Embedding in Your Agent

# Works with any agent framework
class MyAgent:
    def __init__(self):
        self.brain = DeepBrain("./agent_brain.db")

    def chat(self, user_message):
        # Recall relevant context
        context = self.brain.recall(user_message, top_k=3)

        # Generate response (your LLM call here)
        response = self.llm.generate(user_message, context=context)

        # Learn from the interaction
        self.brain.learn(
            f"User asked about: {user_message}",
            source="conversation"
        )

        return response

⚖️ Comparison / 对比

🔌 Integrations

DeepBrain powers memory in:

• OPC Agent — Local AI agent
• Leaper Agent — Global agent framework
• Leaper Agent CN — China-optimized agent
• Your project — pip install opc-deepbrain and go

📄 License

BSL-1.1 — see LICENSE for details.

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md.

📧 Contact: tech@deepleaper.com