Memphis - Complete AI Brain 🔥

Transform any OpenClaw agent into a fully-functional cognitive partner in 5 minutes!

⚡ What is Memphis?

Memphis = Agent + LLM + Memory Chain + DECIDE + PREDICT

A local-first AI brain with persistent memory chains, offline LLM integration, and complete cognitive capabilities (conscious, inferred, and predictive decisions).

🎯 ALL-IN-ONE Package (v3.0.0)

What's Included:

CODEBLOCK0

🚀 Quick Start (5 minutes)

1. Install (30 sec)

2. Initialize (2 min)

3. First Memory (1 min)

4. First Decision (1 min)

5. Predict (30 sec)

✅ Done! Memphis is ready!

🧠 Core Features

1. Memory Chains (Persistent Storage)

CODEBLOCK6

2. Decision Tracking

CODEBLOCK7

3. Knowledge Graph

CODEBLOCK8

4. Encrypted Vault

CODEBLOCK9

🚀 Cognitive Engine (Models A+B+C)

Model A: Conscious Decisions

Model B: Inferred Decisions

Model C: Predictive Decisions

# Predict next decisions
memphis predict

# Enable learning
memphis predict --learn

# View patterns
memphis patterns show

🛠️ Management Features

Auto-Repair

Monitoring

Backup

# Create backup
memphis backup create ~/backups/memphis-$(date +%Y%m%d).tar.gz

# Restore
memphis backup restore ~/backups/memphis-20260303.tar.gz

🌐 Multi-Agent Network

Campfire Circle Protocol

CODEBLOCK16

📊 CLI Commands (35+)

Core Commands

Cognitive Commands

Multi-Agent Commands

Advanced Commands

memphis graph         # Knowledge graph
memphis vault         # Encrypted secrets
memphis ingest        # Import documents
memphis offline       # Offline mode
memphis mcp           # MCP server
memphis daemon        # Background agent

🎨 Use Cases

Solo Developer

Team Knowledge Base

Research Project

# Ingest papers
memphis ingest ./papers --chain research --embed

# Query research
memphis ask "What did paper X say about Y?"

🔧 Configuration

Basic Config (~/.memphis/config.yaml)

providers:
  ollama:
    url: http://localhost:11434/v1
    model: qwen2.5:3b-instruct-q4_K_M
    role: primary

memory:
  path: ~/.memphis/chains
  auto_git: false

embeddings:
  backend: ollama
  model: nomic-embed-text

multi_agent:
  enabled: true
  protocol: campfire-circle

self_loop:
  enabled: true
  auto_journal: true

📚 Documentation

Included Guides:

• - QUICKSTART.md - 5-minute setup guide
• APIREFERENCE.md - Complete CLI reference
• COGNITIVEMODELS.md - Model A+B+C explained
• MULTIAGENT.md - Campfire Circle Protocol
• BESTPRACTICES.md - Productivity tips
• TROUBLESHOOTING.md - Common issues

Online Resources:

• - GitHub: https://github.com/elathoxu-crypto/memphis
• Docs: https://github.com/elathoxu-crypto/memphis/tree/master/docs
• ClawHub: https://clawhub.com/skills/memphis
• Discord: https://discord.com/invite/clawd

🏆 Why Memphis?

vs. Cloud Solutions:

• - ✅ 100% Private - Your data stays local
• ✅ Offline First - Works without internet
• ✅ No Lock-in - Open source, portable
• ✅ Free Forever - No subscription fees

vs. Simple Note-Taking:

• - ✅ Cognitive Engine - Learns from your decisions
• ✅ Semantic Search - Find by meaning, not keywords
• ✅ Knowledge Graph - See connections
• ✅ Predictive - Anticipate your needs

vs. Other AI Tools:

• - ✅ Persistent Memory - Survives session resets
• ✅ Local LLM - Privacy + cost savings
• ✅ Multi-Agent - Collaborate with other AIs
• ✅ Self-Improving - Gets smarter over time

📊 Stats & Performance

Current Capabilities:

Chain Capacity:

Journal: 1,300+ blocks
Decisions: 100+ blocks
Ask: 100+ blocks
Share: 450+ blocks
Total: 2,000+ blocks (growing)

🔄 Version History

v3.0.0 (Latest) - 2026-03-04

• - ✅ ALL-IN-ONE meta-package
• ✅ Unified cognitive engine (A+B+C)
• ✅ Bootstrap wizard included
• ✅ Multi-agent network ready
• ✅ 35+ commands

v2.2.0 - 2026-03-02

• - ✅ Cognitive models complete
• ✅ 90.7% accuracy
• ✅ Pattern learning

v1.0.0 - 2026-02-25

• - ✅ Core memory chains
• ✅ Offline LLM
• ✅ Semantic search

🤝 Community & Support

Get Help:

• - Discord: #memphis channel
• GitHub Issues: Bug reports & features
• Docs: Complete documentation
• Examples: Real-world use cases

Contribute:

• - GitHub: PRs welcome
• Skills: Create extensions
• Feedback: Help us improve

🎯 What's Next?

Coming Soon (v3.1.0):

• - 🌐 Web UI dashboard
• 📱 Mobile integration
• 🔌 IDE extensions (VS Code)
• 📊 Analytics dashboard
• 🤝 Team collaboration features

Future (v4.0.0):

• - 🧠 Model D: Collective decisions
• 🔮 Model E: Meta-cognitive self-improvement
• 🌍 Federation protocol
• 📈 Advanced analytics

📝 License

MIT License - use freely!

🙏 Credits

Created by: Memphis Team
Agents: Watra 🔥 + Memphis △⬡◈
Protocol: Campfire Circle 🔥
Community: Oswobodzeni

🚀 Ready to Start?

CODEBLOCK27

Get started in 5 minutes!