Import, Export & Backup

Mneno provides built-in tools for exporting memories to JSON, importing them back, and creating timestamped backups. This is essential for data migration, persistence, and disaster recovery.

Exporting Memories

You can export your entire memory store to a JSON payload or directly to a file.

# Get a JSON-serializable dictionary
payload = client.export_json()

# Export directly to a file
client.export_json("exports/my_memories.json")

The exported file includes a version field to ensure compatibility with future Mneno versions.

Importing Memories

Importing allows you to load memories from a previous export. Mneno supports several import modes to handle conflicting IDs:

# Import from a file
result = client.import_json("exports/my_memories.json", mode="append")

print(f"Imported: {result.imported_count}")
print(f"Skipped: {result.skipped_count}")

Import Modes

Mode	Description
`append`	Add memories; if an ID exists, a new unique ID is generated for the copy.
`replace`	Clear the current store first, then import everything.
`skip_existing`	Keep existing memories; don’t import anything with a conflicting ID.
`overwrite`	Replace existing memories with imported ones if they share the same ID.

Backups

Backups are a specialized form of export that use timestamped filenames by default.

# Create a backup in the 'backups/' directory
backup_path = client.backup()
print(f"Backup created at: {backup_path}")
# Output: backups/mneno-backup-20260524-120000.json

Restore

Restoring is a shortcut for a replace or append import from a backup file.

# Restore from a backup (replaces current memories by default)
client.restore("backups/mneno-backup-20260524-120000.json")

# Append from a backup instead
client.restore("backups/mneno-backup-20260524-120000.json", mode="append")

Validation

Mneno validates the format and version of all incoming JSON payloads during import. If a file is corrupted or uses an unsupported format version, Mneno will raise a clear error to prevent data corruption.

Getting Started

Core Concepts

Advanced

Import, Export & Backup

Exporting Memories

Importing Memories

Import Modes

Backups

Restore

Validation

​Exporting Memories

​Importing Memories

​Import Modes

​Backups

​Restore

​Validation

Exporting Memories

Importing Memories

Import Modes

Backups

Restore

Validation