superlocalmemory 3.0.19 → 3.0.21
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/package.json +1 -1
- package/pyproject.toml +1 -1
- package/src/superlocalmemory/core/config.py +1 -0
- package/src/superlocalmemory/learning/engagement.py +1 -1
- package/src/superlocalmemory/learning/feedback.py +1 -1
- package/src/superlocalmemory/learning/source_quality.py +1 -1
- package/src/superlocalmemory/server/security_middleware.py +2 -1
- package/src/superlocalmemory.egg-info/PKG-INFO +0 -379
- package/src/superlocalmemory.egg-info/SOURCES.txt +0 -162
- package/src/superlocalmemory.egg-info/dependency_links.txt +0 -1
- package/src/superlocalmemory.egg-info/entry_points.txt +0 -2
- package/src/superlocalmemory.egg-info/requires.txt +0 -35
- package/src/superlocalmemory.egg-info/top_level.txt +0 -1
- /package/docs/{architecture.md → ARCHITECTURE.md} +0 -0
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "superlocalmemory",
|
|
3
|
-
"version": "3.0.
|
|
3
|
+
"version": "3.0.21",
|
|
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
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
#!/usr/bin/env python3
|
|
2
2
|
# SPDX-License-Identifier: MIT
|
|
3
|
-
# Copyright (c) 2026
|
|
3
|
+
# Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
|
|
4
4
|
# Part of Qualixar | Author: Varun Pratap Bhardwaj (qualixar.com | varunpratap.com)
|
|
5
5
|
"""
|
|
6
6
|
EngagementTracker -- Local-only engagement metrics for V3 learning.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
#!/usr/bin/env python3
|
|
2
2
|
# SPDX-License-Identifier: MIT
|
|
3
|
-
# Copyright (c) 2026
|
|
3
|
+
# Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
|
|
4
4
|
# Part of Qualixar | Author: Varun Pratap Bhardwaj (qualixar.com | varunpratap.com)
|
|
5
5
|
"""
|
|
6
6
|
FeedbackCollector -- Multi-signal feedback collection for V3 learning.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
#!/usr/bin/env python3
|
|
2
2
|
# SPDX-License-Identifier: MIT
|
|
3
|
-
# Copyright (c) 2026
|
|
3
|
+
# Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
|
|
4
4
|
# Part of Qualixar | Author: Varun Pratap Bhardwaj (qualixar.com | varunpratap.com)
|
|
5
5
|
"""
|
|
6
6
|
SourceQualityScorer -- Beta-binomial source quality scoring for V3 learning.
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
#!/usr/bin/env python3
|
|
2
2
|
# SPDX-License-Identifier: MIT
|
|
3
|
-
# Copyright (c) 2026
|
|
3
|
+
# Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
|
|
4
|
+
# Part of Qualixar | Author: Varun Pratap Bhardwaj (qualixar.com | varunpratap.com)
|
|
4
5
|
"""Security headers middleware for FastAPI servers.
|
|
5
6
|
|
|
6
7
|
Adds comprehensive security headers to all HTTP responses:
|
|
@@ -1,379 +0,0 @@
|
|
|
1
|
-
Metadata-Version: 2.4
|
|
2
|
-
Name: superlocalmemory
|
|
3
|
-
Version: 3.0.19
|
|
4
|
-
Summary: Information-geometric agent memory with mathematical guarantees
|
|
5
|
-
Author-email: Varun Pratap Bhardwaj <admin@superlocalmemory.com>
|
|
6
|
-
License: MIT
|
|
7
|
-
Project-URL: Homepage, https://superlocalmemory.com
|
|
8
|
-
Project-URL: Repository, https://github.com/qualixar/superlocalmemory
|
|
9
|
-
Project-URL: Documentation, https://github.com/qualixar/superlocalmemory/wiki
|
|
10
|
-
Project-URL: Issues, https://github.com/qualixar/superlocalmemory/issues
|
|
11
|
-
Keywords: ai-memory,mcp-server,local-first,agent-memory,information-geometry,privacy-first,eu-ai-act
|
|
12
|
-
Requires-Python: >=3.11
|
|
13
|
-
Description-Content-Type: text/markdown
|
|
14
|
-
License-File: LICENSE
|
|
15
|
-
License-File: NOTICE
|
|
16
|
-
License-File: AUTHORS.md
|
|
17
|
-
Requires-Dist: httpx>=0.24.0
|
|
18
|
-
Requires-Dist: numpy<3.0.0,>=1.26.0
|
|
19
|
-
Requires-Dist: scipy<2.0.0,>=1.12.0
|
|
20
|
-
Requires-Dist: networkx>=3.0
|
|
21
|
-
Requires-Dist: mcp>=1.0.0
|
|
22
|
-
Requires-Dist: python-dateutil>=2.9.0.post0
|
|
23
|
-
Requires-Dist: rank-bm25>=0.2.2
|
|
24
|
-
Requires-Dist: vadersentiment>=3.3.2
|
|
25
|
-
Requires-Dist: einops>=0.8.2
|
|
26
|
-
Provides-Extra: search
|
|
27
|
-
Requires-Dist: sentence-transformers<4.0.0,>=2.5.0; extra == "search"
|
|
28
|
-
Requires-Dist: einops<1.0.0,>=0.7.0; extra == "search"
|
|
29
|
-
Requires-Dist: torch>=2.2.0; extra == "search"
|
|
30
|
-
Requires-Dist: scikit-learn<2.0.0,>=1.3.0; extra == "search"
|
|
31
|
-
Requires-Dist: geoopt>=0.5.0; extra == "search"
|
|
32
|
-
Provides-Extra: ui
|
|
33
|
-
Requires-Dist: fastapi<1.0.0,>=0.109.0; extra == "ui"
|
|
34
|
-
Requires-Dist: uvicorn[standard]<1.0.0,>=0.27.0; extra == "ui"
|
|
35
|
-
Requires-Dist: python-multipart<1.0.0,>=0.0.6; extra == "ui"
|
|
36
|
-
Provides-Extra: learning
|
|
37
|
-
Requires-Dist: lightgbm<5.0.0,>=4.0.0; extra == "learning"
|
|
38
|
-
Provides-Extra: performance
|
|
39
|
-
Requires-Dist: diskcache<6.0.0,>=5.6.0; extra == "performance"
|
|
40
|
-
Requires-Dist: orjson<4.0.0,>=3.9.0; extra == "performance"
|
|
41
|
-
Provides-Extra: full
|
|
42
|
-
Requires-Dist: superlocalmemory[learning,performance,search,ui]; extra == "full"
|
|
43
|
-
Provides-Extra: dev
|
|
44
|
-
Requires-Dist: pytest>=8.0; extra == "dev"
|
|
45
|
-
Requires-Dist: pytest-cov>=4.1; extra == "dev"
|
|
46
|
-
Dynamic: license-file
|
|
47
|
-
|
|
48
|
-
<p align="center">
|
|
49
|
-
<img src="https://superlocalmemory.com/assets/logo-mark.png" alt="SuperLocalMemory" width="200"/>
|
|
50
|
-
</p>
|
|
51
|
-
|
|
52
|
-
<h1 align="center">SuperLocalMemory V3</h1>
|
|
53
|
-
<p align="center"><strong>The first local-only AI memory to break 74% retrieval on LoCoMo.<br/>No cloud. No APIs. No data leaves your machine.</strong></p>
|
|
54
|
-
|
|
55
|
-
<p align="center">
|
|
56
|
-
<code>+16pp vs Mem0 (zero cloud)</code> · <code>85% Open-Domain (best of any system)</code> · <code>EU AI Act Ready</code>
|
|
57
|
-
</p>
|
|
58
|
-
|
|
59
|
-
<p align="center">
|
|
60
|
-
<a href="https://arxiv.org/abs/2603.14588"><img src="https://img.shields.io/badge/arXiv-2603.14588-b31b1b?style=for-the-badge&logo=arxiv&logoColor=white" alt="arXiv Paper"/></a>
|
|
61
|
-
<a href="https://pypi.org/project/superlocalmemory/"><img src="https://img.shields.io/pypi/v/superlocalmemory?style=for-the-badge&logo=pypi&logoColor=white" alt="PyPI"/></a>
|
|
62
|
-
<a href="https://www.npmjs.com/package/superlocalmemory"><img src="https://img.shields.io/npm/v/superlocalmemory?style=for-the-badge&logo=npm&logoColor=white" alt="npm"/></a>
|
|
63
|
-
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green?style=for-the-badge" alt="MIT License"/></a>
|
|
64
|
-
<a href="#eu-ai-act-compliance"><img src="https://img.shields.io/badge/EU_AI_Act-Compliant-brightgreen?style=for-the-badge" alt="EU AI Act"/></a>
|
|
65
|
-
<a href="https://superlocalmemory.com"><img src="https://img.shields.io/badge/Web-superlocalmemory.com-ff6b35?style=for-the-badge" alt="Website"/></a>
|
|
66
|
-
</p>
|
|
67
|
-
|
|
68
|
-
---
|
|
69
|
-
|
|
70
|
-
## Why SuperLocalMemory?
|
|
71
|
-
|
|
72
|
-
Every major AI memory system — Mem0, Zep, Letta, EverMemOS — sends your data to cloud LLMs for core operations. That means latency on every query, cost on every interaction, and after **August 2, 2026**, a compliance problem under the EU AI Act.
|
|
73
|
-
|
|
74
|
-
SuperLocalMemory V3 takes a different approach: **mathematics instead of cloud compute.** Three techniques from differential geometry, algebraic topology, and stochastic analysis replace the work that other systems need LLMs to do — similarity scoring, contradiction detection, and lifecycle management. The result is an agent memory that runs entirely on your machine, on CPU, with no API keys, and still outperforms funded alternatives.
|
|
75
|
-
|
|
76
|
-
**The numbers** (evaluated on [LoCoMo](https://arxiv.org/abs/2402.09714), the standard long-conversation memory benchmark):
|
|
77
|
-
|
|
78
|
-
| System | Score | Cloud Required | Open Source | Funding |
|
|
79
|
-
|:-------|:-----:|:--------------:|:-----------:|:-------:|
|
|
80
|
-
| EverMemOS | 92.3% | Yes | No | — |
|
|
81
|
-
| Hindsight | 89.6% | Yes | No | — |
|
|
82
|
-
| **SLM V3 Mode C** | **87.7%** | Optional | **Yes (MIT)** | $0 |
|
|
83
|
-
| Zep v3 | 85.2% | Yes | Deprecated | $35M |
|
|
84
|
-
| **SLM V3 Mode A** | **74.8%** | **No** | **Yes (MIT)** | $0 |
|
|
85
|
-
| Mem0 | 64.2% | Yes | Partial | $24M |
|
|
86
|
-
|
|
87
|
-
Mode A scores **74.8% with zero cloud dependency** — outperforming Mem0 by 16 percentage points without a single API call. On open-domain questions, Mode A scores **85.0% — the highest of any system in the evaluation**, including cloud-powered ones. Mode C reaches **87.7%**, matching enterprise cloud systems.
|
|
88
|
-
|
|
89
|
-
Mathematical layers contribute **+12.7 percentage points** on average across 6 conversations (n=832 questions), with up to **+19.9pp on the most challenging dialogues**. This isn't more compute — it's better math.
|
|
90
|
-
|
|
91
|
-
> **Upgrading from V2 (2.8.6)?** V3 is a complete architectural reinvention — new mathematical engine, new retrieval pipeline, new storage schema. Your existing data is preserved but requires migration. After installing V3, run `slm migrate` to upgrade your data. Read the [Migration Guide](https://github.com/qualixar/superlocalmemory/wiki/Migration-from-V2) before upgrading. Backup is created automatically.
|
|
92
|
-
|
|
93
|
-
---
|
|
94
|
-
|
|
95
|
-
## Quick Start
|
|
96
|
-
|
|
97
|
-
### Install via npm (recommended)
|
|
98
|
-
|
|
99
|
-
```bash
|
|
100
|
-
npm install -g superlocalmemory
|
|
101
|
-
slm setup # Choose mode (A/B/C)
|
|
102
|
-
slm warmup # Pre-download embedding model (~500MB, optional)
|
|
103
|
-
```
|
|
104
|
-
|
|
105
|
-
### Install via pip
|
|
106
|
-
|
|
107
|
-
```bash
|
|
108
|
-
pip install superlocalmemory
|
|
109
|
-
```
|
|
110
|
-
|
|
111
|
-
### First Use
|
|
112
|
-
|
|
113
|
-
```bash
|
|
114
|
-
slm remember "Alice works at Google as a Staff Engineer"
|
|
115
|
-
slm recall "What does Alice do?"
|
|
116
|
-
slm status
|
|
117
|
-
```
|
|
118
|
-
|
|
119
|
-
### MCP Integration (Claude, Cursor, Windsurf, VS Code, etc.)
|
|
120
|
-
|
|
121
|
-
```json
|
|
122
|
-
{
|
|
123
|
-
"mcpServers": {
|
|
124
|
-
"superlocalmemory": {
|
|
125
|
-
"command": "slm",
|
|
126
|
-
"args": ["mcp"]
|
|
127
|
-
}
|
|
128
|
-
}
|
|
129
|
-
}
|
|
130
|
-
```
|
|
131
|
-
|
|
132
|
-
24 MCP tools available. Works with Claude Code, Cursor, Windsurf, VS Code Copilot, Continue, Cody, ChatGPT Desktop, Gemini CLI, JetBrains, Zed, and 17+ AI tools.
|
|
133
|
-
|
|
134
|
-
---
|
|
135
|
-
|
|
136
|
-
## Three Operating Modes
|
|
137
|
-
|
|
138
|
-
| Mode | What | Cloud? | EU AI Act | Best For |
|
|
139
|
-
|:----:|:-----|:------:|:---------:|:---------|
|
|
140
|
-
| **A** | Local Guardian | **None** | **Compliant** | Privacy-first, air-gapped, enterprise |
|
|
141
|
-
| **B** | Smart Local | Local only (Ollama) | Compliant | Better answers, data stays local |
|
|
142
|
-
| **C** | Full Power | Cloud LLM | Partial | Maximum accuracy, research |
|
|
143
|
-
|
|
144
|
-
```bash
|
|
145
|
-
slm mode a # Zero-cloud (default)
|
|
146
|
-
slm mode b # Local Ollama
|
|
147
|
-
slm mode c # Cloud LLM
|
|
148
|
-
```
|
|
149
|
-
|
|
150
|
-
**Mode A** is the only agent memory that operates with **zero cloud dependency** while achieving competitive retrieval accuracy on a standard benchmark. All data stays on your device. No API keys. No GPU. Runs on 2 vCPUs + 4GB RAM.
|
|
151
|
-
|
|
152
|
-
---
|
|
153
|
-
|
|
154
|
-
## Architecture
|
|
155
|
-
|
|
156
|
-
```
|
|
157
|
-
Query ──► Strategy Classifier ──► 4 Parallel Channels:
|
|
158
|
-
├── Semantic (Fisher-Rao geodesic distance)
|
|
159
|
-
├── BM25 (keyword matching)
|
|
160
|
-
├── Entity Graph (spreading activation, 3 hops)
|
|
161
|
-
└── Temporal (date-aware retrieval)
|
|
162
|
-
│
|
|
163
|
-
RRF Fusion (k=60)
|
|
164
|
-
│
|
|
165
|
-
Scene Expansion + Bridge Discovery
|
|
166
|
-
│
|
|
167
|
-
Cross-Encoder Reranking
|
|
168
|
-
│
|
|
169
|
-
◄── Top-K Results with channel scores
|
|
170
|
-
```
|
|
171
|
-
|
|
172
|
-
### Mathematical Foundations
|
|
173
|
-
|
|
174
|
-
Three novel contributions replace cloud LLM dependency with mathematical guarantees:
|
|
175
|
-
|
|
176
|
-
1. **Fisher-Rao Retrieval Metric** — Similarity scoring derived from the Fisher information structure of diagonal Gaussian families. Graduated ramp from cosine to geodesic distance over the first 10 accesses. The first application of information geometry to agent memory retrieval.
|
|
177
|
-
|
|
178
|
-
2. **Sheaf Cohomology for Consistency** — Algebraic topology detects contradictions by computing coboundary norms on the knowledge graph. The first algebraic guarantee for contradiction detection in agent memory.
|
|
179
|
-
|
|
180
|
-
3. **Riemannian Langevin Lifecycle** — Memory positions evolve on the Poincare ball via discretized Langevin SDE. Frequently accessed memories stay active; neglected memories self-archive. No hardcoded thresholds.
|
|
181
|
-
|
|
182
|
-
These three layers collectively yield **+12.7pp average improvement** over the engineering-only baseline, with the Fisher metric alone contributing **+10.8pp** on the hardest conversations.
|
|
183
|
-
|
|
184
|
-
---
|
|
185
|
-
|
|
186
|
-
## Benchmarks
|
|
187
|
-
|
|
188
|
-
Evaluated on [LoCoMo](https://arxiv.org/abs/2402.09714) — 10 multi-session conversations, 1,986 total questions, 4 scored categories.
|
|
189
|
-
|
|
190
|
-
### Mode A (Zero-Cloud, 10 Conversations, 1,276 Questions)
|
|
191
|
-
|
|
192
|
-
| Category | Score | vs. Mem0 (64.2%) |
|
|
193
|
-
|:---------|:-----:|:-----------------:|
|
|
194
|
-
| Single-Hop | 72.0% | +3.0pp |
|
|
195
|
-
| Multi-Hop | 70.3% | +8.6pp |
|
|
196
|
-
| Temporal | 80.0% | +21.7pp |
|
|
197
|
-
| **Open-Domain** | **85.0%** | **+35.0pp** |
|
|
198
|
-
| **Aggregate** | **74.8%** | **+10.6pp** |
|
|
199
|
-
|
|
200
|
-
Mode A achieves **85.0% on open-domain questions — the highest of any system in the evaluation**, including cloud-powered ones.
|
|
201
|
-
|
|
202
|
-
### Math Layer Impact (6 Conversations, n=832)
|
|
203
|
-
|
|
204
|
-
| Conversation | With Math | Without | Delta |
|
|
205
|
-
|:-------------|:---------:|:-------:|:-----:|
|
|
206
|
-
| Easiest | 78.5% | 71.2% | +7.3pp |
|
|
207
|
-
| Hardest | 64.2% | 44.3% | **+19.9pp** |
|
|
208
|
-
| **Average** | **71.7%** | **58.9%** | **+12.7pp** |
|
|
209
|
-
|
|
210
|
-
Mathematical layers help most where heuristic methods struggle — the harder the conversation, the bigger the improvement.
|
|
211
|
-
|
|
212
|
-
### Ablation (What Each Component Contributes)
|
|
213
|
-
|
|
214
|
-
| Removed | Impact |
|
|
215
|
-
|:--------|:------:|
|
|
216
|
-
| Cross-encoder reranking | **-30.7pp** |
|
|
217
|
-
| Fisher-Rao metric | **-10.8pp** |
|
|
218
|
-
| All math layers | **-7.6pp** |
|
|
219
|
-
| BM25 channel | **-6.5pp** |
|
|
220
|
-
| Sheaf consistency | -1.7pp |
|
|
221
|
-
| Entity graph | -1.0pp |
|
|
222
|
-
|
|
223
|
-
Full ablation details in the [Wiki](https://github.com/qualixar/superlocalmemory/wiki/Benchmarks).
|
|
224
|
-
|
|
225
|
-
---
|
|
226
|
-
|
|
227
|
-
## EU AI Act Compliance
|
|
228
|
-
|
|
229
|
-
The EU AI Act (Regulation 2024/1689) takes full effect **August 2, 2026**. Every AI memory system that sends personal data to cloud LLMs for core operations has a compliance question to answer.
|
|
230
|
-
|
|
231
|
-
| Requirement | Mode A | Mode B | Mode C |
|
|
232
|
-
|:------------|:------:|:------:|:------:|
|
|
233
|
-
| Data sovereignty (Art. 10) | **Pass** | **Pass** | Requires DPA |
|
|
234
|
-
| Right to erasure (GDPR Art. 17) | **Pass** | **Pass** | **Pass** |
|
|
235
|
-
| Transparency (Art. 13) | **Pass** | **Pass** | **Pass** |
|
|
236
|
-
| No network calls during memory ops | **Yes** | **Yes** | No |
|
|
237
|
-
|
|
238
|
-
To the best of our knowledge, **no existing agent memory system addresses EU AI Act compliance**. Modes A and B pass all checks by architectural design — no personal data leaves the device during any memory operation.
|
|
239
|
-
|
|
240
|
-
Built-in compliance tools: GDPR Article 15/17 export + complete erasure, tamper-proof SHA-256 audit chain, data provenance tracking, ABAC policy enforcement.
|
|
241
|
-
|
|
242
|
-
---
|
|
243
|
-
|
|
244
|
-
## Web Dashboard
|
|
245
|
-
|
|
246
|
-
```bash
|
|
247
|
-
slm dashboard # Opens at http://localhost:8765
|
|
248
|
-
```
|
|
249
|
-
|
|
250
|
-
<details open>
|
|
251
|
-
<summary><strong>Dashboard Screenshots</strong> (click to collapse)</summary>
|
|
252
|
-
<p align="center"><img src="docs/screenshots/01-dashboard-main.png" alt="Dashboard" width="600"/></p>
|
|
253
|
-
<p align="center">
|
|
254
|
-
<img src="docs/screenshots/02-knowledge-graph.png" alt="Graph" width="190"/>
|
|
255
|
-
<img src="docs/screenshots/03-math-health.png" alt="Math" width="190"/>
|
|
256
|
-
<img src="docs/screenshots/05-trust-dashboard.png" alt="Trust" width="190"/>
|
|
257
|
-
</p>
|
|
258
|
-
<p align="center">
|
|
259
|
-
<img src="docs/screenshots/04-recall-lab.png" alt="Recall" width="190"/>
|
|
260
|
-
<img src="docs/screenshots/06-settings.png" alt="Settings" width="190"/>
|
|
261
|
-
<img src="docs/screenshots/07-memories-blurred.png" alt="Memories" width="190"/>
|
|
262
|
-
</p>
|
|
263
|
-
</details>
|
|
264
|
-
|
|
265
|
-
17 tabs: Dashboard, Recall Lab, Knowledge Graph, Memories, Trust Scores, Math Health, Compliance, Learning, IDE Connections, Settings, and more. Runs locally — no data leaves your machine.
|
|
266
|
-
|
|
267
|
-
---
|
|
268
|
-
|
|
269
|
-
## Features
|
|
270
|
-
|
|
271
|
-
### Retrieval
|
|
272
|
-
- 4-channel hybrid: Semantic (Fisher-Rao) + BM25 + Entity Graph + Temporal
|
|
273
|
-
- RRF fusion + cross-encoder reranking
|
|
274
|
-
- Agentic sufficiency verification (auto-retry on weak results)
|
|
275
|
-
- Adaptive ranking with LightGBM (learns from usage)
|
|
276
|
-
|
|
277
|
-
### Intelligence
|
|
278
|
-
- 11-step ingestion pipeline (entity resolution, fact extraction, emotional tagging, scene building)
|
|
279
|
-
- Automatic contradiction detection via sheaf cohomology
|
|
280
|
-
- Self-organizing memory lifecycle (no hardcoded thresholds)
|
|
281
|
-
- Behavioral pattern detection and outcome tracking
|
|
282
|
-
|
|
283
|
-
### Trust & Security
|
|
284
|
-
- Bayesian Beta-distribution trust scoring (per-agent, per-fact)
|
|
285
|
-
- Trust gates (block low-trust agents from writing/deleting)
|
|
286
|
-
- ABAC (Attribute-Based Access Control) with DB-persisted policies
|
|
287
|
-
- Tamper-proof hash-chain audit trail (SHA-256 linked entries)
|
|
288
|
-
|
|
289
|
-
### Infrastructure
|
|
290
|
-
- 17-tab web dashboard with real-time visualization
|
|
291
|
-
- 17+ IDE integrations (Claude, Cursor, Windsurf, VS Code, JetBrains, Zed, etc.)
|
|
292
|
-
- 24 MCP tools + 6 MCP resources
|
|
293
|
-
- Profile isolation (independent memory spaces)
|
|
294
|
-
- 1400+ tests, MIT license, cross-platform (Mac/Linux/Windows)
|
|
295
|
-
- CPU-only — no GPU required
|
|
296
|
-
|
|
297
|
-
---
|
|
298
|
-
|
|
299
|
-
## CLI Reference
|
|
300
|
-
|
|
301
|
-
| Command | What It Does |
|
|
302
|
-
|:--------|:-------------|
|
|
303
|
-
| `slm remember "..."` | Store a memory |
|
|
304
|
-
| `slm recall "..."` | Search memories |
|
|
305
|
-
| `slm forget "..."` | Delete matching memories |
|
|
306
|
-
| `slm trace "..."` | Recall with per-channel score breakdown |
|
|
307
|
-
| `slm status` | System status |
|
|
308
|
-
| `slm health` | Math layer health (Fisher, Sheaf, Langevin) |
|
|
309
|
-
| `slm mode a/b/c` | Switch operating mode |
|
|
310
|
-
| `slm setup` | Interactive first-time wizard |
|
|
311
|
-
| `slm warmup` | Pre-download embedding model |
|
|
312
|
-
| `slm migrate` | V2 to V3 migration |
|
|
313
|
-
| `slm dashboard` | Launch web dashboard |
|
|
314
|
-
| `slm mcp` | Start MCP server (for IDE integration) |
|
|
315
|
-
| `slm connect` | Configure IDE integrations |
|
|
316
|
-
| `slm profile list/create/switch` | Profile management |
|
|
317
|
-
|
|
318
|
-
---
|
|
319
|
-
|
|
320
|
-
## Research Papers
|
|
321
|
-
|
|
322
|
-
### V3: Information-Geometric Foundations
|
|
323
|
-
> **SuperLocalMemory V3: Information-Geometric Foundations for Zero-LLM Enterprise Agent Memory**
|
|
324
|
-
> Varun Pratap Bhardwaj (2026)
|
|
325
|
-
> [arXiv:2603.14588](https://arxiv.org/abs/2603.14588) · [Zenodo DOI: 10.5281/zenodo.19038659](https://zenodo.org/records/19038659)
|
|
326
|
-
|
|
327
|
-
### V2: Architecture & Engineering
|
|
328
|
-
> **SuperLocalMemory: A Structured Local Memory Architecture for Persistent AI Agent Context**
|
|
329
|
-
> Varun Pratap Bhardwaj (2026)
|
|
330
|
-
> [arXiv:2603.02240](https://arxiv.org/abs/2603.02240) · [Zenodo DOI: 10.5281/zenodo.18709670](https://zenodo.org/records/18709670)
|
|
331
|
-
|
|
332
|
-
### Cite This Work
|
|
333
|
-
|
|
334
|
-
```bibtex
|
|
335
|
-
@article{bhardwaj2026slmv3,
|
|
336
|
-
title={Information-Geometric Foundations for Zero-LLM Enterprise Agent Memory},
|
|
337
|
-
author={Bhardwaj, Varun Pratap},
|
|
338
|
-
journal={arXiv preprint arXiv:2603.14588},
|
|
339
|
-
year={2026},
|
|
340
|
-
url={https://arxiv.org/abs/2603.14588}
|
|
341
|
-
}
|
|
342
|
-
```
|
|
343
|
-
|
|
344
|
-
---
|
|
345
|
-
|
|
346
|
-
## Prerequisites
|
|
347
|
-
|
|
348
|
-
| Requirement | Version | Why |
|
|
349
|
-
|:-----------|:--------|:----|
|
|
350
|
-
| **Node.js** | 14+ | npm package manager |
|
|
351
|
-
| **Python** | 3.11+ | V3 engine runtime |
|
|
352
|
-
|
|
353
|
-
All Python dependencies install automatically during `npm install`. If anything fails, the installer shows exact fix commands. BM25 keyword search works even without embeddings — you're never fully blocked.
|
|
354
|
-
|
|
355
|
-
| Component | Size | When |
|
|
356
|
-
|:----------|:-----|:-----|
|
|
357
|
-
| Core libraries (numpy, scipy, networkx) | ~50MB | During install |
|
|
358
|
-
| Search engine (sentence-transformers, torch) | ~200MB | During install |
|
|
359
|
-
| Embedding model (nomic-embed-text-v1.5, 768d) | ~500MB | First use or `slm warmup` |
|
|
360
|
-
|
|
361
|
-
---
|
|
362
|
-
|
|
363
|
-
## Contributing
|
|
364
|
-
|
|
365
|
-
See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. [Wiki](https://github.com/qualixar/superlocalmemory/wiki) for detailed documentation.
|
|
366
|
-
|
|
367
|
-
## License
|
|
368
|
-
|
|
369
|
-
MIT License. See [LICENSE](LICENSE).
|
|
370
|
-
|
|
371
|
-
## Attribution
|
|
372
|
-
|
|
373
|
-
Part of [Qualixar](https://qualixar.com) · Author: [Varun Pratap Bhardwaj](https://varunpratap.com)
|
|
374
|
-
|
|
375
|
-
---
|
|
376
|
-
|
|
377
|
-
<p align="center">
|
|
378
|
-
<sub>Built with mathematical rigor. Not in the race — here to help everyone build better AI memory systems.</sub>
|
|
379
|
-
</p>
|
|
@@ -1,162 +0,0 @@
|
|
|
1
|
-
AUTHORS.md
|
|
2
|
-
LICENSE
|
|
3
|
-
NOTICE
|
|
4
|
-
README.md
|
|
5
|
-
pyproject.toml
|
|
6
|
-
src/superlocalmemory/__init__.py
|
|
7
|
-
src/superlocalmemory.egg-info/PKG-INFO
|
|
8
|
-
src/superlocalmemory.egg-info/SOURCES.txt
|
|
9
|
-
src/superlocalmemory.egg-info/dependency_links.txt
|
|
10
|
-
src/superlocalmemory.egg-info/entry_points.txt
|
|
11
|
-
src/superlocalmemory.egg-info/requires.txt
|
|
12
|
-
src/superlocalmemory.egg-info/top_level.txt
|
|
13
|
-
src/superlocalmemory/attribution/__init__.py
|
|
14
|
-
src/superlocalmemory/attribution/mathematical_dna.py
|
|
15
|
-
src/superlocalmemory/attribution/signer.py
|
|
16
|
-
src/superlocalmemory/attribution/watermark.py
|
|
17
|
-
src/superlocalmemory/cli/__init__.py
|
|
18
|
-
src/superlocalmemory/cli/commands.py
|
|
19
|
-
src/superlocalmemory/cli/main.py
|
|
20
|
-
src/superlocalmemory/cli/migrate_cmd.py
|
|
21
|
-
src/superlocalmemory/cli/post_install.py
|
|
22
|
-
src/superlocalmemory/cli/setup_wizard.py
|
|
23
|
-
src/superlocalmemory/compliance/__init__.py
|
|
24
|
-
src/superlocalmemory/compliance/abac.py
|
|
25
|
-
src/superlocalmemory/compliance/audit.py
|
|
26
|
-
src/superlocalmemory/compliance/eu_ai_act.py
|
|
27
|
-
src/superlocalmemory/compliance/gdpr.py
|
|
28
|
-
src/superlocalmemory/compliance/lifecycle.py
|
|
29
|
-
src/superlocalmemory/compliance/retention.py
|
|
30
|
-
src/superlocalmemory/compliance/scheduler.py
|
|
31
|
-
src/superlocalmemory/core/__init__.py
|
|
32
|
-
src/superlocalmemory/core/config.py
|
|
33
|
-
src/superlocalmemory/core/embedding_worker.py
|
|
34
|
-
src/superlocalmemory/core/embeddings.py
|
|
35
|
-
src/superlocalmemory/core/engine.py
|
|
36
|
-
src/superlocalmemory/core/hooks.py
|
|
37
|
-
src/superlocalmemory/core/maintenance.py
|
|
38
|
-
src/superlocalmemory/core/modes.py
|
|
39
|
-
src/superlocalmemory/core/profiles.py
|
|
40
|
-
src/superlocalmemory/core/recall_worker.py
|
|
41
|
-
src/superlocalmemory/core/registry.py
|
|
42
|
-
src/superlocalmemory/core/summarizer.py
|
|
43
|
-
src/superlocalmemory/core/worker_pool.py
|
|
44
|
-
src/superlocalmemory/dynamics/__init__.py
|
|
45
|
-
src/superlocalmemory/dynamics/fisher_langevin_coupling.py
|
|
46
|
-
src/superlocalmemory/encoding/__init__.py
|
|
47
|
-
src/superlocalmemory/encoding/consolidator.py
|
|
48
|
-
src/superlocalmemory/encoding/emotional.py
|
|
49
|
-
src/superlocalmemory/encoding/entity_resolver.py
|
|
50
|
-
src/superlocalmemory/encoding/entropy_gate.py
|
|
51
|
-
src/superlocalmemory/encoding/fact_extractor.py
|
|
52
|
-
src/superlocalmemory/encoding/foresight.py
|
|
53
|
-
src/superlocalmemory/encoding/graph_builder.py
|
|
54
|
-
src/superlocalmemory/encoding/observation_builder.py
|
|
55
|
-
src/superlocalmemory/encoding/scene_builder.py
|
|
56
|
-
src/superlocalmemory/encoding/signal_inference.py
|
|
57
|
-
src/superlocalmemory/encoding/temporal_parser.py
|
|
58
|
-
src/superlocalmemory/encoding/type_router.py
|
|
59
|
-
src/superlocalmemory/hooks/__init__.py
|
|
60
|
-
src/superlocalmemory/hooks/auto_capture.py
|
|
61
|
-
src/superlocalmemory/hooks/auto_recall.py
|
|
62
|
-
src/superlocalmemory/hooks/ide_connector.py
|
|
63
|
-
src/superlocalmemory/hooks/rules_engine.py
|
|
64
|
-
src/superlocalmemory/infra/__init__.py
|
|
65
|
-
src/superlocalmemory/infra/auth_middleware.py
|
|
66
|
-
src/superlocalmemory/infra/backup.py
|
|
67
|
-
src/superlocalmemory/infra/cache_manager.py
|
|
68
|
-
src/superlocalmemory/infra/event_bus.py
|
|
69
|
-
src/superlocalmemory/infra/rate_limiter.py
|
|
70
|
-
src/superlocalmemory/infra/webhook_dispatcher.py
|
|
71
|
-
src/superlocalmemory/learning/__init__.py
|
|
72
|
-
src/superlocalmemory/learning/adaptive.py
|
|
73
|
-
src/superlocalmemory/learning/behavioral.py
|
|
74
|
-
src/superlocalmemory/learning/behavioral_listener.py
|
|
75
|
-
src/superlocalmemory/learning/bootstrap.py
|
|
76
|
-
src/superlocalmemory/learning/cross_project.py
|
|
77
|
-
src/superlocalmemory/learning/database.py
|
|
78
|
-
src/superlocalmemory/learning/engagement.py
|
|
79
|
-
src/superlocalmemory/learning/features.py
|
|
80
|
-
src/superlocalmemory/learning/feedback.py
|
|
81
|
-
src/superlocalmemory/learning/outcomes.py
|
|
82
|
-
src/superlocalmemory/learning/project_context.py
|
|
83
|
-
src/superlocalmemory/learning/ranker.py
|
|
84
|
-
src/superlocalmemory/learning/source_quality.py
|
|
85
|
-
src/superlocalmemory/learning/workflows.py
|
|
86
|
-
src/superlocalmemory/llm/__init__.py
|
|
87
|
-
src/superlocalmemory/llm/backbone.py
|
|
88
|
-
src/superlocalmemory/math/__init__.py
|
|
89
|
-
src/superlocalmemory/math/fisher.py
|
|
90
|
-
src/superlocalmemory/math/langevin.py
|
|
91
|
-
src/superlocalmemory/math/sheaf.py
|
|
92
|
-
src/superlocalmemory/mcp/__init__.py
|
|
93
|
-
src/superlocalmemory/mcp/resources.py
|
|
94
|
-
src/superlocalmemory/mcp/server.py
|
|
95
|
-
src/superlocalmemory/mcp/tools.py
|
|
96
|
-
src/superlocalmemory/mcp/tools_core.py
|
|
97
|
-
src/superlocalmemory/mcp/tools_v28.py
|
|
98
|
-
src/superlocalmemory/mcp/tools_v3.py
|
|
99
|
-
src/superlocalmemory/retrieval/__init__.py
|
|
100
|
-
src/superlocalmemory/retrieval/agentic.py
|
|
101
|
-
src/superlocalmemory/retrieval/ann_index.py
|
|
102
|
-
src/superlocalmemory/retrieval/bm25_channel.py
|
|
103
|
-
src/superlocalmemory/retrieval/bridge_discovery.py
|
|
104
|
-
src/superlocalmemory/retrieval/engine.py
|
|
105
|
-
src/superlocalmemory/retrieval/entity_channel.py
|
|
106
|
-
src/superlocalmemory/retrieval/fusion.py
|
|
107
|
-
src/superlocalmemory/retrieval/profile_channel.py
|
|
108
|
-
src/superlocalmemory/retrieval/reranker.py
|
|
109
|
-
src/superlocalmemory/retrieval/semantic_channel.py
|
|
110
|
-
src/superlocalmemory/retrieval/strategy.py
|
|
111
|
-
src/superlocalmemory/retrieval/temporal_channel.py
|
|
112
|
-
src/superlocalmemory/server/__init__.py
|
|
113
|
-
src/superlocalmemory/server/api.py
|
|
114
|
-
src/superlocalmemory/server/security_middleware.py
|
|
115
|
-
src/superlocalmemory/server/ui.py
|
|
116
|
-
src/superlocalmemory/server/routes/__init__.py
|
|
117
|
-
src/superlocalmemory/server/routes/agents.py
|
|
118
|
-
src/superlocalmemory/server/routes/backup.py
|
|
119
|
-
src/superlocalmemory/server/routes/behavioral.py
|
|
120
|
-
src/superlocalmemory/server/routes/compliance.py
|
|
121
|
-
src/superlocalmemory/server/routes/data_io.py
|
|
122
|
-
src/superlocalmemory/server/routes/events.py
|
|
123
|
-
src/superlocalmemory/server/routes/helpers.py
|
|
124
|
-
src/superlocalmemory/server/routes/learning.py
|
|
125
|
-
src/superlocalmemory/server/routes/lifecycle.py
|
|
126
|
-
src/superlocalmemory/server/routes/memories.py
|
|
127
|
-
src/superlocalmemory/server/routes/profiles.py
|
|
128
|
-
src/superlocalmemory/server/routes/stats.py
|
|
129
|
-
src/superlocalmemory/server/routes/v3_api.py
|
|
130
|
-
src/superlocalmemory/server/routes/ws.py
|
|
131
|
-
src/superlocalmemory/storage/__init__.py
|
|
132
|
-
src/superlocalmemory/storage/access_control.py
|
|
133
|
-
src/superlocalmemory/storage/database.py
|
|
134
|
-
src/superlocalmemory/storage/migrations.py
|
|
135
|
-
src/superlocalmemory/storage/models.py
|
|
136
|
-
src/superlocalmemory/storage/schema.py
|
|
137
|
-
src/superlocalmemory/storage/v2_migrator.py
|
|
138
|
-
src/superlocalmemory/trust/__init__.py
|
|
139
|
-
src/superlocalmemory/trust/gate.py
|
|
140
|
-
src/superlocalmemory/trust/provenance.py
|
|
141
|
-
src/superlocalmemory/trust/scorer.py
|
|
142
|
-
src/superlocalmemory/trust/signals.py
|
|
143
|
-
tests/test_auto_hooks.py
|
|
144
|
-
tests/test_behavioral_full.py
|
|
145
|
-
tests/test_cli.py
|
|
146
|
-
tests/test_compliance_full.py
|
|
147
|
-
tests/test_config_system.py
|
|
148
|
-
tests/test_engine_hooks.py
|
|
149
|
-
tests/test_event_bus.py
|
|
150
|
-
tests/test_features.py
|
|
151
|
-
tests/test_final_locomo_mini.py
|
|
152
|
-
tests/test_ide_connector.py
|
|
153
|
-
tests/test_infra.py
|
|
154
|
-
tests/test_learning_advanced.py
|
|
155
|
-
tests/test_learning_collectors.py
|
|
156
|
-
tests/test_llm_provider.py
|
|
157
|
-
tests/test_mcp_server.py
|
|
158
|
-
tests/test_migration.py
|
|
159
|
-
tests/test_post_install.py
|
|
160
|
-
tests/test_ranker.py
|
|
161
|
-
tests/test_trust_full.py
|
|
162
|
-
tests/test_v3_api.py
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
|
|
@@ -1,35 +0,0 @@
|
|
|
1
|
-
httpx>=0.24.0
|
|
2
|
-
numpy<3.0.0,>=1.26.0
|
|
3
|
-
scipy<2.0.0,>=1.12.0
|
|
4
|
-
networkx>=3.0
|
|
5
|
-
mcp>=1.0.0
|
|
6
|
-
python-dateutil>=2.9.0.post0
|
|
7
|
-
rank-bm25>=0.2.2
|
|
8
|
-
vadersentiment>=3.3.2
|
|
9
|
-
einops>=0.8.2
|
|
10
|
-
|
|
11
|
-
[dev]
|
|
12
|
-
pytest>=8.0
|
|
13
|
-
pytest-cov>=4.1
|
|
14
|
-
|
|
15
|
-
[full]
|
|
16
|
-
superlocalmemory[learning,performance,search,ui]
|
|
17
|
-
|
|
18
|
-
[learning]
|
|
19
|
-
lightgbm<5.0.0,>=4.0.0
|
|
20
|
-
|
|
21
|
-
[performance]
|
|
22
|
-
diskcache<6.0.0,>=5.6.0
|
|
23
|
-
orjson<4.0.0,>=3.9.0
|
|
24
|
-
|
|
25
|
-
[search]
|
|
26
|
-
sentence-transformers<4.0.0,>=2.5.0
|
|
27
|
-
einops<1.0.0,>=0.7.0
|
|
28
|
-
torch>=2.2.0
|
|
29
|
-
scikit-learn<2.0.0,>=1.3.0
|
|
30
|
-
geoopt>=0.5.0
|
|
31
|
-
|
|
32
|
-
[ui]
|
|
33
|
-
fastapi<1.0.0,>=0.109.0
|
|
34
|
-
uvicorn[standard]<1.0.0,>=0.27.0
|
|
35
|
-
python-multipart<1.0.0,>=0.0.6
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
superlocalmemory
|
|
File without changes
|