gitwtfhub

wtf is engram-lite?

engrammemory-labs/engram-lite — explained in plain English

Analysis updated 2026-05-18

27PythonAudience · developerComplexity · 2/5Setup · easy

TL;DR

engram-lite is a local, restart-proof memory system for AI agents that serves each agent only the memories matching its persona and task, running entirely on one machine.

Mindmap

mindmap
  root((engram-lite))
    What it does
      Local agent memory
      Persona based serving
      Restart proof storage
    Tech stack
      Python
      SQLite
      pip
    Use cases
      Claude Code plugin
      Hermes agent memory
      Multi agent memory sharing
    Audience
      AI agent developers
      SRE and DevOps teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Give an AI agent memory that survives restarts, stored locally in a single SQLite file.

REASON 2

Run several AI agents on one machine that share a memory store but each see only their own lane.

REASON 3

Add memory to a Claude Code session with automatic capture and retrieval via a plugin.

REASON 4

Debug why an agent did or did not remember something using the built in decision log.

What's in the stack?

PythonSQLitepip

How it stacks up

engrammemory-labs/engram-liteavbiswas/sam2-mlxchanthruu/wind_energy_monitor
Stars272727
LanguagePythonPythonPython
Setup difficultyeasymoderatemoderate
Complexity2/54/53/5
Audiencedeveloperresearcherdata

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Runs with a single pip install and no external server, a virtualenv or pipx may be needed on Homebrew Python setups.

The README does not state a license.

Wtf does this do

engram-lite is a local memory system for AI agents, meaning a tool that lets AI assistants remember facts from earlier conversations and keep that knowledge after the program restarts. Instead of giving every AI agent the same pile of memories for the same question, engram-lite serves each agent only the memories that fit who it is, based on a profile you register for it that describes its persona, its subject area, and the kind of task it handles. The README explains that feeding an agent one shared pile of memory actually caused it to make things up more often than giving it no memory at all, while serving memory this targeted way roughly doubled how often agents succeeded at their task and cut down false statements to about a third of what they were before. The whole thing runs on one machine with no cloud service, no account, and no external server. All memories are stored in a single SQLite database file, plus a local embedding model used to search that memory by meaning rather than just exact keywords. It cleans itself up over time by skipping unimportant input like plain commands, removing duplicate facts, letting newer facts replace older outdated ones, and expiring facts that go stale. Every decision the system makes about keeping, dropping, or merging a memory is logged with the reason behind it, so a user can ask why something was or was not remembered and get a real answer. Installation is done with a normal pip install, and there is a small Python library for reading and writing memories directly in code. The project also ships ready made integrations for three specific tools: a Hermes AI agent memory provider, a Claude Code plugin that hooks into prompts automatically with the user's consent, and an OpenClaw plugin, all of which can share one memory store while still keeping each agent's results scoped to what it is allowed to see. The README also describes a benchmark result on a long conversation memory test called LoCoMo, where the project scores well without making any calls to a large language model to build its memory, keeping that part of the process free to run. The project is written in Python.

Yoink these prompts

Prompt 1
Help me install engram-lite with pip and register a profile for my on-call SRE agent.
Prompt 2
Show me how to use mem.remember() and mem.search() to store and retrieve a fact in Python.
Prompt 3
Walk me through installing the Claude Code plugin for engram-lite with engram claude setup.
Prompt 4
Explain how the salience gate decides which conversation turns get stored as memories.
Prompt 5
Help me set up two agents that share one engram-lite memory store but stay scoped separately.

Frequently asked questions

wtf is engram-lite?

engram-lite is a local, restart-proof memory system for AI agents that serves each agent only the memories matching its persona and task, running entirely on one machine.

What language is engram-lite written in?

Mainly Python. The stack also includes Python, SQLite, pip.

What license does engram-lite use?

The README does not state a license.

How hard is engram-lite to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is engram-lite for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.