Install dependencies

pip install -r ./docker/requirements.txt

What deployment options are available?

See docs for full setup

```

🚀 Quick-start Guide

Basic Usage (Self-Hosted)

- Add User Message

    import requests
    import json

    data = {
        "user_id": "8736b16e-1d20-4163-980b-a5063c3facdc",
        "mem_cube_id": "b32d0977-435d-4828-a86f-4f47f8b55bca",
        "messages": [
            {
                "role": "user",
                "content": "I like strawberry"
            }
        ],
        "async_mode": "sync"
    }
    headers = {
        "Content-Type": "application/json"
    }
    url = "http://localhost:8000/product/add"

    res = requests.post(url=url, headers=headers, data=json.dumps(data))
    print(f"result: {res.json()}")
    

    import requests
    import json

    data = {
        "query": "What do I like",
        "user_id": "8736b16e-1d20-4163-980b-a5063c3facdc",
        "mem_cube_id": "b32d0977-435d-4828-a86f-4f47f8b55bca"
    }
    headers = {
        "Content-Type": "application/json"
    }
    url = "http://localhost:8000/product/search"

    res = requests.post(url=url, headers=headers, data=json.dumps(data))
    print(f"result: {res.json()}")
    

Configure .env (OPENAI_API_KEY, etc.)

cp docker/.env.example MemOS/.env

☁️ 1、Cloud API (Hosted)

#### Get API Key - Sign up on the MemOS dashboard - Go to API Keys and copy your key

#### Next Steps - MemOS Cloud Getting Started Connect to MemOS Cloud and enable memory in minutes. - MemOS Cloud Platform Explore the Cloud dashboard, features, and workflows.

How do I get started with Cloud API?

1. Sign up at MemOS dashboard
2. Go to API Keys and copy your key
3. Use the Cloud API for memory operations

See Cloud Getting Started.

🧠 MemOS Plugin: Persistent Memory for Your AI Agents ✨

Your lobsters and Hermes Agents now have the best memory system — choose Cloud Service or Self-hosted to get started 🏃🏻

🔌 Plugin	<div align="center"> 💡 Core Features </div>	🧩 Resources
🧠 [**memos-local-plugin 2.0**](https://github.com/hijzy/MemOS/tree/main/apps/memos-local-plugin)	<ul><li>One local-first memory core for **Hermes Agent** and **OpenClaw**.</li><li>Self-evolving memory: L1 trace, L2 policy, L3 world model,<br>and crystallized Skills driven by feedback.</li></ul>	🌐 [Website](https://memos-claw.openmem.net/) · 📖 [Docs](https://memos-docs.openmem.net/cn/openclaw/local_plugin) · 🐙 [GitHub](https://github.com/hijzy/MemOS/tree/main/apps/memos-local-plugin) · 📦 [NPM](https://www.npmjs.com/package/@memtensor/memos-local-plugin)
☁️ [**OpenClaw Cloud Plugin**](https://x.com/MemOS_dev/status/2019254160919769171?s=20)	<ul><li>[Reduces token usage by 72%.](https://x.com/MemOS_dev/status/2020854044583924111)</li><li>[Multi-agent memory sharing by user_id.](https://x.com/MemOS_dev/status/2020538135487062094)</li></ul>	🖥️ [MemOS Dashboard](https://memos-dashboard.openmem.net/login/) · 📖 [Full Tutorial](https://memos-docs.openmem.net/openclaw/guide#_4-update-plugin)

🐳 Docker Deployment Note: When running memos-local-plugin in Docker containers, you must specify the config location using MEMOS_HOME environment variable or --home CLI flag. See Docker Configuration Guide for details.

</div> <br>

What plugins are available?

How does MemOS compare to other memory solutions?

FAQ