- name
- mamp-memory
- description
- Mark AI Memory Protocol — persistent, searchable session memory for AI agents. SQLite-only, zero external dependencies.
- author
- LeoTseng
- version
- 1.2.1
- license
- MIT-0
- security
- credential_access
- false # Local SQLite only, no external services or credentials
- data_persistence
- true # Writes to a local .db file on disk
MAMP — Mark AI Memory Protocol
Gives AI agents persistent, searchable memory using SQLite.
When to Use
- User says "remember what I told you last time"
- Agent needs to recall facts across conversations
- User asks about past topics, preferences, or decisions
- Context window is filling up and older info needs to be summarized
Core Concepts
- Session — a conversation, has an ID, survives restarts
- Turn — one message in a session (role: user/assistant)
- Tag — labels for a turn, e.g. ["finance", "important"]
- Priority — importance level: critical, normal, trivial
Key Methods
from importlib.util import spec_from_file_location, module_from_spec
spec = spec_from_file_location("mamp", "ai_memory_protocol_v1.2.0.py")
mod = module_from_spec(spec)
spec.loader.exec_module(mod)
# Manual mode — explicit add_turn() calls
sm = mod.SessionManager()
sm.start_conversation()
sm.add_turn("user", "I prefer dark mode")
sm.add_turn("assistant", "Noted")
# Auto mode (v1.1.8+) — auto-captures turns without manual add_turn()
sm = mod.SessionManager(auto_record=True)
sm.start_conversation()
# ... conversations are recorded automatically ...
sm.stop() # flushes buffer and disables auto_record
# Heartbeat (v1.1.9+) — called externally every ~5 min via Hermes cron
# sm.heartbeat() # flushes buffer + closes idle sessions (>30 min)
# Explicit db_path (recommended)
sm = mod.SessionManager(db_path="./memory.db", auto_record=True)
# Environment variable override:
# export MARK_MEMORY_DB=/path/to/memory.dbWhat It Solves
AI forgets everything each conversation. MAMP makes memory persistent, searchable, and structured — without any external service, API key, or dependency beyond SQLite.
Security Notes
Default behavior — local directory only:
- DB file written to
./mark_memory.dbin the current working directory - No system directories are touched
- No log files, audit files, or hidden state files are written
- No network access, no external services
Pass an explicit path to isolate data:
sm = mod.SessionManager(db_path="/your/specific/path/memory.db")Environment variable override:
export MARK_MEMORY_DB=/your/specific/path/memory.dbThis takes precedence over both the default and any db_path argument.
Permissions awareness:
- The DB file contains your conversation history in plaintext
- Ensure the directory has appropriate access controls
- If multiple agents run on the same host with the same path, they share memory — use different paths per agent to isolate
No credentials stored:
MAMP uses no API keys, tokens, or secrets. It is a pure local SQLite store.