engram-ms 1.0.0

Engram — AI agent memory system with SQLite+FTS5, MCP integration, and quality gates. Canonical distribution (formerly published as 'memorytrace').

Engram

Persistent memory for AI agents, backed by SQLite + FTS5.

Install

pip install engram-ms

Optional extras:

pip install "engram-ms[llm]"
pip install "engram-ms[semantic]"
pip install "engram-ms[mcp]"
pip install "engram-ms[full]"

The memorytrace distribution name is the legacy alias still on PyPI: pip install memorytrace installs the same engine.

Simple CLI

The default CLI is engram. python -m engram is equivalent.

engram init
engram save "Minseong Jeong is the CTO of Galaxy Corp"
engram find "CTO"
engram who "Minseong Jeong"
engram remember "Minseong Jeong" "Interested in AI and robotics"
engram status

Advanced CLI

Use engram-advanced when you need structured options, JSON output, or a custom DB path.

engram-advanced --db ~/.engram/memory.db search "Galaxy Corp" --max-results 5
engram-advanced --json health

Python SDK

from engram.integrations.sdk import EngramSDK

with EngramSDK() as sdk:
    sdk.start_session("assistant")
    sdk.store("Minseong Jeong is the CTO of Galaxy Corp")
    sdk.add_fact("Minseong Jeong", "Interested in AI and robotics")
    result = sdk.search("Galaxy")
    print(result.to_agent_context())

Source Checkout Compatibility

A repo-local python mem ... wrapper is kept for backward compatibility in source checkouts. It forwards to the same simple CLI as engram, but it is not installed as a packaged console script.

Related packages

The engram namespace on PyPI is reserved for small, focused tools that share this memory model. Sibling packages currently published from this workspace:

Package	Status	Purpose
engram-ms	canonical (0.0.x placeholder, full engine in 0.1.x)	The engram-named distribution — preferred install
memorytrace	legacy alias	The original distribution name; same engine

Docs

• docs/04-usage-guide/01-quickstart.md
• docs/01-project-analysis/05-cli-commands.md
• docs/01-project-analysis/09-setup-guide.md