-
-
Notifications
You must be signed in to change notification settings - Fork 37
Modes Explained
SuperLocalMemory has three modes. All retain the local canonical memory store;
the mode selects the model/provider behavior used for configured enrichment and
retrieval work. Switch at any time with slm mode a, slm mode b, or slm mode c; stored memory is not discarded by a mode change.
| Mode | Core behavior | Model boundary | Best starting point |
|---|---|---|---|
| A — Local Guardian | Local memory, retrieval and mathematical/lifecycle components | No cloud model provider is required for core memory operations | Default for a local-first deployment |
| B — Smart Local | Mode A plus an operator-configured Ollama endpoint | The selected endpoint and enabled integrations determine the data path | Local model synthesis/enrichment |
| C — Provider-assisted | Local memory plus configured provider-backed behavior | Query, ingestion or enrichment content may be sent to the configured provider | Approved external-provider deployment |
Mode A stores and retrieves through the configured local data root. It can use semantic, BM25, temporal, Hopfield, and spreading-activation candidates when their dependencies are healthy, followed by fusion and configured scoring.
“Local core” is not an absolute network claim. Model/dependency downloads, connectors, cloud backup, proxy providers, and other integrations can use the network when explicitly enabled. Review the complete deployment before making a privacy or compliance determination.
Mode B adds a local LLM path through Ollama. The operator chooses the endpoint
and model, then verifies both with slm doctor and a representative store /
recall witness. Answer and extraction quality depend on that selected model,
the corpus, and the healthy retrieval channels.
# Install Ollama using reviewed platform instructions, then:
ollama pull llama3.2
slm mode b
slm doctorMode C enables configured provider-backed enrichment and retrieval behavior
while the canonical memory database remains local. Configure the provider with
slm provider set and use environment-managed credentials where appropriate.
The provider’s data-processing terms and the deployment’s network controls
apply to content sent through this mode.
| Capability | A | B | C |
|---|---|---|---|
| Local canonical SQLite memory | Yes | Yes | Yes |
| Multi-channel retrieval | Healthy channels participate | Healthy channels participate | Healthy channels participate |
| Local LLM endpoint | Not required | Configured Ollama | Optional/configured |
| External provider path | Not required for core memory | Not required for core memory | Configured provider path |
| Optional adapters, backup, Mesh or proxy | Explicit operator choice | Explicit operator choice | Explicit operator choice |
Use slm trace "representative query" to see the evidence and channels used
by an actual recall rather than inferring behavior from the selected mode.
Part of Qualixar | Created by Varun Pratap Bhardwaj
SuperLocalMemory V4.0.3 — Local-first memory with explicit data-path controls. Current docs: Home · Installation · CLI · MCP whole 91 (full 46) · FAQ
Part of Qualixar | Created by Varun Pratap Bhardwaj | GitHub · CHANGELOG
Platform boundary: Apple Silicon macOS · 64-bit Windows · 64-bit Linux — Intel Mac and 32-bit Windows not supported (
cryptography==50.0.0).
SuperLocalMemory V4.0.3
Getting Started
- Installation
- Quick Start Tutorial
- Getting Started
- Modes Explained
- IDE Setup
- Host Integration Upgrades
- Migration from V2
Reference
- CLI Commands
- MCP Tools — 91 whole / 58 power / 46 full / 28 code / 14 core
- Retrieval Score Contract
- Auto-Memory
- Active Memory (V3.1)
Integrations
- Framework Adapters — 9 adapters
- Bounded Loops
- Multi-Agent Memory
Architecture
- Architecture Overview — historical V3, carried into V4
- Capabilities and Operations
- Published Benchmarks — V3 LoCoMo, not a V4 rerun
- Mathematical Foundations — historical V3
-
V4 Reliability Contract — 2,200/2,200, protocol
benchmark/run_all.py --trials 200
Enterprise and Teams
V2 Documentation