superlocalmemory 3.0.10 → 3.0.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +15 -0
- package/bin/slm.bat +14 -184
- package/bin/slm.cmd +2 -7
- package/docs/api-reference.md +1 -1
- package/docs/migration-from-v2.md +4 -4
- package/docs/v2-archive/ARCHITECTURE.md +1 -1
- package/docs/v2-archive/CLI-COMMANDS-REFERENCE.md +35 -35
- package/docs/v2-archive/COMPRESSION-README.md +23 -23
- package/docs/v2-archive/FRAMEWORK-INTEGRATIONS.md +2 -2
- package/docs/v2-archive/MCP-MANUAL-SETUP.md +10 -10
- package/docs/v2-archive/MCP-TROUBLESHOOTING.md +29 -29
- package/docs/v2-archive/PATTERN-LEARNING.md +2 -2
- package/docs/v2-archive/PROFILES-GUIDE.md +52 -52
- package/docs/v2-archive/RESET-GUIDE.md +36 -36
- package/docs/v2-archive/UI-SERVER.md +2 -2
- package/docs/v2-archive/UNIVERSAL-INTEGRATION.md +3 -3
- package/docs/v2-archive/V2.2.0-OPTIONAL-SEARCH.md +2 -2
- package/ide/configs/antigravity-mcp.json +5 -7
- package/ide/configs/claude-desktop-mcp.json +3 -7
- package/ide/configs/codex-mcp.toml +2 -4
- package/ide/configs/continue-mcp.yaml +2 -3
- package/ide/configs/cursor-mcp.json +3 -7
- package/ide/configs/gemini-cli-mcp.json +6 -6
- package/ide/configs/jetbrains-mcp.json +6 -6
- package/ide/configs/opencode-mcp.json +5 -7
- package/ide/configs/perplexity-mcp.json +6 -6
- package/ide/configs/vscode-copilot-mcp.json +5 -6
- package/ide/configs/windsurf-mcp.json +3 -8
- package/ide/configs/zed-mcp.json +5 -6
- package/ide/integrations/langchain/README.md +3 -3
- package/ide/integrations/langchain/langchain_superlocalmemory/chat_message_history.py +5 -5
- package/ide/integrations/langchain/pyproject.toml +2 -2
- package/ide/integrations/llamaindex/README.md +2 -2
- package/ide/integrations/llamaindex/llama_index/storage/chat_store/superlocalmemory/base.py +4 -4
- package/ide/integrations/llamaindex/pyproject.toml +2 -2
- package/ide/skills/slm-show-patterns/SKILL.md +1 -1
- package/package.json +1 -1
- package/pyproject.toml +1 -1
- package/scripts/build-dmg.sh +8 -8
- package/scripts/install-skills.ps1 +2 -2
- package/scripts/install-skills.sh +3 -3
- package/scripts/install.ps1 +13 -13
- package/scripts/install.sh +9 -9
- package/scripts/preuninstall.js +1 -1
- package/scripts/sync-wiki.ps1 +3 -3
- package/scripts/sync-wiki.sh +3 -3
- package/scripts/test-dmg.sh +1 -1
- package/scripts/test-npm-package.ps1 +1 -1
- package/scripts/test-npm-package.sh +1 -1
- package/scripts/verify-install.ps1 +1 -1
- package/scripts/verify-install.sh +4 -4
- package/scripts/verify-v27.ps1 +3 -3
- package/scripts/verify-v27.sh +3 -3
- package/src/superlocalmemory/cli/commands.py +8 -0
- package/src/superlocalmemory/cli/main.py +3 -0
- package/src/superlocalmemory/cli/post_install.py +1 -1
- package/src/superlocalmemory/core/engine.py +2 -1
- package/src/superlocalmemory/hooks/ide_connector.py +2 -2
- package/src/superlocalmemory.egg-info/PKG-INFO +32 -4
|
@@ -25,9 +25,9 @@ dependencies = [
|
|
|
25
25
|
]
|
|
26
26
|
|
|
27
27
|
[project.urls]
|
|
28
|
-
Homepage = "https://github.com/
|
|
28
|
+
Homepage = "https://github.com/qualixar/superlocalmemory"
|
|
29
29
|
Documentation = "https://superlocalmemory.com/"
|
|
30
|
-
Repository = "https://github.com/
|
|
30
|
+
Repository = "https://github.com/qualixar/superlocalmemory"
|
|
31
31
|
|
|
32
32
|
[tool.hatch.build.targets.wheel]
|
|
33
33
|
packages = ["llama_index"]
|
|
@@ -47,7 +47,7 @@ WORKFLOW PATTERNS:
|
|
|
47
47
|
#8 review_sequence: list -> recall -> remember frequency: 12
|
|
48
48
|
|
|
49
49
|
PROJECT CONTEXT:
|
|
50
|
-
#9 active_project:
|
|
50
|
+
#9 active_project: superlocalmemory last_seen: 2 hours ago
|
|
51
51
|
#10 active_project: client-dashboard last_seen: 1 day ago
|
|
52
52
|
|
|
53
53
|
Total: 10 patterns (7 high confidence)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "superlocalmemory",
|
|
3
|
-
"version": "3.0.
|
|
3
|
+
"version": "3.0.12",
|
|
4
4
|
"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.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"ai-memory",
|
package/pyproject.toml
CHANGED
package/scripts/build-dmg.sh
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
# Solution Architect & Original Creator
|
|
7
7
|
#
|
|
8
8
|
# Licensed under MIT License (see LICENSE file)
|
|
9
|
-
# Repository: https://github.com/
|
|
9
|
+
# Repository: https://github.com/qualixar/superlocalmemory
|
|
10
10
|
#
|
|
11
11
|
# ATTRIBUTION REQUIRED: This notice must be preserved in all copies.
|
|
12
12
|
#
|
|
@@ -158,7 +158,7 @@ QUICK START (2 minutes):
|
|
|
158
158
|
|
|
159
159
|
WHAT GETS INSTALLED:
|
|
160
160
|
-------------------
|
|
161
|
-
• Core memory system → ~/.
|
|
161
|
+
• Core memory system → ~/.superlocalmemory/
|
|
162
162
|
• MCP server auto-configured for 11+ IDEs
|
|
163
163
|
• 6 universal skills (Claude Code, Continue.dev, Cody, etc.)
|
|
164
164
|
• CLI command: slm
|
|
@@ -173,19 +173,19 @@ NEED HELP?
|
|
|
173
173
|
---------
|
|
174
174
|
• Documentation: README.md
|
|
175
175
|
• Quick Start: docs/CLI-COMMANDS-REFERENCE.md
|
|
176
|
-
• GitHub Wiki: https://github.com/
|
|
177
|
-
• Issues: https://github.com/
|
|
176
|
+
• GitHub Wiki: https://github.com/qualixar/superlocalmemory/wiki
|
|
177
|
+
• Issues: https://github.com/qualixar/superlocalmemory/issues
|
|
178
178
|
|
|
179
179
|
UNINSTALL:
|
|
180
180
|
---------
|
|
181
181
|
To uninstall:
|
|
182
|
-
rm -rf ~/.
|
|
182
|
+
rm -rf ~/.superlocalmemory
|
|
183
183
|
rm -f /usr/local/bin/slm
|
|
184
184
|
|
|
185
185
|
================================================================================
|
|
186
186
|
Created by: Varun Pratap Bhardwaj
|
|
187
187
|
License: MIT (Attribution Required)
|
|
188
|
-
Repository: https://github.com/
|
|
188
|
+
Repository: https://github.com/qualixar/superlocalmemory
|
|
189
189
|
================================================================================
|
|
190
190
|
READMEEOF
|
|
191
191
|
}
|
|
@@ -373,7 +373,7 @@ show_summary() {
|
|
|
373
373
|
echo " --notes \"See CHANGELOG.md for details\""
|
|
374
374
|
echo ""
|
|
375
375
|
echo " 3. Or upload manually:"
|
|
376
|
-
echo " https://github.com/
|
|
376
|
+
echo " https://github.com/qualixar/superlocalmemory/releases/new"
|
|
377
377
|
echo ""
|
|
378
378
|
echo "============================================================================"
|
|
379
379
|
}
|
|
@@ -388,7 +388,7 @@ main() {
|
|
|
388
388
|
|
|
389
389
|
# Check we're in the right directory
|
|
390
390
|
if [ ! -f "install.sh" ]; then
|
|
391
|
-
log_error "Must run from
|
|
391
|
+
log_error "Must run from superlocalmemory repository root"
|
|
392
392
|
exit 1
|
|
393
393
|
fi
|
|
394
394
|
|
|
@@ -55,7 +55,7 @@ Write-Host "=========================================="
|
|
|
55
55
|
Write-Host ""
|
|
56
56
|
|
|
57
57
|
# Check if SuperLocalMemory V2 is installed
|
|
58
|
-
$memoryDir = Join-Path $env:USERPROFILE ".
|
|
58
|
+
$memoryDir = Join-Path $env:USERPROFILE ".superlocalmemory"
|
|
59
59
|
if (-not (Test-Path $memoryDir)) {
|
|
60
60
|
Write-Host "Warning: SuperLocalMemory V2 not found at $memoryDir" -ForegroundColor Yellow
|
|
61
61
|
Write-Host "Skills require SuperLocalMemory V2 to be installed first."
|
|
@@ -75,7 +75,7 @@ if (-not (Test-Path $memoryDir)) {
|
|
|
75
75
|
# Check if skills source directory exists
|
|
76
76
|
if (-not (Test-Path $SKILLS_SOURCE)) {
|
|
77
77
|
Write-Host "Error: Skills directory not found: $SKILLS_SOURCE" -ForegroundColor Red
|
|
78
|
-
Write-Host "Please run this script from the
|
|
78
|
+
Write-Host "Please run this script from the superlocalmemory-repo directory."
|
|
79
79
|
exit 1
|
|
80
80
|
}
|
|
81
81
|
|
|
@@ -80,8 +80,8 @@ echo "=========================================="
|
|
|
80
80
|
echo ""
|
|
81
81
|
|
|
82
82
|
# Check if SuperLocalMemory V2 is installed
|
|
83
|
-
if [ ! -d "$HOME/.
|
|
84
|
-
echo -e "${YELLOW}Warning:${NC} SuperLocalMemory V2 not found at ~/.
|
|
83
|
+
if [ ! -d "$HOME/.superlocalmemory" ]; then
|
|
84
|
+
echo -e "${YELLOW}Warning:${NC} SuperLocalMemory V2 not found at ~/.superlocalmemory/"
|
|
85
85
|
echo "Skills require SuperLocalMemory V2 to be installed first."
|
|
86
86
|
echo ""
|
|
87
87
|
if [ "$AUTO_MODE" = true ]; then
|
|
@@ -100,7 +100,7 @@ fi
|
|
|
100
100
|
# Check if skills source directory exists
|
|
101
101
|
if [ ! -d "$SKILLS_SOURCE" ]; then
|
|
102
102
|
echo -e "${RED}Error:${NC} Skills directory not found: $SKILLS_SOURCE"
|
|
103
|
-
echo "Please run this script from the
|
|
103
|
+
echo "Please run this script from the superlocalmemory-repo directory."
|
|
104
104
|
exit 1
|
|
105
105
|
fi
|
|
106
106
|
|
package/scripts/install.ps1
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# ============================================================================
|
|
2
|
-
# SuperLocalMemory
|
|
2
|
+
# SuperLocalMemory V3 - Windows Installation Script (PowerShell)
|
|
3
3
|
# Copyright (c) 2026 Varun Pratap Bhardwaj
|
|
4
4
|
# Licensed under MIT License
|
|
5
|
-
# Repository: https://github.com/
|
|
5
|
+
# Repository: https://github.com/qualixar/superlocalmemory
|
|
6
6
|
# ============================================================================
|
|
7
7
|
|
|
8
8
|
# IMPORTANT: param() must be the FIRST executable statement in PowerShell
|
|
@@ -15,7 +15,7 @@ param(
|
|
|
15
15
|
|
|
16
16
|
$ErrorActionPreference = "Stop"
|
|
17
17
|
|
|
18
|
-
$INSTALL_DIR = if ($env:SL_MEMORY_PATH) { $env:SL_MEMORY_PATH } else { Join-Path $env:USERPROFILE ".
|
|
18
|
+
$INSTALL_DIR = if ($env:SL_MEMORY_PATH) { $env:SL_MEMORY_PATH } else { Join-Path $env:USERPROFILE ".superlocalmemory" }
|
|
19
19
|
$REPO_DIR = Split-Path -Parent $MyInvocation.MyCommand.Path
|
|
20
20
|
|
|
21
21
|
# Auto-detect non-interactive environment
|
|
@@ -31,9 +31,9 @@ if ($NonInteractive -or $Auto -or $Yes -or $y) {
|
|
|
31
31
|
# Print banner
|
|
32
32
|
Write-Host ""
|
|
33
33
|
Write-Host "=================================================================="
|
|
34
|
-
Write-Host " SuperLocalMemory
|
|
34
|
+
Write-Host " SuperLocalMemory V3 - Windows Installation "
|
|
35
35
|
Write-Host " by Varun Pratap Bhardwaj "
|
|
36
|
-
Write-Host " https://github.com/
|
|
36
|
+
Write-Host " https://github.com/qualixar/superlocalmemory "
|
|
37
37
|
Write-Host "=================================================================="
|
|
38
38
|
Write-Host ""
|
|
39
39
|
|
|
@@ -200,7 +200,7 @@ if (Test-Path $setupValidatorPath) {
|
|
|
200
200
|
import sqlite3
|
|
201
201
|
import os
|
|
202
202
|
from pathlib import Path
|
|
203
|
-
db_path = Path(os.environ.get('SL_MEMORY_PATH') or str(Path.home() / '.
|
|
203
|
+
db_path = Path(os.environ.get('SL_MEMORY_PATH') or str(Path.home() / '.superlocalmemory')) / 'memory.db'
|
|
204
204
|
conn = sqlite3.connect(db_path)
|
|
205
205
|
cursor = conn.cursor()
|
|
206
206
|
cursor.execute('''CREATE TABLE IF NOT EXISTS memories (
|
|
@@ -260,7 +260,7 @@ $memoryCount = & python -c @"
|
|
|
260
260
|
import sqlite3
|
|
261
261
|
import os
|
|
262
262
|
from pathlib import Path
|
|
263
|
-
db_path = Path(os.environ.get('SL_MEMORY_PATH') or str(Path.home() / '.
|
|
263
|
+
db_path = Path(os.environ.get('SL_MEMORY_PATH') or str(Path.home() / '.superlocalmemory')) / 'memory.db'
|
|
264
264
|
conn = sqlite3.connect(db_path)
|
|
265
265
|
cursor = conn.cursor()
|
|
266
266
|
cursor.execute('SELECT COUNT(*) FROM memories')
|
|
@@ -272,9 +272,9 @@ if (-not $memoryCount) { $memoryCount = 0 }
|
|
|
272
272
|
|
|
273
273
|
if ([int]$memoryCount -eq 0) {
|
|
274
274
|
Write-Host "INFO: Adding sample memories for demonstration..." -ForegroundColor Yellow
|
|
275
|
-
& python "$INSTALL_DIR\
|
|
276
|
-
& python "$INSTALL_DIR\
|
|
277
|
-
& python "$INSTALL_DIR\
|
|
275
|
+
& python "$INSTALL_DIR\superlocalmemory.cli.main" add "SuperLocalMemory V2 is a local-first, privacy-focused memory system for AI assistants. All data stays on your machine." --tags "supermemory,system,intro" --importance 8 2>$null | Out-Null
|
|
276
|
+
& python "$INSTALL_DIR\superlocalmemory.cli.main" add "Knowledge graph uses TF-IDF for entity extraction and Leiden clustering for community detection." --tags "architecture,graph" --importance 7 2>$null | Out-Null
|
|
277
|
+
& python "$INSTALL_DIR\superlocalmemory.cli.main" add "Pattern learning analyzes your coding preferences, style, and terminology to provide better context." --tags "architecture,patterns" --importance 7 2>$null | Out-Null
|
|
278
278
|
}
|
|
279
279
|
|
|
280
280
|
# Build knowledge graph (Layer 3)
|
|
@@ -294,7 +294,7 @@ try {
|
|
|
294
294
|
import sqlite3
|
|
295
295
|
import os
|
|
296
296
|
from pathlib import Path
|
|
297
|
-
db_path = Path(os.environ.get('SL_MEMORY_PATH') or str(Path.home() / '.
|
|
297
|
+
db_path = Path(os.environ.get('SL_MEMORY_PATH') or str(Path.home() / '.superlocalmemory')) / 'memory.db'
|
|
298
298
|
conn = sqlite3.connect(db_path)
|
|
299
299
|
cursor = conn.cursor()
|
|
300
300
|
cursor.execute('SELECT COUNT(*) FROM identity_patterns')
|
|
@@ -575,7 +575,7 @@ Write-Host ""
|
|
|
575
575
|
Write-Host "OK Commands available after terminal restart!" -ForegroundColor Green
|
|
576
576
|
Write-Host ""
|
|
577
577
|
Write-Host "Quick start (restart terminal first):"
|
|
578
|
-
Write-Host " python $INSTALL_DIR\
|
|
578
|
+
Write-Host " python $INSTALL_DIR\superlocalmemory.cli.main"
|
|
579
579
|
Write-Host ""
|
|
580
580
|
|
|
581
581
|
# Optional: Offer to install optional features
|
|
@@ -669,7 +669,7 @@ Write-Host " ATTRIBUTION NOTICE (REQUIRED BY MIT LICENSE) "
|
|
|
669
669
|
Write-Host "=================================================================="
|
|
670
670
|
Write-Host " Created by: Varun Pratap Bhardwaj "
|
|
671
671
|
Write-Host " Role: Solution Architect & Original Creator "
|
|
672
|
-
Write-Host " Repository: github.com/
|
|
672
|
+
Write-Host " Repository: github.com/qualixar/superlocalmemory "
|
|
673
673
|
Write-Host " License: MIT (attribution must be preserved) "
|
|
674
674
|
Write-Host "=================================================================="
|
|
675
675
|
Write-Host ""
|
package/scripts/install.sh
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
#!/bin/bash
|
|
2
2
|
# ============================================================================
|
|
3
|
-
# SuperLocalMemory
|
|
3
|
+
# SuperLocalMemory V3 Installation Script
|
|
4
4
|
# Copyright (c) 2026 Varun Pratap Bhardwaj
|
|
5
5
|
# Licensed under MIT License
|
|
6
|
-
# Repository: https://github.com/
|
|
6
|
+
# Repository: https://github.com/qualixar/superlocalmemory
|
|
7
7
|
# ============================================================================
|
|
8
8
|
|
|
9
9
|
set -e
|
|
10
10
|
|
|
11
|
-
INSTALL_DIR="${SL_MEMORY_PATH:-${HOME}/.
|
|
11
|
+
INSTALL_DIR="${SL_MEMORY_PATH:-${HOME}/.superlocalmemory}"
|
|
12
12
|
REPO_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
|
|
13
13
|
|
|
14
14
|
# Parse command line arguments
|
|
@@ -44,9 +44,9 @@ done
|
|
|
44
44
|
# Print banner
|
|
45
45
|
echo ""
|
|
46
46
|
echo "╔══════════════════════════════════════════════════════════════╗"
|
|
47
|
-
echo "║ SuperLocalMemory
|
|
47
|
+
echo "║ SuperLocalMemory V3 - Installation ║"
|
|
48
48
|
echo "║ by Varun Pratap Bhardwaj ║"
|
|
49
|
-
echo "║ https://github.com/
|
|
49
|
+
echo "║ https://github.com/qualixar/superlocalmemory ║"
|
|
50
50
|
echo "╚══════════════════════════════════════════════════════════════╝"
|
|
51
51
|
echo ""
|
|
52
52
|
|
|
@@ -148,7 +148,7 @@ echo "✓ Directory: ${INSTALL_DIR}"
|
|
|
148
148
|
UNIVERSAL_LINK="${HOME}/.superlocalmemory"
|
|
149
149
|
if [ ! -e "${UNIVERSAL_LINK}" ]; then
|
|
150
150
|
ln -s "${INSTALL_DIR}" "${UNIVERSAL_LINK}" 2>/dev/null && \
|
|
151
|
-
echo "✓ Universal link created: ~/.superlocalmemory → ~/.
|
|
151
|
+
echo "✓ Universal link created: ~/.superlocalmemory → ~/.superlocalmemory" || true
|
|
152
152
|
fi
|
|
153
153
|
|
|
154
154
|
# Copy source files
|
|
@@ -334,7 +334,7 @@ cursor.execute('CREATE TABLE IF NOT EXISTS pattern_examples (id INTEGER PRIMARY
|
|
|
334
334
|
cursor.execute('CREATE TABLE IF NOT EXISTS memory_tree (id INTEGER PRIMARY KEY, node_type TEXT, name TEXT, parent_id INTEGER, tree_path TEXT DEFAULT \"/\", depth INTEGER DEFAULT 0, memory_count INTEGER DEFAULT 0, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP)')
|
|
335
335
|
cursor.execute('CREATE TABLE IF NOT EXISTS memory_archive (id INTEGER PRIMARY KEY, original_memory_id INTEGER, compressed_content TEXT, compression_type TEXT DEFAULT \"tier2\", original_size INTEGER, compressed_size INTEGER, archived_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP)')
|
|
336
336
|
cursor.execute('CREATE TABLE IF NOT EXISTS system_metadata (key TEXT PRIMARY KEY, value TEXT NOT NULL)')
|
|
337
|
-
cursor.execute(\"INSERT OR REPLACE INTO system_metadata (key, value) VALUES ('product', 'SuperLocalMemory V2'), ('author', 'Varun Pratap Bhardwaj'), ('repository', 'https://github.com/
|
|
337
|
+
cursor.execute(\"INSERT OR REPLACE INTO system_metadata (key, value) VALUES ('product', 'SuperLocalMemory V2'), ('author', 'Varun Pratap Bhardwaj'), ('repository', 'https://github.com/qualixar/superlocalmemory'), ('license', 'MIT'), ('schema_version', '2.0.0')\")
|
|
338
338
|
conn.commit()
|
|
339
339
|
conn.close()
|
|
340
340
|
print('Database ready')
|
|
@@ -833,7 +833,7 @@ echo " • Custom tools - See integration guide"
|
|
|
833
833
|
echo ""
|
|
834
834
|
echo "Full manual setup guide:"
|
|
835
835
|
echo " docs/MCP-MANUAL-SETUP.md"
|
|
836
|
-
echo " https://github.com/
|
|
836
|
+
echo " https://github.com/qualixar/superlocalmemory/blob/main/docs/MCP-MANUAL-SETUP.md"
|
|
837
837
|
echo ""
|
|
838
838
|
|
|
839
839
|
# Summary
|
|
@@ -944,7 +944,7 @@ echo "║ ATTRIBUTION NOTICE (REQUIRED BY MIT LICENSE) ║"
|
|
|
944
944
|
echo "╠══════════════════════════════════════════════════════════════╣"
|
|
945
945
|
echo "║ Created by: Varun Pratap Bhardwaj ║"
|
|
946
946
|
echo "║ Role: Solution Architect & Original Creator ║"
|
|
947
|
-
echo "║ Repository: github.com/
|
|
947
|
+
echo "║ Repository: github.com/qualixar/superlocalmemory ║"
|
|
948
948
|
echo "║ License: MIT (attribution must be preserved) ║"
|
|
949
949
|
echo "║ ║"
|
|
950
950
|
echo "║ See ATTRIBUTION.md for full attribution requirements ║"
|
package/scripts/preuninstall.js
CHANGED
|
@@ -19,7 +19,7 @@ console.log('\n═════════════════════
|
|
|
19
19
|
console.log(' SuperLocalMemory V2 - Uninstalling');
|
|
20
20
|
console.log('════════════════════════════════════════════════════════════\n');
|
|
21
21
|
|
|
22
|
-
const SLM_DIR = path.join(os.homedir(), '.
|
|
22
|
+
const SLM_DIR = path.join(os.homedir(), '.superlocalmemory');
|
|
23
23
|
|
|
24
24
|
if (fs.existsSync(SLM_DIR)) {
|
|
25
25
|
console.log('⚠️ Your data is preserved at: ' + SLM_DIR);
|
package/scripts/sync-wiki.ps1
CHANGED
|
@@ -11,8 +11,8 @@ $ErrorActionPreference = "Stop"
|
|
|
11
11
|
# Configuration
|
|
12
12
|
$REPO_DIR = $PSScriptRoot
|
|
13
13
|
$WIKI_CONTENT_DIR = Join-Path $REPO_DIR "wiki-content"
|
|
14
|
-
$WIKI_REPO_DIR = Join-Path $env:TEMP "
|
|
15
|
-
$WIKI_REPO_URL = "https://github.com/
|
|
14
|
+
$WIKI_REPO_DIR = Join-Path $env:TEMP "superlocalmemory.wiki"
|
|
15
|
+
$WIKI_REPO_URL = "https://github.com/qualixar/superlocalmemory.wiki.git"
|
|
16
16
|
|
|
17
17
|
Write-Host "╔══════════════════════════════════════════════════════════════╗"
|
|
18
18
|
Write-Host "║ SuperLocalMemory V2 - Wiki Sync Tool ║"
|
|
@@ -119,7 +119,7 @@ Created by: Varun Pratap Bhardwaj
|
|
|
119
119
|
Write-Host ""
|
|
120
120
|
Write-Host "╔══════════════════════════════════════════════════════════════╗"
|
|
121
121
|
Write-Host "║ ✅ Wiki synced successfully! ║"
|
|
122
|
-
Write-Host "║ View at: https://github.com/
|
|
122
|
+
Write-Host "║ View at: https://github.com/qualixar/superlocalmemory/wiki║"
|
|
123
123
|
Write-Host "╚══════════════════════════════════════════════════════════════╝"
|
|
124
124
|
|
|
125
125
|
} finally {
|
package/scripts/sync-wiki.sh
CHANGED
|
@@ -9,8 +9,8 @@ set -e
|
|
|
9
9
|
|
|
10
10
|
REPO_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
|
|
11
11
|
WIKI_CONTENT_DIR="${REPO_DIR}/wiki-content"
|
|
12
|
-
WIKI_REPO_DIR="/tmp/
|
|
13
|
-
WIKI_REPO_URL="https://github.com/
|
|
12
|
+
WIKI_REPO_DIR="/tmp/superlocalmemory.wiki"
|
|
13
|
+
WIKI_REPO_URL="https://github.com/qualixar/superlocalmemory.wiki.git"
|
|
14
14
|
|
|
15
15
|
echo "╔══════════════════════════════════════════════════════════════╗"
|
|
16
16
|
echo "║ SuperLocalMemory V2 - Wiki Sync Tool ║"
|
|
@@ -78,5 +78,5 @@ git push origin "${DEFAULT_BRANCH:-master}"
|
|
|
78
78
|
echo ""
|
|
79
79
|
echo "╔══════════════════════════════════════════════════════════════╗"
|
|
80
80
|
echo "║ ✅ Wiki synced successfully! ║"
|
|
81
|
-
echo "║ View at: https://github.com/
|
|
81
|
+
echo "║ View at: https://github.com/qualixar/superlocalmemory/wiki║"
|
|
82
82
|
echo "╚══════════════════════════════════════════════════════════════╝"
|
package/scripts/test-dmg.sh
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
# Solution Architect & Original Creator
|
|
7
7
|
#
|
|
8
8
|
# Licensed under MIT License (see LICENSE file)
|
|
9
|
-
# Repository: https://github.com/
|
|
9
|
+
# Repository: https://github.com/qualixar/superlocalmemory
|
|
10
10
|
#
|
|
11
11
|
# ATTRIBUTION REQUIRED: This notice must be preserved in all copies.
|
|
12
12
|
#
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
# SuperLocalMemory V2 - NPM Package Testing Script (PowerShell)
|
|
3
3
|
# Copyright (c) 2026 Varun Pratap Bhardwaj
|
|
4
4
|
# Licensed under MIT License
|
|
5
|
-
# Repository: https://github.com/
|
|
5
|
+
# Repository: https://github.com/qualixar/superlocalmemory
|
|
6
6
|
# ============================================================================
|
|
7
7
|
#
|
|
8
8
|
# Tests the NPM package locally before publishing
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
# SuperLocalMemory V2 - NPM Package Testing Script
|
|
4
4
|
# Copyright (c) 2026 Varun Pratap Bhardwaj
|
|
5
5
|
# Licensed under MIT License
|
|
6
|
-
# Repository: https://github.com/
|
|
6
|
+
# Repository: https://github.com/qualixar/superlocalmemory
|
|
7
7
|
# ============================================================================
|
|
8
8
|
#
|
|
9
9
|
# Tests the NPM package locally before publishing
|
|
@@ -3,12 +3,12 @@
|
|
|
3
3
|
# SuperLocalMemory - Installation Verification Script
|
|
4
4
|
# Copyright (c) 2026 Varun Pratap Bhardwaj
|
|
5
5
|
# Licensed under MIT License
|
|
6
|
-
# Repository: https://github.com/
|
|
6
|
+
# Repository: https://github.com/qualixar/superlocalmemory
|
|
7
7
|
# ============================================================================
|
|
8
8
|
|
|
9
9
|
set -e
|
|
10
10
|
|
|
11
|
-
INSTALL_DIR="${HOME}/.
|
|
11
|
+
INSTALL_DIR="${HOME}/.superlocalmemory"
|
|
12
12
|
|
|
13
13
|
# Print banner
|
|
14
14
|
echo ""
|
|
@@ -88,7 +88,7 @@ fi
|
|
|
88
88
|
echo -n "PATH configuration "
|
|
89
89
|
if command -v slm &>/dev/null; then
|
|
90
90
|
echo "✓ OK (commands globally available)"
|
|
91
|
-
elif grep -q ".
|
|
91
|
+
elif grep -q ".superlocalmemory/bin" "${HOME}/.zshrc" 2>/dev/null || grep -q ".superlocalmemory/bin" "${HOME}/.bashrc" 2>/dev/null || grep -q ".superlocalmemory/bin" "${HOME}/.bash_profile" 2>/dev/null; then
|
|
92
92
|
echo "○ PARTIAL (configured but needs shell restart)"
|
|
93
93
|
else
|
|
94
94
|
echo "⚠️ WARNING (not in PATH)"
|
|
@@ -139,7 +139,7 @@ if python3 -c "import fastapi; import uvicorn" 2>/dev/null; then
|
|
|
139
139
|
echo "✓ ENABLED"
|
|
140
140
|
UI_OK=true
|
|
141
141
|
if [ -f "${INSTALL_DIR}/api_server.py" ]; then
|
|
142
|
-
echo " Start: python3 ~/.
|
|
142
|
+
echo " Start: python3 ~/.superlocalmemory/api_server.py"
|
|
143
143
|
echo " URL: http://127.0.0.1:8000"
|
|
144
144
|
fi
|
|
145
145
|
else
|
package/scripts/verify-v27.ps1
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
# SuperLocalMemory V2.7 — Quick Verification Script (PowerShell)
|
|
3
3
|
# Copyright (c) 2026 Varun Pratap Bhardwaj
|
|
4
4
|
# Licensed under MIT License
|
|
5
|
-
# Repository: https://github.com/
|
|
5
|
+
# Repository: https://github.com/qualixar/superlocalmemory
|
|
6
6
|
#
|
|
7
7
|
# Run this after installation to verify everything works:
|
|
8
8
|
# .\scripts\verify-v27.ps1
|
|
@@ -12,7 +12,7 @@ param()
|
|
|
12
12
|
|
|
13
13
|
$ErrorActionPreference = "Stop"
|
|
14
14
|
|
|
15
|
-
$INSTALL_DIR = Join-Path $env:USERPROFILE ".
|
|
15
|
+
$INSTALL_DIR = Join-Path $env:USERPROFILE ".superlocalmemory"
|
|
16
16
|
$PASS = 0
|
|
17
17
|
$WARN = 0
|
|
18
18
|
$FAIL = 0
|
|
@@ -200,7 +200,7 @@ if ($slmCommand) {
|
|
|
200
200
|
$slmBin = Join-Path $INSTALL_DIR "bin\slm"
|
|
201
201
|
if (Test-Path $slmBin) {
|
|
202
202
|
Write-Host " [WARN] slm exists at $slmBin but not in PATH" -ForegroundColor Yellow
|
|
203
|
-
Write-Host " Add to PATH: `$env:PATH = `"`$env:USERPROFILE\.
|
|
203
|
+
Write-Host " Add to PATH: `$env:PATH = `"`$env:USERPROFILE\.superlocalmemory\bin;`$env:PATH`""
|
|
204
204
|
$WARN++
|
|
205
205
|
} else {
|
|
206
206
|
Write-Host " [FAIL] slm command not found" -ForegroundColor Red
|
package/scripts/verify-v27.sh
CHANGED
|
@@ -3,13 +3,13 @@
|
|
|
3
3
|
# SuperLocalMemory V2.7 — Quick Verification Script
|
|
4
4
|
# Copyright (c) 2026 Varun Pratap Bhardwaj
|
|
5
5
|
# Licensed under MIT License
|
|
6
|
-
# Repository: https://github.com/
|
|
6
|
+
# Repository: https://github.com/qualixar/superlocalmemory
|
|
7
7
|
#
|
|
8
8
|
# Run this after installation to verify everything works:
|
|
9
9
|
# bash scripts/verify-v27.sh
|
|
10
10
|
# ============================================================================
|
|
11
11
|
|
|
12
|
-
INSTALL_DIR="${HOME}/.
|
|
12
|
+
INSTALL_DIR="${HOME}/.superlocalmemory"
|
|
13
13
|
PASS=0
|
|
14
14
|
WARN=0
|
|
15
15
|
FAIL=0
|
|
@@ -140,7 +140,7 @@ if command -v slm &> /dev/null; then
|
|
|
140
140
|
else
|
|
141
141
|
if [ -f "$INSTALL_DIR/bin/slm" ]; then
|
|
142
142
|
echo " [WARN] slm exists at $INSTALL_DIR/bin/slm but not in PATH"
|
|
143
|
-
echo " Add to PATH: export PATH=\"\$HOME/.
|
|
143
|
+
echo " Add to PATH: export PATH=\"\$HOME/.superlocalmemory/bin:\$PATH\""
|
|
144
144
|
WARN=$((WARN + 1))
|
|
145
145
|
else
|
|
146
146
|
echo " [FAIL] slm command not found"
|
|
@@ -29,6 +29,7 @@ def dispatch(args: Namespace) -> None:
|
|
|
29
29
|
"status": cmd_status,
|
|
30
30
|
"health": cmd_health,
|
|
31
31
|
"trace": cmd_trace,
|
|
32
|
+
"mcp": cmd_mcp,
|
|
32
33
|
"warmup": cmd_warmup,
|
|
33
34
|
"dashboard": cmd_dashboard,
|
|
34
35
|
"profile": cmd_profile,
|
|
@@ -218,6 +219,13 @@ def cmd_trace(args: Namespace) -> None:
|
|
|
218
219
|
print(f" {ch}: {sc:.3f}")
|
|
219
220
|
|
|
220
221
|
|
|
222
|
+
def cmd_mcp(_args: Namespace) -> None:
|
|
223
|
+
"""Start the V3 MCP server (stdio transport for IDE integration)."""
|
|
224
|
+
from superlocalmemory.mcp.server import server
|
|
225
|
+
|
|
226
|
+
server.run(transport="stdio")
|
|
227
|
+
|
|
228
|
+
|
|
221
229
|
def cmd_warmup(_args: Namespace) -> None:
|
|
222
230
|
"""Pre-download the embedding model so first use is instant."""
|
|
223
231
|
print("Downloading embedding model (nomic-ai/nomic-embed-text-v1.5)...")
|
|
@@ -67,6 +67,9 @@ def main() -> None:
|
|
|
67
67
|
trace_p = sub.add_parser("trace", help="Recall with channel breakdown")
|
|
68
68
|
trace_p.add_argument("query", help="Search query")
|
|
69
69
|
|
|
70
|
+
# MCP server (for IDE integration)
|
|
71
|
+
sub.add_parser("mcp", help="Start MCP server (stdio transport for IDE integration)")
|
|
72
|
+
|
|
70
73
|
# Warmup (pre-download model)
|
|
71
74
|
sub.add_parser("warmup", help="Pre-download embedding model (~500MB)")
|
|
72
75
|
|
|
@@ -37,7 +37,7 @@ def _handle_v2_upgrade(migrator):
|
|
|
37
37
|
stats = migrator.get_v2_stats()
|
|
38
38
|
|
|
39
39
|
print("Existing V2 installation detected!")
|
|
40
|
-
print(f" Database: {stats.get('db_path', '~/.
|
|
40
|
+
print(f" Database: {stats.get('db_path', '~/.superlocalmemory/memory.db')}")
|
|
41
41
|
print(f" Memories: {stats.get('memory_count', 'unknown')}")
|
|
42
42
|
print(f" Profiles: {stats.get('profile_count', 1)}")
|
|
43
43
|
print()
|
|
@@ -414,7 +414,8 @@ class MemoryEngine:
|
|
|
414
414
|
}
|
|
415
415
|
# Bayesian variance narrowing after 3+ accesses
|
|
416
416
|
if (q_var_arr is not None
|
|
417
|
-
and r.fact.fisher_variance
|
|
417
|
+
and r.fact.fisher_variance
|
|
418
|
+
and len(r.fact.fisher_variance) == len(q_var_arr)
|
|
418
419
|
and r.fact.access_count >= 3):
|
|
419
420
|
import numpy as _np
|
|
420
421
|
f_var = _np.array(r.fact.fisher_variance, dtype=_np.float64)
|
|
@@ -194,8 +194,8 @@ class IDEConnector:
|
|
|
194
194
|
data["mcpServers"] = {}
|
|
195
195
|
|
|
196
196
|
data["mcpServers"]["superlocalmemory"] = {
|
|
197
|
-
"command": "
|
|
198
|
-
"args": ["
|
|
197
|
+
"command": "slm",
|
|
198
|
+
"args": ["mcp"],
|
|
199
199
|
"enabled": True,
|
|
200
200
|
}
|
|
201
201
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: superlocalmemory
|
|
3
|
-
Version: 3.0.
|
|
3
|
+
Version: 3.0.12
|
|
4
4
|
Summary: Information-geometric agent memory with mathematical guarantees
|
|
5
5
|
Author-email: Varun Pratap Bhardwaj <admin@superlocalmemory.com>
|
|
6
6
|
License: MIT
|
|
@@ -142,6 +142,16 @@ Query ──► Strategy Classifier ──► 4 Parallel Channels:
|
|
|
142
142
|
|
|
143
143
|
> 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.
|
|
144
144
|
|
|
145
|
+
### What Gets Installed Automatically
|
|
146
|
+
|
|
147
|
+
| Component | Size | When |
|
|
148
|
+
|:----------|:-----|:-----|
|
|
149
|
+
| Core math libraries (numpy, scipy, networkx) | ~50MB | During `npm install` |
|
|
150
|
+
| Search engine (sentence-transformers, einops, torch) | ~200MB | During `npm install` |
|
|
151
|
+
| Embedding model (nomic-ai/nomic-embed-text-v1.5) | ~500MB | On first use OR `slm warmup` |
|
|
152
|
+
|
|
153
|
+
**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.
|
|
154
|
+
|
|
145
155
|
---
|
|
146
156
|
|
|
147
157
|
## Quick Start
|
|
@@ -154,15 +164,18 @@ npm install -g superlocalmemory
|
|
|
154
164
|
|
|
155
165
|
This single command:
|
|
156
166
|
- Installs the V3 engine and CLI
|
|
157
|
-
- Auto-installs all Python dependencies (numpy, scipy, networkx, sentence-transformers, etc.)
|
|
167
|
+
- Auto-installs all Python dependencies (numpy, scipy, networkx, sentence-transformers, einops, torch, etc.)
|
|
158
168
|
- Creates the data directory at `~/.superlocalmemory/`
|
|
159
169
|
- Detects and guides V2 migration if applicable
|
|
160
170
|
|
|
161
|
-
Then configure:
|
|
171
|
+
Then configure and pre-download the embedding model:
|
|
162
172
|
```bash
|
|
163
|
-
slm setup
|
|
173
|
+
slm setup # Choose mode, configure provider
|
|
174
|
+
slm warmup # Pre-download embedding model (~500MB, optional)
|
|
164
175
|
```
|
|
165
176
|
|
|
177
|
+
> **First time?** If you skip `slm warmup`, the model downloads automatically on first `slm remember` or `slm recall`. Either way works.
|
|
178
|
+
|
|
166
179
|
### Install via pip
|
|
167
180
|
|
|
168
181
|
```bash
|
|
@@ -212,6 +225,21 @@ Add to your IDE's MCP config:
|
|
|
212
225
|
slm dashboard # Opens at http://localhost:8765
|
|
213
226
|
```
|
|
214
227
|
|
|
228
|
+
<details open>
|
|
229
|
+
<summary><strong>Dashboard Screenshots</strong> (click to collapse)</summary>
|
|
230
|
+
<p align="center"><img src="docs/screenshots/01-dashboard-main.png" alt="Dashboard" width="600"/></p>
|
|
231
|
+
<p align="center">
|
|
232
|
+
<img src="docs/screenshots/02-knowledge-graph.png" alt="Graph" width="190"/>
|
|
233
|
+
<img src="docs/screenshots/03-math-health.png" alt="Math" width="190"/>
|
|
234
|
+
<img src="docs/screenshots/05-trust-dashboard.png" alt="Trust" width="190"/>
|
|
235
|
+
</p>
|
|
236
|
+
<p align="center">
|
|
237
|
+
<img src="docs/screenshots/04-recall-lab.png" alt="Recall" width="190"/>
|
|
238
|
+
<img src="docs/screenshots/06-settings.png" alt="Settings" width="190"/>
|
|
239
|
+
<img src="docs/screenshots/07-memories-blurred.png" alt="Memories" width="190"/>
|
|
240
|
+
</p>
|
|
241
|
+
</details>
|
|
242
|
+
|
|
215
243
|
The V3 dashboard provides real-time visibility into your memory system:
|
|
216
244
|
|
|
217
245
|
- **Dashboard** — Mode switcher, health score, quick store/recall
|