ContextQMD
Back to Mem0

Python SDK Quickstart

docs/open-source/python-quickstart.mdx

2.0.12.5 KB
Original Source

Get started with Mem0's Python SDK in under 5 minutes. This guide shows you how to install Mem0 and store your first memory.

Prerequisites

Set your OpenAI API key:

bash
export OPENAI_API_KEY="your-openai-api-key"
<Note> Uses OpenAI by default. Want to use Ollama, Anthropic, or local models? See [Configuration](/open-source/configuration). </Note>

Installation

<Steps> <Step title="Install via pip"> ```bash pip install mem0ai ``` </Step> <Step title="Initialize Memory"> ```python from mem0 import Memory

m = Memory()

</Step>

<Step title="Add a memory">
```python
messages = [
    {"role": "user", "content": "Hi, I'm Alex. I love basketball and gaming."},
    {"role": "assistant", "content": "Hey Alex! I'll remember your interests."}
]
m.add(messages, user_id="alex")
</Step> <Step title="Search memories"> ```python results = m.search("What do you know about me?", filters={"user_id": "alex"}) print(results) ```

Output:

json
{
  "results": [
    {
      "id": "mem_123abc",
      "memory": "Name is Alex. Enjoys basketball and gaming.",
      "user_id": "alex",
      "categories": ["personal_info"],
      "created_at": "2025-10-22T04:40:22.864647-07:00",
      "score": 0.89
    }
  ]
}
</Step> </Steps> <Note> By default `Memory()` wires up: - OpenAI `gpt-5-mini` for fact extraction and updates - OpenAI `text-embedding-3-small` embeddings (1536 dimensions) - Qdrant vector store with on-disk data at `/tmp/qdrant` - SQLite history at `~/.mem0/history.db` - No reranker (add one in the config when you need it) </Note>

What's Next?

<CardGroup cols={3}> <Card title="Memory Operations" icon="database" href="/core-concepts/memory-operations/add"> Learn how to search, update, and manage memories with full CRUD operations </Card> <Card title="Configuration" icon="sliders" href="/open-source/configuration"> Customize Mem0 with different LLMs, vector stores, and embedders for production use </Card> <Card title="Advanced Features" icon="sparkles" href="/open-source/features/async-memory"> Explore async support and multi-agent memory organization </Card> </CardGroup>

Additional Resources