For agents that can't afford to forget

The memory layer for LLM agents.

Local-first, importance-scored, auditable. Your agents keep what matters, on your infrastructure.

v1.4.1·Apache-2.0·Python 3.10+
widemem mascot
Get it right

For the facts you can't afford to get wrong.

When your agent handles a prescription, a contract, or a portfolio, "probably remembered" isn't good enough. widemem gives health, legal, and financial facts higher importance floors, decay immunity, and forced contradiction detection.

widemem works for any app where memory matters, and it earns its keep wherever getting a fact wrong is expensive.

Remember what matters.
The problem

Context windows aren't memory.

Most memory systems treat every fact the same. Your user's blood type decays at the same rate as their lunch. Contradictions pile up silently. And recalling something from three months ago is a coin flip.

What's inside

Nine things memory should do, and widemem does.

Each one earns its place. No feature theater.

[ ]

Batch Conflict Resolution

One LLM call for N facts. Not N calls. Your wallet will thank you.

/\

Importance + Decay

Facts rated 1-10. Old trivia fades. Critical facts don't.

|||

Hierarchical Memory

Facts to summaries to themes. Broad questions get themes, specific ones get facts.

?!

Active Retrieval

"Wait, you said San Francisco AND Boston?" Contradictions caught, not ignored.

<>

Full Audit Trail

Every add, update, and delete logged to SQLite with timestamps.

*****

YMYL Prioritization

Health, legal, financial facts get special treatment. Some things you just don't forget.

??

Uncertainty & Confidence

Knows when it doesn't know. Strict, helpful, or a clearly-flagged best guess.

>>>

Retrieval Modes

fast / balanced / deep. Choose your accuracy-cost tradeoff.

[!]

Memory Pinning

Pin a fact so it resists decay. For allergies, API keys, and the rule you refuse to explain again.

How it works

From raw conversation to ranked recall.

1
Extract

Pull facts from the conversation

Turn messy back-and-forth into discrete, storable facts.

2
Score

Rate importance, flag YMYL

Each fact scored 1 to 10; health, legal, and financial content flagged for special handling.

3
Resolve

Reconcile against what you already know

Every candidate checked against existing memory in a single LLM call, not one per fact.

4
Store

Persist with a full audit trail

Written to SQLite with a timestamp on every add, update, and delete.

5
Retrieve

Return ranked, hierarchical recall

Facts, summaries, or themes, each with a confidence score, matched to the question.

python
# store a fact that should never fade
mem.add("user has a peanut allergy")
# ask for it later
mem.search("allergies?")
Deploy anywhere

Run it your way.

One library, four ways to run. Your data never has to leave.

your app+ widememLocal-firstSelf-hostedManagedAir-gapped
DEFAULT

Local-first

SQLite + FAISS, zero services. Nothing to stand up, nothing to page.

Self-hosted

Your VPC or Kubernetes. Data never leaves your perimeter.

Managed hosting

We run and scale it for you as a fully managed service.

Air-gapped

No egress, fully offline. For healthcare, finance, government, and any high-security environment.

Install

One line to your first memory.

Pip is the fast path. uv, Docker, an MCP server, and source builds are all first-class.

pipuvDockerMCPsource
$ pip install widemem-ai
$ pip install "widemem-ai[all]"
# the fastest path is pip; pick your tool above
Works with
Ollamalocal-firstOpenAIAnthropicFAISSQdrantpgvectorsentence-transformers
Security & trust

Your data stays yours.

A library you run, not a black box you send secrets to.

<>Full audit trail

Every add, update, and delete is written to SQLite with timestamps. Reconstruct exactly what your agent knew and when.

[#]Self-hostable by default

Local-first and air-gap capable. Facts never have to touch a network you don't control.

(!)Vulnerability disclosure

A published security policy and a private channel for reports. We respond, patch, and credit.

{}Open source, Apache-2.0

Read the code that stores your users' facts. No hidden calls, no surprise egress.

widemem is a library you run, so your compliance boundary stays inside your own environment, backed by a full audit trail. For enterprise and regulated deployments that need certifications like SOC 2 or HIPAA, we can help you get there. Let's talk.

Proof

We publish our methodology and our corrections.

Benchmarks are only useful if you can check them. So we show ours.

We run LoCoMo openly. When we caught a scoring error in our own harness, we corrected it in public rather than quietly restating the number.

45.3254.81LoCoMo, corrected in the open

The methodology, the evaluation harness, and the correction are all documented. Verify it yourself instead of taking a headline number on faith.

Give your agents a memory that lasts.