How macpaw/portable-memory works
Portable Memory is a local-first Python SDK and CLI for moving AI memory between vendors in a verifiable .mem bundle. Users paste or ingest an export, then inspect, validate, and render it; adopters can export from or merge into their own store. The graph separates adapters, bundle workflows, and the shared format and trust primitives. Edges follow the README or sampled source references; some CLI details and other unsampled implementations are represented only at their documented boundaries.
Main entry points: cli.py CLI commands · exporter.py Bundle exporter · importer.py Bundle importer · records.py Record models
Components 19
User workflows
- CLI commands
portable_memory/cli.py
Memory adapters
- Text transfer
portable_memory/adapters/transfer.py - OpenAI adapter
portable_memory/adapters/openai.py - Claude adapter
portable_memory/adapters/claude.py - Mem0 adapter
portable_memory/adapters/mem0.py - Adapter dispatch
portable_memory/adapters/__init__.py
Bundle operations
- Bundle exporter
portable_memory/exporter.py - Bundle importer
portable_memory/importer.py - Bundle validator
portable_memory/validator.py - Store interface
portable_memory/store.py - In-memory store
portable_memory/inmemory.py
Portable format
- Bundle format
portable_memory/format.py - Record models
portable_memory/records.py - Canonical codec
portable_memory/_codec.py - Extension fields
portable_memory/interop.py
Integrity and governance
- Content hashing
portable_memory/hashing.py - Deletion records
portable_memory/tombstone.py - Ed25519 signing
portable_memory/signing.py
Other components
- Memory owner
Connections 37
- Memory owner → CLI commands: runs commands
README.md - CLI commands → Text transfer: parses pasted text
portable_memory/cli.py - CLI commands → OpenAI adapter: ingests export
portable_memory/cli.py - CLI commands → Claude adapter: ingests memory
portable_memory/cli.py - CLI commands → Mem0 adapter: ingests memories
portable_memory/cli.py - CLI commands → Adapter dispatch: dispatches adapters
portable_memory/cli.py - Adapter dispatch → Text transfer: exposes adapter
portable_memory/adapters/__init__.py - Adapter dispatch → OpenAI adapter: exposes adapter
portable_memory/adapters/__init__.py - Adapter dispatch → Claude adapter: exposes adapter
portable_memory/adapters/__init__.py - Adapter dispatch → Mem0 adapter: exposes adapter
portable_memory/adapters/__init__.py - CLI commands → Bundle exporter: exports bundle
portable_memory/cli.py - CLI commands → Bundle importer: imports bundle
portable_memory/cli.py - CLI commands → Bundle validator: validates bundle
portable_memory/cli.py - Bundle exporter → Store interface: reads records
portable_memory/exporter.py - Bundle importer → Store interface: applies records
portable_memory/importer.py - In-memory store → Store interface: implements interface
portable_memory/inmemory.py - Bundle exporter → Bundle format: writes bundle layout
portable_memory/exporter.py - Bundle importer → Bundle format: reads bundle layout
portable_memory/importer.py - Bundle validator → Bundle format: checks format
portable_memory/validator.py - Bundle exporter → Canonical codec: encodes records
portable_memory/exporter.py - Bundle importer → Canonical codec: decodes records
portable_memory/importer.py - Bundle validator → Canonical codec: decodes streams
portable_memory/validator.py - Bundle exporter → Content hashing: checksums files
portable_memory/exporter.py - Bundle validator → Content hashing: verifies checksums
portable_memory/validator.py - Bundle exporter → Extension fields: merges extensions
portable_memory/exporter.py - Bundle importer → Extension fields: preserves extensions
portable_memory/importer.py - Bundle importer → Deletion records: applies deletions
portable_memory/importer.py - Bundle exporter → Ed25519 signing: signs manifest
portable_memory/exporter.py - Bundle importer → Ed25519 signing: verifies signatures
portable_memory/importer.py - Bundle validator → Ed25519 signing: checks authenticity
portable_memory/validator.py - Text transfer → Record models: creates episodes
portable_memory/adapters/transfer.py - OpenAI adapter → Record models: creates records
portable_memory/adapters/openai.py - Claude adapter → Record models: creates records
portable_memory/adapters/claude.py - Mem0 adapter → Record models: creates records
portable_memory/adapters/mem0.py - Bundle exporter → Record models: serializes records
portable_memory/exporter.py - Bundle importer → Record models: materializes records
portable_memory/importer.py - Memory owner → CLI commands: renders memory text
README.md