mem0 Docker 本地部署

这个仓库提供一套用于本地测试的 mem0 Docker Compose 环境，包含：

• mem0-api：mem0 API 服务，默认监听 8000。
• mem0-postgres：带 pgvector 扩展的 PostgreSQL，宿主机端口 8432。
• mem0-neo4j：Neo4j 图数据库，浏览器端口 8474，Bolt 端口 8687。

环境要求

• Docker
• Docker Compose v2
• 一个兼容 OpenAI API 的模型服务 Key（真实记忆写入、搜索时需要）

快速启动

1. 使用示例配置启动本地服务：

   docker compose --env-file .env.mem0 up -d --build

2. 打开 API 文档：

   http://localhost:8000/docs
   

3. 查看服务状态：

   docker compose ps

配置说明

.env.mem0 是示例配置文件，可以提交到代码仓库。需要真实调用模型服务时，建议复制一份本地配置：

cp .env.mem0 .env.mem0.local
vi .env.mem0.local
docker compose --env-file .env.mem0.local up -d --build

.env.mem0.local 已加入 .gitignore，可以放测试 Key 或真实 Key。

配置项	说明
OPENAI_API_KEY	兼容 OpenAI API 的访问 Key。示例值不可用于真实调用。
OPENAI_BASE_URL	API Base URL。使用 OpenAI 官方服务时保持 https://api.openai.com/v1。
OPENAI_LLM_MODEL	用于对话和推理的模型名称。
OPENAI_EMBEDDING_MODEL	用于向量化的 Embedding 模型名称。

常用命令

# 查看日志
docker compose logs -f mem0-api

# 停止服务
docker compose down

# 停止并清理容器
docker compose down --remove-orphans

端口

服务	宿主机端口	容器端口
mem0 API	8000	8000
PostgreSQL	8432	5432
Neo4j Browser	8474	7474
Neo4j Bolt	8687	7687