superlocalmemory 3.0.7 → 3.0.10

package/README.md

@@ -38,8 +38,8 @@ SuperLocalMemory gives AI assistants persistent, structured memory that survives
 
 | Metric | Score | Context |
 |:-------|:-----:|:--------|
+| LoCoMo (Mode C, full power) | **87.7%** | On conv-30, 81 scored questions |
 | LoCoMo (Mode A, zero-LLM) | **62.3%** | Highest zero-LLM score. No cloud dependency. |
-| LoCoMo (Mode C, full) | **~78%** | Competitive with funded systems ($10M+) |
 | Math layer improvement | **+12.7pp** | Average gain from mathematical foundations |
 | Multi-hop improvement | **+12pp** | 50% vs 38% (math on vs off) |
 
@@ -95,6 +95,16 @@ Query  ──►  Strategy Classifier  ──►  4 Parallel Channels:
 
 > All Python dependencies are installed automatically during `npm install`. You don't need to run pip manually. If any dependency fails, the installer shows clear instructions.
 
+### What Gets Installed Automatically
+
+| Component | Size | When |
+|:----------|:-----|:-----|
+| Core math libraries (numpy, scipy, networkx) | ~50MB | During `npm install` |
+| Search engine (sentence-transformers, einops, torch) | ~200MB | During `npm install` |
+| Embedding model (nomic-ai/nomic-embed-text-v1.5) | ~500MB | On first use OR `slm warmup` |
+
+**If any dependency fails during install**, the installer prints the exact `pip install` command to fix it. BM25 keyword search works even without embeddings — you're never fully blocked.
+
 ---
 
 ## Quick Start
@@ -107,15 +117,18 @@ npm install -g superlocalmemory
 
 This single command:
 - Installs the V3 engine and CLI
-- Auto-installs all Python dependencies (numpy, scipy, networkx, sentence-transformers, etc.)
+- Auto-installs all Python dependencies (numpy, scipy, networkx, sentence-transformers, einops, torch, etc.)
 - Creates the data directory at `~/.superlocalmemory/`
 - Detects and guides V2 migration if applicable
 
-Then configure:
+Then configure and pre-download the embedding model:
 ```bash
-slm setup    # Choose mode, configure provider
+slm setup     # Choose mode, configure provider
+slm warmup    # Pre-download embedding model (~500MB, optional)
 ```
 
+> **First time?** If you skip `slm warmup`, the model downloads automatically on first `slm remember` or `slm recall`. Either way works.
+
 ### Install via pip
 
 ```bash
@@ -159,6 +172,27 @@ Add to your IDE's MCP config:
 
 24 MCP tools available: `remember`, `recall`, `search`, `fetch`, `list_recent`, `get_status`, `build_graph`, `switch_profile`, `health`, `consistency_check`, `recall_trace`, and more.
 
+### Web Dashboard (17 tabs)
+
+```bash
+slm dashboard    # Opens at http://localhost:8765
+```
+
+The V3 dashboard provides real-time visibility into your memory system:
+
+- **Dashboard** — Mode switcher, health score, quick store/recall
+- **Recall Lab** — Search with per-channel score breakdown (Semantic, BM25, Entity, Temporal)
+- **Knowledge Graph** — Interactive entity relationship visualization
+- **Memories** — Browse, search, and manage stored memories
+- **Trust Dashboard** — Bayesian trust scores per agent with Beta distribution visualization
+- **Math Health** — Fisher-Rao confidence, Sheaf consistency, Langevin lifecycle state
+- **Compliance** — GDPR export/erasure, EU AI Act status, audit trail
+- **Learning** — Adaptive ranking progress, behavioral patterns, outcome tracking
+- **IDE Connections** — Connected AI tools status and configuration
+- **Settings** — Mode, provider, auto-capture/recall configuration
+
+> The dashboard runs locally at `http://localhost:8765`. No data leaves your machine.
+
 ---
 
 ## V3 Engine Features
