SimpleMem

环境要求

• Python 环境与 pip（用于安装 simplemem 包）
• 项目源码目录（pip install -e . 与 docker compose 命令需在此目录执行）
• Docker + Docker Compose（仅部署 MCP Server 时需要）
• 一个 OpenAI 兼容的推理服务地址与令牌（OPENAI_BASE_URL 等）

安装与启动步骤

1. 1获取项目源码

   把仓库克隆到本地，后续 pip 与 docker 命令都需在该目录下执行。

   git clone https://github.com/aiming-lab/SimpleMem.git
   cd SimpleMem

   复制

2. 2安装依赖

   按 README 提供的固定版本依赖清单安装，适合直接复现官方环境。

   pip install -r requirements.txt

   复制

3. 3可编辑安装本包

   默认装文本+多模态+evolver；要 MCP/HTTP 服务用 .[server]，全量用 .[all]。

   pip install -e .

   复制

4. 4Python 快速调用

   默认 mode="auto"，后端由首次调用的方法决定，无需手动配置。

   from simplemem import SimpleMem
   
   mem = SimpleMem()  # mode="auto"，首次调用决定后端

   复制

5. 5复制环境变量模板

   为 Docker/MCP 部署准备配置，随后编辑 .env 填写密钥与模型地址。

   cp .env.example .env

   复制

6. 6Docker 启动 MCP

   用自定义 .env 启动 MCP Server，LanceDB 与用户库持久化在宿主机 volume。

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

   复制

7. 7配置 MCP 客户端

   写入客户端配置即可连接；也可换成自建地址，令牌替换为自己的。

   {
     "mcpServers": {
       "simplemem": {
         "url": "https://mcp.simplemem.cloud/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_TOKEN"
         }
       }
     }
   }

   复制

关键配置

如何确认成功

Python 中 SimpleMem() 能实例化并成功调用一次写入方法即文本模式可用；Docker 下容器持续运行即启动成功。

常见问题

注意事项

• 执行 pip install -e . 与 docker compose 前，必须先进入项目根目录。
• README 节选中部分命令块为空（如 Docker Quick run），实际以官方仓库最新说明为准。
• MCP 集成只覆盖文本记忆，图像、音频、视频等多模态能力需通过 Python 集成使用。
• 修改 .env 时至少设置 JWT_SECRET_KEY、ENCRYPTION_KEY、LLM_PROVIDER 及模型地址等参数。