Quickstart

​

OpenMemory Easy Setup

​

Prerequisites

• Docker
• OpenAI API Key

You can quickly run OpenMemory by running the following command:

curl -sL https://raw.githubusercontent.com/mem0ai/mem0/main/openmemory/run.sh | bash

You should set the OPENAI_API_KEY as a global environment variable:

export OPENAI_API_KEY=your_api_key

You can also set the OPENAI_API_KEY as a parameter to the script:

curl -sL https://raw.githubusercontent.com/mem0ai/mem0/main/openmemory/run.sh | OPENAI_API_KEY=your_api_key bash

This will start the OpenMemory server and the OpenMemory UI. Deleting the container will lead to the deletion of the memory store. We suggest you follow the instructions below to set up OpenMemory on your local machine, with more persistant memory store.

​

Setting Up OpenMemory

Getting started with OpenMemory is straight forward and takes just a few minutes to set up on your local machine. Follow these steps:

​

Getting started

First clone the repository and then follow the instructions:

# Clone the repository
git clone https://github.com/mem0ai/mem0.git
cd mem0/openmemory

# Create the backend .env file with your OpenAI key
make env

# Build the Docker images
make build

# Start all services (API server, vector database, and MCP server components)
make up

You can configure the MCP client using the following command (replace username with your username):

npx install-mcp i "http://localhost:8765/mcp/cursor/sse/username" --client cursor

The OpenMemory dashboard will be available at http://localhost:3000. From here, you can view and manage your memories, as well as check connection status with your MCP clients.

Once set up, OpenMemory runs locally on your machine, ensuring all your AI memories remain private and secure while being accessible across any compatible MCP client.

​

Getting Started Today

• Github Repository: https://github.com/mem0ai/mem0/tree/main/openmemory