@@ -215,7 +249,7 @@ Evaluated on the [LoCoMo benchmark](https://arxiv.org/abs/2402.09714) (Long Conv
 | EverMemOS | 92.3% | Yes | No | No |
 | MemMachine | 91.7% | Yes | No | No |
 | Hindsight | 89.6% | Yes | No | No |
-| **SLM V3 Mode C** | **~78%** | Optional | **Yes** | Partial |
+| **SLM V3 Mode C** | **87.7%** | Optional | **Yes** | Partial |
 | **SLM V3 Mode A** | **62.3%** | **No** | **Yes** | **Yes** |
 | Mem0 ($24M) | 34.2% F1 | Yes | Partial | No |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superlocalmemory",
-  "version": "3.0.7",
+  "version": "3.0.10",
   "description": "Information-geometric agent memory with mathematical guarantees. 4-channel retrieval, Fisher-Rao similarity, zero-LLM mode, EU AI Act compliant. Works with Claude, Cursor, Windsurf, and 17+ AI tools.",
   "keywords": [
     "ai-memory",

package/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "superlocalmemory"
-version = "3.0.0"
+version = "3.0.10"
 description = "Information-geometric agent memory with mathematical guarantees"
 readme = "README.md"
 license = {text = "MIT"}
@@ -22,11 +22,13 @@ dependencies = [
     "python-dateutil>=2.9.0.post0",
     "rank-bm25>=0.2.2",
     "vadersentiment>=3.3.2",
+    "einops>=0.8.2",
 ]
 
 [project.optional-dependencies]
 search = [
     "sentence-transformers>=2.5.0,<4.0.0",
+    "einops>=0.7.0,<1.0.0",
     "torch>=2.2.0",
     "scikit-learn>=1.3.0,<2.0.0",
     "geoopt>=0.5.0",

package/scripts/postinstall.js

@@ -112,15 +112,19 @@ if (pipInstall(coreDeps, 'core')) {
 }
 
 // Search dependencies (IMPORTANT — enables semantic search, 4-channel retrieval)
-const searchDeps = ['sentence-transformers>=2.5.0', 'geoopt>=0.5.0'];
+const searchDeps = ['sentence-transformers>=2.5.0', 'einops>=0.7.0', 'geoopt>=0.5.0'];
 
 console.log('\nInstalling semantic search engine (downloads ~500MB on first use)...');
 if (pipInstall(searchDeps, 'search')) {
-    console.log('✓ Semantic search engine installed (sentence-transformers + Fisher-Rao)');
+    console.log('✓ Semantic search engine installed (sentence-transformers + einops + Fisher-Rao)');
+    console.log('');
+    console.log('  Note: The embedding model (nomic-ai/nomic-embed-text-v1.5, ~500MB)');
+    console.log('  will download automatically on first use (slm remember / slm recall).');
+    console.log('  To pre-download now, run: slm warmup');
 } else {
     console.log('⚠ Semantic search installation failed (BM25 keyword search still works).');
     console.log('  For full 4-channel retrieval, run:');
-    console.log('  pip install sentence-transformers geoopt');
+    console.log('  pip install sentence-transformers einops geoopt');
 }
 
 // --- Step 4: Detect V2 installation ---

package/src/superlocalmemory/cli/commands.py

@@ -29,6 +29,8 @@ def dispatch(args: Namespace) -> None:
         "status": cmd_status,
         "health": cmd_health,
         "trace": cmd_trace,
+        "warmup": cmd_warmup,
+        "dashboard": cmd_dashboard,
         "profile": cmd_profile,
     }
     handler = handlers.get(args.command)
@@ -216,6 +218,78 @@ def cmd_trace(args: Namespace) -> None:
                 print(f"       {ch}: {sc:.3f}")
 
 
+def cmd_warmup(_args: Namespace) -> None:
+    """Pre-download the embedding model so first use is instant."""
+    print("Downloading embedding model (nomic-ai/nomic-embed-text-v1.5)...")
+    print("This is ~500MB and only needed once.\n")
+
+    try:
+        from superlocalmemory.core.config import EmbeddingConfig
+        from superlocalmemory.core.embeddings import EmbeddingService
+
+        config = EmbeddingConfig()
+        svc = EmbeddingService(config)
+
+        # Force model load (triggers download)
+        if svc.is_available:
+            # Verify it works
+            emb = svc.embed("warmup test")
+            if emb and len(emb) == config.dimension:
+                print(f"\nModel ready: {config.model_name} ({config.dimension}-dim)")
+                print("Semantic search is fully operational.")
+            else:
+                print("\nModel loaded but embedding verification failed.")
+                print("Run: pip install sentence-transformers einops")
+        else:
+            print("\nModel could not load.")
+            print("Install dependencies: pip install sentence-transformers einops torch")
+    except ImportError as exc:
+        print(f"\nMissing dependency: {exc}")
+        print("Install with: pip install sentence-transformers einops torch")
+    except Exception as exc:
+        print(f"\nWarmup failed: {exc}")
+        print("Check your internet connection and try again.")
+
+
+def cmd_dashboard(args: Namespace) -> None:
+    """Launch the web dashboard."""
+    try:
+        import uvicorn
+    except ImportError:
+        print("Dashboard requires: pip install 'fastapi[all]' uvicorn")
+        sys.exit(1)
+
+    import socket
+
+    port = getattr(args, "port", 8765)
+
+    def _find_port(preferred: int) -> int:
+        for p in [preferred] + list(range(preferred + 1, preferred + 20)):
+            try:
+                with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+                    s.bind(("127.0.0.1", p))
+                    return p
+            except OSError:
+                continue
+        return preferred
+
+    ui_port = _find_port(port)
+    if ui_port != port:
+        print(f"  Port {port} in use — using {ui_port} instead")
+
+    print("=" * 60)
+    print("  SuperLocalMemory V3 — Web Dashboard")
+    print("=" * 60)
+    print(f"  Dashboard:  http://localhost:{ui_port}")
+    print(f"  API Docs:   http://localhost:{ui_port}/api/docs")
+    print("  Press Ctrl+C to stop\n")
+
+    from superlocalmemory.server.ui import create_app
+
+    app = create_app()
+    uvicorn.run(app, host="127.0.0.1", port=ui_port, log_level="info")
+
+
 def cmd_profile(args: Namespace) -> None:
     """Profile management (list, switch, create)."""
     from superlocalmemory.core.config import SLMConfig

package/src/superlocalmemory/cli/main.py

@@ -67,6 +67,15 @@ def main() -> None:
     trace_p = sub.add_parser("trace", help="Recall with channel breakdown")
     trace_p.add_argument("query", help="Search query")
 
+    # Warmup (pre-download model)
+    sub.add_parser("warmup", help="Pre-download embedding model (~500MB)")
+
+    # Dashboard
+    dashboard_p = sub.add_parser("dashboard", help="Open web dashboard")
+    dashboard_p.add_argument(
+        "--port", type=int, default=8765, help="Port (default 8765)",
+    )
+
     # Profiles
     profile_p = sub.add_parser("profile", help="Profile management")
     profile_p.add_argument(

package/src/superlocalmemory/server/ui.py

@@ -17,10 +17,13 @@ All route handlers live in routes/ directory:
     routes/ws.py        -- /ws/updates (WebSocket)
 """
 
+import logging
 import sys
 from pathlib import Path
 from datetime import datetime
 
+logger = logging.getLogger(__name__)
+
 _script_dir = str(Path(__file__).parent.resolve())
 sys.path = [p for p in sys.path if p not in ("", _script_dir)]
 
@@ -193,7 +196,20 @@ def create_app() -> FastAPI:
 
     @application.on_event("startup")
     async def startup_event():
-        """Register Event Bus listener for SSE bridge on startup."""
+        """Initialize V3 engine and event bus on startup."""
+        # Initialize V3 engine for dashboard API routes
+        try:
+            from superlocalmemory.core.config import SLMConfig
+            from superlocalmemory.core.engine import MemoryEngine
+            config = SLMConfig.load()
+            engine = MemoryEngine(config)
+            engine.initialize()
+            application.state.engine = engine
+            logger.info("V3 engine initialized for dashboard")
+        except Exception as exc:
+            logger.warning("V3 engine init failed: %s (V3 API routes will be unavailable)", exc)
+            application.state.engine = None
+
         register_event_listener()
 
     return application

package/src/superlocalmemory/storage/v2_migrator.py

@@ -329,6 +329,32 @@ class V2Migrator:
             except Exception as exc:
                 stats["steps"].append(f"V2 conversion partial: {exc}")
 
+            # Step 4c: Create views for V2 dashboard compatibility
+            try:
+                v2_views = {
+                    "graph_nodes": "_v2_bak_graph_nodes",
+                    "graph_clusters": "_v2_bak_graph_clusters",
+                    "sessions": "_v2_bak_sessions",
+                    "memory_events": "_v2_bak_memory_events",
+                    "identity_patterns": "_v2_bak_identity_patterns",
+                    "pattern_examples": "_v2_bak_pattern_examples",
+                    "creator_metadata": "_v2_bak_creator_metadata",
+                    "agent_registry": "_v2_bak_agent_registry",
+                }
+                view_count = 0
+                for view_name, source in v2_views.items():
+                    try:
+                        conn.execute(f'SELECT 1 FROM "{source}" LIMIT 1')
+                        conn.execute(f'DROP VIEW IF EXISTS "{view_name}"')
+                        conn.execute(f'CREATE VIEW "{view_name}" AS SELECT * FROM "{source}"')
+                        view_count += 1
+                    except Exception:
+                        pass
+                conn.commit()
+                stats["steps"].append(f"Created {view_count} V2 compatibility views")
+            except Exception:
+                pass
+
             conn.close()
             stats["steps"].append("Created V3 schema")
 

package/src/superlocalmemory.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: superlocalmemory
-Version: 3.0.0
+Version: 3.0.8
 Summary: Information-geometric agent memory with mathematical guarantees
 Author-email: Varun Pratap Bhardwaj <admin@superlocalmemory.com>
 License: MIT
@@ -22,8 +22,10 @@ Requires-Dist: mcp>=1.0.0
 Requires-Dist: python-dateutil>=2.9.0.post0
 Requires-Dist: rank-bm25>=0.2.2
 Requires-Dist: vadersentiment>=3.3.2
+Requires-Dist: einops>=0.8.2
 Provides-Extra: search
 Requires-Dist: sentence-transformers<4.0.0,>=2.5.0; extra == "search"
+Requires-Dist: einops<1.0.0,>=0.7.0; extra == "search"
 Requires-Dist: torch>=2.2.0; extra == "search"
 Requires-Dist: scikit-learn<2.0.0,>=1.3.0; extra == "search"
 Requires-Dist: geoopt>=0.5.0; extra == "search"
@@ -83,8 +85,8 @@ SuperLocalMemory gives AI assistants persistent, structured memory that survives
 
 | Metric | Score | Context |
 |:-------|:-----:|:--------|
+| LoCoMo (Mode C, full power) | **87.7%** | On conv-30, 81 scored questions |
 | LoCoMo (Mode A, zero-LLM) | **62.3%** | Highest zero-LLM score. No cloud dependency. |
-| LoCoMo (Mode C, full) | **~78%** | Competitive with funded systems ($10M+) |
 | Math layer improvement | **+12.7pp** | Average gain from mathematical foundations |
 | Multi-hop improvement | **+12pp** | 50% vs 38% (math on vs off) |
 
@@ -130,13 +132,35 @@ Query  ──►  Strategy Classifier  ──►  4 Parallel Channels:
 
 ---
 
+## Prerequisites
+
+| Requirement | Version | Why |
+|:-----------|:--------|:----|
+| **Node.js** | 14+ | npm package manager |
+| **Python** | 3.11+ | V3 engine runtime |
+| **pip** | Latest | Python dependency installer |
+
+> All Python dependencies are installed automatically during `npm install`. You don't need to run pip manually. If any dependency fails, the installer shows clear instructions.
+
+---
+
 ## Quick Start
 
-### Install via npm (recommended)
+### Install via npm (recommended — one command, everything included)
 
 ```bash
 npm install -g superlocalmemory
-slm setup
+```
+
+This single command:
+- Installs the V3 engine and CLI
+- Auto-installs all Python dependencies (numpy, scipy, networkx, sentence-transformers, etc.)
+- Creates the data directory at `~/.superlocalmemory/`
+- Detects and guides V2 migration if applicable
+
+Then configure:
+```bash
+slm setup    # Choose mode, configure provider
 ```
 
 ### Install via pip
@@ -182,6 +206,27 @@ Add to your IDE's MCP config:
 
 24 MCP tools available: `remember`, `recall`, `search`, `fetch`, `list_recent`, `get_status`, `build_graph`, `switch_profile`, `health`, `consistency_check`, `recall_trace`, and more.
 
+### Web Dashboard (17 tabs)
+
+```bash
+slm dashboard    # Opens at http://localhost:8765
+```
+
+The V3 dashboard provides real-time visibility into your memory system:
+
+- **Dashboard** — Mode switcher, health score, quick store/recall
+- **Recall Lab** — Search with per-channel score breakdown (Semantic, BM25, Entity, Temporal)
+- **Knowledge Graph** — Interactive entity relationship visualization
+- **Memories** — Browse, search, and manage stored memories
+- **Trust Dashboard** — Bayesian trust scores per agent with Beta distribution visualization
+- **Math Health** — Fisher-Rao confidence, Sheaf consistency, Langevin lifecycle state
+- **Compliance** — GDPR export/erasure, EU AI Act status, audit trail
+- **Learning** — Adaptive ranking progress, behavioral patterns, outcome tracking
+- **IDE Connections** — Connected AI tools status and configuration
+- **Settings** — Mode, provider, auto-capture/recall configuration
+
+> The dashboard runs locally at `http://localhost:8765`. No data leaves your machine.
+
 ---
 
 ## V3 Engine Features
@@ -238,7 +283,7 @@ Evaluated on the [LoCoMo benchmark](https://arxiv.org/abs/2402.09714) (Long Conv
 | EverMemOS | 92.3% | Yes | No | No |
 | MemMachine | 91.7% | Yes | No | No |
 | Hindsight | 89.6% | Yes | No | No |
-| **SLM V3 Mode C** | **~78%** | Optional | **Yes** | Partial |
+| **SLM V3 Mode C** | **87.7%** | Optional | **Yes** | Partial |
 | **SLM V3 Mode A** | **62.3%** | **No** | **Yes** | **Yes** |
 | Mem0 ($24M) | 34.2% F1 | Yes | Partial | No |
 

package/src/superlocalmemory.egg-info/requires.txt

@@ -6,6 +6,7 @@ mcp>=1.0.0
 python-dateutil>=2.9.0.post0
 rank-bm25>=0.2.2
 vadersentiment>=3.3.2
+einops>=0.8.2
 
 [dev]
 pytest>=8.0
@@ -23,6 +24,7 @@ orjson<4.0.0,>=3.9.0
 
 [search]
 sentence-transformers<4.0.0,>=2.5.0
+einops<1.0.0,>=0.7.0
 torch>=2.2.0
 scikit-learn<2.0.0,>=1.3.0
 geoopt>=0.5.0

package/ui/index.html

@@ -18,15 +18,17 @@
             --slm-gradient-warning: linear-gradient(135deg, #f093fb 0%, #f5576c 100%);
         }
 
-        body {
-            font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
-            overflow-y: scroll;  /* Always show scrollbar to prevent layout shift */
-        }
-
         html {
             scroll-behavior: smooth;
         }
 
+        body {
+            font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
+            overflow-x: auto;
+            overflow-y: scroll;
+            min-width: min-content;
+        }
+
         [data-bs-theme="light"] body,
         [data-bs-theme="light"] {
             background: #f8f9fa;
@@ -77,11 +79,13 @@
 
         .tab-content {
             min-height: 700px;
-            overflow: visible;
+            overflow-x: auto;
+            overflow-y: visible;
         }
 
         .tab-pane {
-            overflow: visible;
+            overflow-x: auto;
+            overflow-y: visible;
         }
 
         #graph-container {
@@ -698,7 +702,7 @@
         </div>
 
         <!-- Main Content Tabs -->
-        <ul class="nav nav-tabs mb-3" id="mainTabs" role="tablist">
+        <ul class="nav nav-tabs flex-wrap mb-3" id="mainTabs" role="tablist">
             <li class="nav-item">
                 <button class="nav-link active" id="dashboard-tab" data-bs-toggle="tab" data-bs-target="#dashboard-pane">
                     <i class="bi bi-speedometer2"></i> Dashboard

package/ui/js/recall-lab.js

@@ -54,7 +54,26 @@ document.getElementById('recall-lab-search')?.addEventListener('click', function
             var maxChannel = Math.max(channels.semantic || 0, channels.bm25 || 0, channels.entity_graph || 0, channels.temporal || 0) || 1;
 
             var item = document.createElement('div');
-            item.className = 'list-group-item';
+            item.className = 'list-group-item list-group-item-action';
+            item.style.cursor = 'pointer';
+            item.title = 'Click to view full memory';
+            (function(result) {
+                item.addEventListener('click', function() {
+                    if (typeof openMemoryDetail === 'function') {
+                        openMemoryDetail({
+                            id: result.fact_id,
+                            content: result.content,
+                            score: result.score,
+                            importance: Math.round((result.confidence || 0.5) * 10),
+                            category: 'recall',
+                            tags: Object.keys(result.channel_scores || {}).join(', '),
+                            created_at: null,
+                            trust_score: result.trust_score,
+                            channel_scores: result.channel_scores
+                        });
+                    }
+                });
+            })(r);
 
             var header = document.createElement('h6');
             header.className = 'mb-1';