Skip to content
Varun Pratap Bhardwaj edited this page Feb 12, 2026 · 38 revisions

SuperLocalMemory V2

SuperLocalMemory V2

Your AI Finally Remembers You
The only free, local-first AI memory system with universal architecture

🌐 Official Website⭐ Star on GitHub☕ Buy Me a Coffee💸 PayPal


Visual Overview

SuperLocalMemory V2 Features All SuperLocalMemory V2 features at a glance: Dashboard, CLI, Live Events, Agents, Knowledge Graph


NEW: v2.5.0 — "Your AI Memory Has a Heartbeat"

SuperLocalMemory is no longer passive storage — it's a real-time coordination layer.

Every memory write triggers events. Agents are tracked. Trust is scored. The dashboard is live.

Feature Benefit
Real-Time Event Stream See memory operations live in the dashboard (SSE-powered)
No More "Database Locked" WAL mode + write queue — 50 concurrent agents, zero errors
Agent Tracking Know which AI tool wrote what — auto-registered on connect
Trust Scoring Bayesian signals detect spam and cross-agent validation
Memory Provenance Who created it, via which protocol, full lineage
28 API Endpoints Modular FastAPI routes across 8 files

Upgrade: npm install -g superlocalmemory@latest

Architecture V2.5 | Roadmap | Full Changelog


🎯 What is SuperLocalMemory?

SuperLocalMemory V2 is an intelligent ai memory system that makes AI assistants like Claude, Cursor, and other mcp-server compatible tools remember everything about you and your projects. Created by Varun Pratap Bhardwaj, this local-first memory solution is the perfect alternative to Mem0 and Zep. Unlike cloud-based alternatives like Mem0 ($50+/mo) or Zep ($50/mo), SuperLocalMemory is:

  • 100% Local — Your data never leaves your machine
  • 100% Free — No usage limits, no credit systems, forever
  • 100% Private — GDPR/HIPAA compliant by default
  • Works Everywhere — 16+ IDEs including Claude Desktop, Cursor IDE, Windsurf, VS Code, and more
  • Dual Protocol — MCP (agent→tool) + A2A (agent↔agent) support

Key Features in Action

🎯 Real-Time Memory Operations

Live Events

🔍 Intelligent Search

Hybrid Search

🕸️ Knowledge Graph

Interactive Graph

💻 Simple CLI

CLI Demo


Video Walkthroughs


📚 Documentation

Getting Started

Guide Description
Installation 5-minute setup for Mac, Linux, Windows
Quick-Start-Tutorial Your first memory in 2 minutes
CLI-Cheatsheet Copy-paste command reference

Core Concepts

Guide Description
Universal-Architecture 10-layer universal architecture with MCP + A2A integration
MCP-Integration Model Context Protocol support for 16+ IDEs
Universal-Skills 6 agent skills and slash-commands system
Knowledge-Graph-Guide Auto-discovery of relationships
Pattern-Learning-Explained How it learns your coding style
Multi-Profile-Workflows Separate contexts for work/personal/clients

Reference

Guide Description
CLI-Cheatsheet Quick command reference
Python-API Programmatic access
Configuration Customization options
CHANGELOG Version history and release notes

Comparisons

Guide Description
Comparison-Deep-Dive Detailed comparison with Mem0, Zep, Personal.AI
Why-Local-Matters Privacy, GDPR, and local-first benefits

Community

Guide Description
FAQ Frequently asked questions
Roadmap Version history and planned features
Troubleshooting Common issues and solutions
Contributing How to contribute
Issues Report bugs or request features

🏆 Why SuperLocalMemory?

The Problem

Every Claude session:

You: "Remember that auth bug we fixed?"
Claude: "I don't have access to previous conversations..."
You: *sighs and re-explains everything*

The Solution

# Save once
superlocalmemoryv2:remember "Fixed auth bug - JWT tokens expiring too fast"

# Recall forever
superlocalmemoryv2:recall "auth bug"
# ✓ Found: "Fixed auth bug - JWT tokens expiring too fast"

🆚 Alternative to Mem0 and Zep

Feature Mem0 Zep Personal.AI SuperLocalMemory V2
Price Usage-based $50/mo $33/mo $0 forever
Local-First ❌ Cloud ❌ Cloud ❌ Cloud ✅ 100%
IDE Support Limited 1-2 None ✅ 16+ IDEs
Universal Architecture ✅ MCP + Skills + CLI
MCP Integration ✅ Native
A2A Protocol 🔜 v2.5.0
Pattern Learning Partial ✅ Full
Knowledge Graphs ✅ Leiden Clustering
Zero Setup ✅ 5-min install

SuperLocalMemory V2 is the ONLY solution with universal IDE support, full local operation, and zero cost. Created by Varun Pratap Bhardwaj as an open-source alternative to expensive cloud services.


🚀 Quick Install

# Mac/Linux
git clone https://github.com/varun369/SuperLocalMemoryV2.git
cd SuperLocalMemoryV2 && ./install.sh

# Windows
git clone https://github.com/varun369/SuperLocalMemoryV2.git
cd SuperLocalMemoryV2; .\install.ps1

That's it. No Docker. No API keys. No cloud accounts.

Full installation guide →


🔬 Built on Research

SuperLocalMemory implements cutting-edge 2026 research:

Research Source Implementation
PageIndex VectifyAI (Zhang et al., Sep 2025) Hierarchical memory indexing
GraphRAG Microsoft (Edge et al., 2024, arXiv:2404.16130) Knowledge graph clustering
MemoryBank Zhong et al., AAAI 2024 (arXiv:2305.10250) Long-term memory for LLM agents
MACLA Forouzandeh et al., Dec 2025 (arXiv:2512.18950) Multi-agent collaborative learning
Hindsight Latimer et al., Dec 2025 (arXiv:2512.12818) Retrospective identity pattern learning
A-RAG arXiv:2602.03442 Multi-level retrieval

Note: PageIndex attribution corrected from "Meta AI" to VectifyAI (Mingtian Zhang et al., Sep 2025). "xMemory (Stanford)" was a non-existent paper reference and has been replaced with three published research papers: MemoryBank, MACLA, and Hindsight.

The only open-source implementation combining all these research approaches.


👨‍💻 Creator

Created by Varun Pratap Bhardwaj — Solution Architect & Original Creator

GitHub

Building open-source tools that make AI assistants actually useful for developers. SuperLocalMemory V2.3.0 brings universal integration to 16+ IDEs while maintaining 100% local-first privacy.


💖 Support the Project

If SuperLocalMemory saves you time:


100% local. 100% private. 100% yours.
Created by Varun Pratap Bhardwaj


🌐 Official Website: varun369.github.io/SuperLocalMemoryV2 📦 NPM Package: npmjs.com/package/superlocalmemory 📖 Documentation: GitHub Wiki 💬 Support: GitHub Issues

Clone this wiki locally