Skip to content

EB-DevTech/Open-Memory-Protocol

🧠 Open Memory Protocol (OMP)

Your AI conversations belong to you.

OMP Version License: CC BY 4.0 License: Apache 2.0 PRs Welcome

A universal, vendor-neutral standard for owning, backing up, and moving your AI conversations across every platform.

Created by EB DevTech · An open standard for everyone

Read the Spec · Website · Connectors · Contributing


The Problem

You have conversations scattered across ChatGPT, Claude, Gemini, Cursor, Copilot, and more. Each platform locks your data in a proprietary format — or doesn't let you export it at all. If you switch platforms, you lose everything: every preference learned, every decision documented, every piece of context accumulated.

OMP fixes this. Think of it as the iCloud of AI — your conversations are automatically backed up, searchable across every platform, and recoverable if anything goes wrong.

How It Works

┌──────────┐     ┌──────────┐     ┌──────────┐
│ ChatGPT  │     │  Claude  │     │  Gemini  │
│ ┌──────┐ │     │ ┌──────┐ │     │ ┌──────┐ │
│ │ JSON │ │     │ │ JSON │ │     │ │Takeout│ │
│ └──┬───┘ │     │ └──┬───┘ │     │ └──┬───┘ │
└────┼─────┘     └────┼─────┘     └────┼─────┘
     │                │                │
     ▼                ▼                ▼
  ┌─────────────────────────────────────────┐
  │         OMP Connectors (convert)        │
  └─────────────────┬───────────────────────┘
                    │
                    ▼
            ┌───────────────┐
            │  .omp.zip     │  ← Universal format
            │  ┌──────────┐ │     Human-readable JSON
            │  │manifest  │ │     Self-contained
            │  │convos/   │ │     Lossless
            │  │memories/ │ │
            │  └──────────┘ │
            └───────┬───────┘
                    │
        ┌───────────┼───────────┐
        ▼           ▼           ▼
  ┌──────────┐ ┌──────────┐ ┌──────────┐
  │  Local   │ │  Cloud   │ │Self-host │
  │  Folder  │ │  Vault   │ │  Server  │
  └──────────┘ └──────────┘ └──────────┘
                Memory Hosts

Quick Start

Back Up Your ChatGPT History

# 1. Export your data from ChatGPT (Settings → Data controls → Export data)
# 2. Convert to OMP format
npx @omp/cli convert chatgpt ./conversations.json -o ./my-backup.omp.zip

# 3. Validate the archive
npx @omp/cli validate ./my-backup.omp.zip
# ✓ Valid OMP Archive: 847 conversations, 12,453 messages

Self-Host a Memory Vault

# Pull and run the reference server
docker pull ghcr.io/open-memory-protocol/omp-server:latest
docker run -p 3000:3000 -v omp-data:/data ghcr.io/open-memory-protocol/omp-server:latest

# Import your backup
curl -X POST http://localhost:3000/restore \
  -F "archive=@my-backup.omp.zip"

Use the SDK

import { OMPArchive } from '@omp/sdk';

// Parse an OMP archive
const archive = await OMPArchive.fromFile('./my-backup.omp.zip');
console.log(`${archive.conversations.length} conversations loaded`);

// Search across all conversations
const results = archive.search('database schema');
results.forEach(r => console.log(`[${r.platform}] ${r.conversation.title}`));

Core Concepts

Concept Description
Conversation A complete exchange between you and an AI — an ordered list of messages
Message A single turn: your prompt, the AI's response, a tool call, or a system instruction
Memory Record Structured intelligence derived from conversations: summaries, preferences, decisions
Memory Vault Your complete collection of OMP data, stored wherever you choose
Memory Host The service that stores your vault — local, cloud, or self-hosted
Connector Translates between a platform's native format and OMP format
OMP Archive A portable .omp.zip file for backup, transfer, or import

Five User Rights

OMP guarantees every user five non-negotiable operations:

Operation What It Does
🔒 BACKUP Create a complete copy of all your AI conversations in OMP format
📥 RESTORE Import an OMP Archive back into any Memory Host
🔄 MIGRATE Move conversations from one platform to another
🗑️ DELETE Permanently remove specific conversations or your entire vault
🔍 SEARCH Find anything across all platforms, by keyword or meaning

Connectors

Convert platform-specific exports to the universal OMP format:

Platform Status Maintainer
ChatGPT ✅ Available OMP Working Group
Claude ✅ Available OMP Working Group
Gemini 🚧 In Progress Community
Cursor 🚧 In Progress Community
Perplexity 📋 Planned Community
Grok 📋 Planned Community
Copilot 📋 Planned Community

Build a connector →

Conformance Levels

Level Name Requirements
Level 1 Portable Produce & consume OMP Archives, BACKUP/RESTORE/DELETE, TLS
Level 2 Connected Full API, keyword search, connectors, auto-backup, pagination
Level 3 Enterprise Multi-tenant isolation, RBAC, audit logs, compliance profiles

Project Structure

open-memory-protocol/
├── spec/              # The OMP v2.0 specification + JSON schemas
├── connectors/        # Platform-specific converters
├── sdk/               # TypeScript and Python client libraries
├── reference-server/  # Self-hostable Memory Host (Docker template)
├── validator/         # CLI tool to validate OMP archives
├── website/           # Landing page (Astro)
└── docs/              # Guides and API reference

Hosted Solution

Don't want to self-host? Memory Vault is a cloud-hosted Memory Host that stores your conversations, visualizes them as an interactive knowledge graph, and lets you ask AI-powered questions about your history.

Contributing

We welcome contributions from everyone! See our Contributing Guide to get started.

Governance

OMP is maintained by an open Working Group with no single-vendor veto. Changes follow the OEP (OMP Enhancement Proposal) process with a 30-day public comment period. See Governance for details.

Founded By

OMP was created and is maintained by EB DevTech, a software development company building tools for AI-first workflows. We believe your AI conversations are your data — and you should own them.

  • 🌐 ebdevtech.com — Custom AI solutions, enterprise consulting & development
  • 💼 Hire us for OMP integrations and AI-powered products

License


Your AI conversations belong to you.

Made with ❤️ by EB DevTech

⭐ Star this repo · Read the Spec · Join the Discussion

About

No description, website, or topics provided.

Resources

License

Apache-2.0, Unknown licenses found

Licenses found

Apache-2.0
LICENSE-CODE.md
Unknown
LICENSE-SPEC.md

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors