mem0-oss-to-platform

Migrates projects from the self-hosted mem0 OSS SDK to the hosted MemoryClient platform.

64.5k|7.6k|Updated Jun 20, 2023
One-click install
npx skills add https://github.com/mem0ai/mem0 --skill mem0-oss-to-platform
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mem0-oss-to-platform
Source: https://github.com/mem0ai/mem0/tree/main/skills/mem0-oss-to-platform
Command: npx skills add https://github.com/mem0ai/mem0 --skill mem0-oss-to-platform

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Moving an existing project from the self-hosted mem0 OSS SDK (the local Memory class with vector store, embedder, and LLM config) to the hosted mem0 Platform (MemoryClient) involves many subtle API differences, and a missed call site or wrong parameter convention causes runtime breaks. This Skill audits every mem0 touchpoint, writes a reviewable migration plan, and executes it only after approval.

Core Features & Use Cases

  • Full Footprint Discovery: Scans the repo for mem0 imports, client initialization, config blocks, call sites, dependencies, env variables, and local infrastructure such as Qdrant containers.
  • Verified API Mapping: Confirms real method signatures against the installed SDK and maps each OSS call to its hosted equivalent for both Python and TypeScript, including filters, top_k/topK, and pagination changes.
  • Plan-Then-Execute Workflow: Writes a concrete MEM0_MIGRATION_PLAN.md with an inventory, change set, concerns, and verification plan, then executes the edits and runs a real-API smoke test after the developer approves.
  • Use Case: A team running a RAG service with Memory.from_config backed by a local Qdrant wants to switch to the managed platform; the Skill produces the plan, swaps the client, updates dependencies and env, and verifies add/search/delete_all against the hosted API.

Quick Start

Ask your AI assistant to migrate your project's mem0 setup from the self-hosted OSS SDK to the hosted mem0 Platform using your MEM0_API_KEY.

Frequently Asked Questions about mem0-oss-to-platform

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate from mem0 OSS to the mem0 Platform?

Replace the local Memory class and its vector_store/llm/embedder config with MemoryClient, which reads MEM0_API_KEY from the environment. This Skill audits every call site, writes a migration plan for review, and executes the changes after you approve.

What changes between mem0 Memory and MemoryClient search calls?

On the hosted client, entity IDs like user_id must move inside a filters dict for search and get_all, and top-level entity parameters raise a ValueError. TypeScript also renames limit to topK, and get_all becomes paginated with page and page_size.

Does migrating mem0 code to the platform move my existing memories?

No, code migration does not move data; memories stored in the local vector store and history DB stay there and the hosted account starts empty. Data migration is a separate opt-in task of exporting from the OSS store and re-adding to the hosted client.

Does the mem0 platform migration work for TypeScript projects?

Yes, it covers TypeScript and JavaScript where the OSS SDK is imported from mem0ai/oss and the hosted client is the default export of the mem0ai package. Option names are verified against the installed node_modules types before mapping.

What happens to graph memory and custom prompts when moving to mem0 Platform?

Graph memory (enable_graph, graph_store) changed in v3 and has no drop-in equivalent, so it is flagged for a manual decision. Custom fact extraction prompts become custom_instructions, typically configured as project-level settings in the platform dashboard.