---

name: mem0 description: "Route Mem0 repository tasks across Python/TypeScript SDKs, OSS provider configuration, CLI workflows, self-hosted/OpenMemory deployment, and framework/editor integrations." disable-model-invocation: true metadata: disco-role: operating license: Apache 2.0

Mem0 Repo Skill

Use this repo skill when a task mentions Mem0, mem0ai, MemoryClient, Memory, the Mem0 memory layer, hosted Platform memory, OSS memory, Mem0 CLI, self-hosted Mem0, OpenMemory, Vercel AI SDK memory, MCP/plugin setup, or Mem0 framework integrations.

This is a router for repository-specific Mem0 knowledge. Pick the nearest sub-skill first, then read the linked references or run bundled read-only helpers.

Quick Route

User task	Read
Add/search/update/delete memories from Python or TypeScript code	sub-skills/sdk-memory/SKILL.md
Use hosted Platform MemoryClient, OSS Memory, async clients, filters, metadata, categories, feedback, or exports	sub-skills/sdk-memory/SKILL.md
Configure OSS LLMs, embedders, vector stores, rerankers, Qdrant dimensions, BM25/entity retrieval, graph behavior, or optional extras	sub-skills/provider-configuration/SKILL.md
Run mem0 init, mem0 add, mem0 search, agent JSON mode, stdin/files, config defaults, import/export, entities, or events from a terminal	sub-skills/cli-memory/SKILL.md
Deploy or debug self-hosted Mem0 server, dashboard auth, API keys, request logs, Docker Compose, REST API, migrations, or OpenMemory MCP	sub-skills/self-hosted-openmemory/SKILL.md
Wire Mem0 into Vercel AI SDK, Claude/Cursor/Codex/OpenCode/Antigravity, OpenClaw, Pi Agent, LangChain, LangGraph, LlamaIndex, CrewAI, or other frameworks	sub-skills/integrations-plugins/SKILL.md

First Checks

1. Identify the surface: hosted Platform SDK, local OSS memory, CLI, self-hosted service, OpenMemory, plugin/MCP, or framework adapter.
2. Confirm runtime requirements: Python 3.10+ for Python packages, Node 18+ for TypeScript/CLI/integration packages, API keys only when live hosted/provider calls are intended.
3. Keep entity scope explicit. Stable user_id, agent_id, run_id, or app/project scope prevents cross-user memory leakage and empty searches.
4. Prefer read-only bundled helpers before live writes. The scripts in this skill inspect imports, configs, specs, or source snippets and redact secrets by default.
5. Confirm destructive operations before deletes, resets, volume wipes, hook rewrites, password resets, or request-log pruning.

Package Facts

• Python SDK distribution: mem0ai version 2.0.7, import root mem0, Python >=3.10,<4.0.
• TypeScript SDK package: mem0ai version 3.0.9, exports hosted client and mem0ai/oss, Node >=18.
• Python CLI package: mem0-cli version 0.2.8, entry point mem0, Python >=3.10.
• Node CLI package: @mem0/cli version 0.2.9, binary mem0, Node >=18.
• Vercel provider package: @mem0/vercel-ai-provider version 3.0.0, Node >=18.
• Integration packages include @mem0/openclaw-mem0 and @mem0/pi-agent-plugin for agent/editor workflows.

Core Concepts

• Hosted Platform clients call the Mem0 API and require a Mem0 API key.
• OSS Memory objects run in-process and require LLM/embedder/vector store configuration; default examples use OpenAI plus local Qdrant or in-memory/SQLite pieces depending on language.
• Search/get-all entity scoping uses filters in current SDK examples; add/delete-all may accept top-level entity options depending on SDK surface.
• CLI and plugin workflows are operational surfaces. They often manage config files or hooks, so inspect existing config before adding duplicate entries.
• Self-hosted server/OpenMemory workflows are service deployments. Treat auth, secrets, database volumes, backups, and request logs as production operations.

Shared References and Scripts

• references/overview.md gives the repository capability map and package boundaries.
• references/troubleshooting.md covers cross-cutting install, API key, version, scoping, and routing failures.
• references/repo-provenance.md records the source commit, package versions, and evidence paths for refresh checks.
• scripts/mem0_environment_check.py --help performs safe Python package/import and environment checks with secret redaction.

Safety Rules

• Never print or hardcode MEM0_API_KEY, provider keys, self-hosted API keys, JWT_SECRET, admin passwords, MCP bearer tokens, or personal memory contents.
• Do not run original repository tests, examples, notebooks, or scripts as runtime instructions from this skill. They were used as evidence only.
• Do not depend on the original repository checkout. Use the bundled references and scripts in this skill tree.
• Ask before mutating user/editor config, starting long-running services, making network writes, deleting memories, or wiping volumes.