mem0-oss-to-platform

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

Updated Jun 29, 2026
One-click install
npx skills add https://github.com/nhatnguyen1122/Agent-Memory-Eval --skill mem0-oss-to-platform-nhatnguyen1122
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mem0-oss-to-platform
Source: https://github.com/nhatnguyen1122/Agent-Memory-Eval/tree/main/mem0/skills/mem0-oss-to-platform
Command: npx skills add https://github.com/nhatnguyen1122/Agent-Memory-Eval --skill mem0-oss-to-platform-nhatnguyen1122

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 causes runtime breaks. This Skill audits every mem0 usage in a repo, writes a reviewable migration plan, and executes it only after approval. ## Core Features & Use Cases - Full Footprint Discovery: Finds every mem0 import, client initialization, config block, call site, dependency, env variable, and local infra service across Python and TypeScript codebases. - Verified API Mapping: Confirms real method signatures against the installed SDK version and maps each OSS call to its hosted equivalent (filters, top_k/topK, pagination), flagging non-1:1 cases like graph memory, custom prompts, and reset(). - Plan-Then-Execute Workflow: Writes a concrete MEM0_MIGRATION_PLAN.md with inventory, change set, concerns, and verification steps, then executes and smoke-tests against the hosted API 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 with a real MEM0_API_KEY. ## Quick Start Ask your assistant to migrate this project's mem0 setup from the self-hosted OSS SDK to the hosted mem0 Platform using MemoryClient.

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 all call sites, writes a migration plan for review, then executes and verifies it after approval.

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 TypeScript limit becomes topK. Top-level user_id on search raises a ValueError in the hosted Python client.

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

No, code migration does not move stored memories; data in the local vector store stays behind 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 like userId move into filters and limit becomes topK.

What mem0 features have no direct equivalent on the hosted platform?

Global reset() has no hosted equivalent and must become scoped delete_all calls, and graph memory, custom extraction prompts, and local model choices change behavior on the platform. The Skill flags each of these as decisions in the plan rather than silently converting them.