企业官网建设流程全解析

MemU 跨平台部署教程：3 步在 Windows、Linux、macOS 一次装好的 Agent 记忆系统

【免费下载链接】memUPersonal memory across agents项目地址: https://gitcode.com/GitHub_Trending/mem/memU

MemU 是一个为 AI Agent 设计的个人记忆系统，把跨会话、跨设备的记忆存成 Wiki 式文件，并自动从历史中提炼可复用技能。本教程覆盖 Windows、Linux、macOS，带你跑通一次 MemU 跨平台部署。

30 秒了解它

memU 以 sidecar 形式挂在现有编码 Agent（Codex、Claude Code、Cursor 等）旁边，通过 record 与 inject 两条链路自动沉淀并召回记忆，核心逻辑仅约 500 行、可读可改。

它还能把 Agent 历史自动提炼成 Markdown 技能文件，供后续相似任务直接复用。

环境准备

安装主流程

1. 获取代码：把仓库克隆到本地。

git clone https://gitcode.com/GitHub_Trending/mem/memU cd memU

2. 建虚拟环境：隔离依赖，避免污染系统 Python。

python -m venv .venv

建好后激活它，激活命令按系统不同，见下方对照表。

3. 装依赖：以可编辑模式安装，memu与各 host 二进制会进入 PATH。

pip install -e .

4. 基础配置：在用户主目录新建~/.memu/config.env，写入存储与提供方配置。

MEMU_DB=~/.memu/memu.sqlite3 MEMU_EMBED_PROVIDER=openai MEMU_API_KEY=sk-你的密钥

5. 首次运行：探测本机可用的 Agent，确认二进制可调用。

memu-agent detect

预期按 Agent 列出 memorize 与 retrieve 是否可用。

三大系统差异对照

在 Windows 上路径用反斜杠、激活走 Scripts 目录，在 Linux/macOS 上用正斜杠并以source激活。

存储后端选型（可选）

默认用 SQLite，单文件、无需额外服务，适合单机部署。要切到 PostgreSQL（支持并发与向量检索），先装扩展依赖再改 DSN：

pip install "memu-cli[postgres]"

MEMU_DB=postgresql://user:pass@host:5432/memu

三种后端的取舍见 SQLite 集成说明。

安装自检清单

• memu --help能打印子命令列表
• memu-agent detect至少对一个 Agent 报 retrieve 可用
• ~/.memu/config.env含MEMU_DB与MEMU_EMBED_PROVIDER
• 对应 host 二进制的doctor通过，如memu-codex doctor
• 数据目录已生成memu.sqlite3

踩坑速查

现象：memu不是内部或外部命令 / command not found原因：虚拟环境未激活，或二进制未进入 PATH解决：

source .venv/bin/activate pip install -e .

（Windows 上第一行换成.venv\Scripts\activate）

现象：子命令报invalid choice原因：用了旧的构建版本解决：

pip install --upgrade -e .

现象：doctor报 502 或连接失败原因：Embedding 密钥或 Base URL 未配置、被代理拦截解决：核对MEMU_API_KEY与MEMU_BASE_URL，检查本机代理设置。

写在最后

至此 memU 本地部署完成，记忆将随 Agent 会话自动沉淀与召回。更多接口见 开发者文档，参与贡献请先阅读 CONTRIBUTING.md，问题可直接提交到仓库 Issue。

【免费下载链接】memUPersonal memory across agents项目地址: https://gitcode.com/GitHub_Trending/mem/memU