Guide
Get started with Mem0 quickly!
Welcome to the Mem0 quickstart guide. This guide will help you get up and running with Mem0 in no time.
Installation
To install Mem0, you can use pip. Run the following command in your terminal:
pip install mem0ai
Basic Usage
Initialize Mem0
from mem0 import Memory
m = Memory()
Store a Memory
Retrieve Memories
Search Memories
Update a Memory
Memory History
Delete Memory
# Delete a memory by id
m.delete(memory_id="m1")
# Delete all memories for a user
m.delete_all(user_id="alice")
Reset Memory
m.reset() # Reset all memories
Run Mem0 Locally
Please refer the example Mem0 with Ollama to run Mem0 locally.
Chat Completion
Mem0 can be easily integrate into chat applications to enhance conversational agents with structured memory. Mem0’s APIs are designed to be compatible with OpenAI’s, with the goal of making it easy to leverage Mem0 in applications you may have already built.
If you have a Mem0 API key
, you can use it to initialize the client. Alternatively, you can initialize Mem0 without an API key if you’re using it locally.
Mem0 supports several language models (LLMs) through integration with various providers.
Use Mem0 Platform
from mem0.proxy.main import Mem0
client = Mem0(api_key="m0-xxx")
# First interaction: Storing user preferences
messages = [
{
"role": "user",
"content": "I love indian food but I cannot eat pizza since allergic to cheese."
},
]
user_id = "alice"
chat_completion = client.chat.completions.create(messages=messages, model="gpt-4o-mini", user_id=user_id)
# Memory saved after this will look like: "Loves Indian food. Allergic to cheese and cannot eat pizza."
# Second interaction: Leveraging stored memory
messages = [
{
"role": "user",
"content": "Suggest restaurants in San Francisco to eat.",
}
]
chat_completion = client.chat.completions.create(messages=messages, model="gpt-4o-mini", user_id=user_id)
print(chat_completion.choices[0].message.content)
# Answer: You might enjoy Indian restaurants in San Francisco, such as Amber India, Dosa, or Curry Up Now, which offer delicious options without cheese.
In this example, you can see how the second response is tailored based on the information provided in the first interaction. Mem0 remembers the user’s preference for Indian food and their cheese allergy, using this information to provide more relevant and personalized restaurant suggestions in San Francisco.
Use Mem0 OSS
config = {
"vector_store": {
"provider": "qdrant",
"config": {
"host": "localhost",
"port": 6333,
}
},
}
client = Mem0(config=config)
chat_completion = client.chat.completions.create(
messages=[
{
"role": "user",
"content": "What's the capital of France?",
}
],
model="gpt-4o",
)
APIs
Get started with using Mem0 APIs in your applications. For more details, refer to the Platform.
Here is an example of how to use Mem0 APIs:
from mem0 import MemoryClient
client = MemoryClient(api_key="your-api-key") # get api_key from https://app.mem0.ai/
# Store messages
messages = [
{"role": "user", "content": "Hi, I'm Alex. I'm a vegetarian and I'm allergic to nuts."},
{"role": "assistant", "content": "Hello Alex! I've noted that you're a vegetarian and have a nut allergy. I'll keep this in mind for any food-related recommendations or discussions."}
]
result = client.add(messages, user_id="alex")
print(result)
# Retrieve memories
all_memories = client.get_all(user_id="alex")
print(all_memories)
# Search memories
query = "What do you know about me?"
related_memories = client.search(query, user_id="alex")
# Get memory history
history = client.history(memory_id="m1")
print(history)
Contributing
We welcome contributions to Mem0! Here’s how you can contribute:
-
Fork the repository and create your branch from
main
. -
Clone the forked repository to your local machine.
-
Install the project dependencies:
poetry install
-
Install pre-commit hooks:
pip install pre-commit # If pre-commit is not already installed pre-commit install
-
Make your changes and ensure they adhere to the project’s coding standards.
-
Run the tests locally:
poetry run pytest
-
If all tests pass, commit your changes and push to your fork.
-
Open a pull request with a clear title and description.
Please make sure your code follows our coding conventions and is well-documented. We appreciate your contributions to make Mem0 better!
If you have any questions, please feel free to reach out to us using one of the following methods: