Skip to main content

AI agent memory system with SQLite+FTS5, MCP integration, and quality gates

Project description

Engram

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

Install

pip install memorytrace

Optional extras:

pip install "memorytrace[llm]"
pip install "memorytrace[semantic]"
pip install "memorytrace[mcp]"
pip install "memorytrace[full]"

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.

Docs

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

memorytrace-0.5.0.tar.gz (345.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

memorytrace-0.5.0-py3-none-any.whl (192.5 kB view details)

Uploaded Python 3

File details

Details for the file memorytrace-0.5.0.tar.gz.

File metadata

  • Download URL: memorytrace-0.5.0.tar.gz
  • Upload date:
  • Size: 345.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.11

File hashes

Hashes for memorytrace-0.5.0.tar.gz
Algorithm Hash digest
SHA256 3b68f2d110f6acc34cf83f1187d67170fba776d3625a4579e6bb1a6f6cbbb45d
MD5 0e565e7fcd395ca2947837681d836c7b
BLAKE2b-256 0df2d5e9c68e4f8bf177aab6f202b0a54bed2eac4a546751829a56e596aff6e2

See more details on using hashes here.

File details

Details for the file memorytrace-0.5.0-py3-none-any.whl.

File metadata

  • Download URL: memorytrace-0.5.0-py3-none-any.whl
  • Upload date:
  • Size: 192.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.11

File hashes

Hashes for memorytrace-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 cf397299587b4f04c5da969519e523c9c8106f9bcff5d8ee73454322567337a2
MD5 5b76d2dacdaf8dcc98b11fb3d6dc8c75
BLAKE2b-256 96849f0e6168377171eb91b578d6a2b081860fc72638683db352143b7b573e56

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page