memU 最新开发版安装指南从 git main 分支到 host adapter 配置的完整流程【免费下载链接】memUPersonal memory across agents项目地址: https://gitcode.com/GitHub_Trending/mem/memU本文以 INSTALL-LATEST.md 为主体讲解如何从 gitmain分支安装 memU 的最新开发构建development build清除旧安装、以持久方式安装、验证版本并完成 host adapter 初始化配置。读完后你可以掌握一套可复现的装最新流程并理解 memU 为何坚持安装必须落在PATH上、配置为何集中在~/.memu/config.env这些设计约束的底层原因。该文档的受众是Agent如 Claude Code、Codex 等助手当用户要求读这个文档并安装最新 memU时Agent 应自行执行全部命令而不是把命令抛给用户手工运行。这一定位决定了文档中每一步都带有明确的验证闸门verify gate和用户交互约定。Step 1清除机器上已有的 memU 安装旧版本的 memU 可能仍留在PATH上并遮蔽shadow即将安装的构建——真正被执行的版本将不是你期望的最新代码。因此第一步是依次尝试三个安装器的卸载命令忽略未安装的报错uv tool uninstall memu-cli pipx uninstall memu-cli pip uninstall -y memu-cli文档要求清理完成后要告知用户清除了什么——旧安装的名称和版本或未发现旧安装——确保用户知道旧版本已移除后才继续。关键细节这一步只移除 memU包即二进制命令~/.memu/下的 store记忆数据和~/.memu/config.env配置文件不受影响用户的记忆与配置会原样带到新版本。因此 Step 4 会直接复用已有的config.env而不重复提问若新构建需要旧文件里缺失的配置项Step 4 中的doctor闸门会指名道姓地告诉你要补什么。这个包与数据分离的行为与源码一致所有 host 共享唯一一份~/.memu/config.env其目录权限为0700、文件权限为0600写入采用临时文件 os.replace的原子替换见 config_file.py 模块文档所以卸载/重装包不会触碰它。Step 2从 git 安装并确保安装持久化在 PATH 上文档对安装方式有一条硬性要求安装必须持久保留在PATH上。原因是 memU 会注册一个定时执行的 bridging 任务稍后从裸的、非交互的 shell中调用这些二进制命令。所以绝不能用一次性运行器uvx、npx安装——它们执行完一条命令就消失定时任务将无命令可找。这一点在源码中得到印证env.py 的模块文档明确解释配置为何必须落在~/.memu/config.env这个固定绝对路径的文件里而不是 shell profile 的export中——因为定时任务没有可靠的工作目录也不会继承交互式 shell。同一个定时任务运行在裸 shell的约束正是安装必须持久化的原因。前置要求机器PATH上要有git。然后按以下顺序选用第一个可行的方案uv首选——隔离、全局、在 PATH 上uv tool install githttps://github.com/NevaMind-AI/memU没有 uv 但能安装先安装 uv再执行上面命令。curl -LsSf https://astral.sh/uv/install.sh | sh # macOS / Linux powershell -c irm https://astral.sh/uv/install.ps1 | iex # Windowspip 兜底仅当装入一个稳定的、在 PATH 上的环境pip install githttps://github.com/NevaMind-AI/memU如果要固定某个精确提交而非不断移动的main在 URL 后追加sha即可。安装器会打印它实际解析到的 commit——用 uv 时形如Building memu-cli git…sha的一行。记下这个 SHA将在 Step 3 中向用户确认。从包结构看一次安装会同时落地多个入口点pyproject.toml 的[project.scripts]段定义了memu算法主表面以及九个 host adapter 二进制memu-codex、memu-claude-code、memu-cursor、memu-openclaw、memu-hermes、memu-workbuddy、memu-cola、memu-pi还有兜底通用的memu-agent第 60–75 行。源码注释说明了为何 host adapter 各自拥有独立二进制而非memu的子命令memu是算法表面这些是桌面 agent 的伴生程序sidecar。Step 3验证安装并与用户确认版本验证必须在一个新开的 shell中执行安装器所在的 shell 的PATH可能已过期memu --help memu-your-host --help # 例如 memu-claude-code、memu-codex两者都必须打印出 usage。若不能说明安装器的 bin 目录不在PATH上用 uv 时是~/.local/bin——必须先修好再继续因为定时任务依赖的是同一套命令解析。接着在进入耗时较长的 setup 之前先与用户确认版本。裸的 SHA 难以判断新旧所以要把这个 commit 是什么报告出来SHA来自 Step 2它的subject line 与日期供查看的 commit 页面链接形如github.com/NevaMind-AI/memU/commit/sha。subject 和日期通过 GitHub API 获取无需克隆仓库curl -s https://api.github.com/repos/NevaMind-AI/memU/commits/sha读取返回 JSON 的.commit.message第一行与.commit.author.date。然后给用户一个一键式选择而不是开放式问题。若宿主能渲染可选项就给出恰好这两项否则接受纯文本 yesUse this version使用此版本→ 直接进入 Step 4 并自行执行到底不要让用户去跑docs install或任何 setup 命令只有真正需要用户时例如提供 embedding API key才暂停。Pick a different commit换一个 commit→ 问用户要哪个用 Step 2 的sha方式重装然后回到这里再次确认。裸的 yes / ok 一律按Use this version处理——默认继续。Step 4确定你所在的 host按打包指南完成配置此时最新二进制已就位。第一步是识别你自己是哪个 agent并使用它对应的二进制——memU 共有九个 host adapter你是你的二进制Codexmemu-codexClaude Codememu-claude-codeCursormemu-cursorOpenClawmemu-openclawHermesmemu-hermesWorkBuddymemu-workbuddyColamemu-colapimemu-pi其他一切memu-agent—— 不确定时先跑memu-agent detect上表与 pyproject.toml 中[project.scripts]注册的九个 host 二进制一一对应。其中memu-agent是通用兜底适配器它不硬编码任何 host 的路径而是用memu-agent detect探测机器上的 agent报告记忆化memorization是否可行存在可识别的 session 日志和注入retrieval是否可行存在可打补丁的指令文件如 AGENTS.md / CLAUDE.md / SOUL.md见 generic/cli.py 的模块说明。然后打印你所处 host 的打包安装指南并逐字照做memu-your-host docs installdocs子命令是各 host adapter 的统一表面之一。从 host_cli.py 可以看到它的映射关系DOCS {install: INSTALL.md, task: BRIDGING_TASK.md, uninstall: UNINSTALL.md}即docs install打印该 host 打包的INSTALL.md安装指南每个 host 目录下都有各自的 INSTALL.md、BRIDGING_TASK.md 等模板。该指南会带你逐步完成在~/.memu/config.env中选择本地或云端后端、注册定时 bridging 任务、给指令文件打检索补丁——每一步都带一个验证闸门。由于复用了已有的config.env文档还要求用它对照本构建所文档化的配置项指南中会列出如果本版本识别出某个MEMU_*选项而用户文件里没有设置就要告诉用户这个选项的名字和作用——这是新构建引入的配置。可选项缺省也能工作必选项缺省则会被doctor闸门捕获。doctor的职责是验证MEMU_*配置可解析、且所选记忆后端可达见 host_cli.py 的命令定义它刻意执行与 inject hook 完全相同的调用保证doctor 绿灯等价于检索真能工作。配置解析的优先级在 env.py 中有明确定义进程环境变量 ~/.memu/config.env 默认值。文档注释指出这是一个刻意为之的无默认设计——缺少必选配置必须显式暴露绝不能悄悄回退一个 bridging 运行如果回退到./data/memu.sqlite3而检索端读的是配置好的 store运行会成功却查不到任何记忆这正是该模块要防止的静默失败。全部完成后向用户报告哪些接缝seam已生效memorization记忆化与 retrieval检索各自的可用状态。小结流程要点与设计约束步骤关键动作为什么这么做Step 1依次尝试uv tool/pipx/pip卸载旧安装可能遮蔽新装版本但~/.memu/数据与配置不动记忆平滑迁移Step 2uv tool install githttps://github.com/NevaMind-AI/memU可加sha固定定时 bridging 任务从裸 shell 调用二进制安装必须持久在PATH禁用uvx/npxStep 3新 shell 中memu --helpmemu-host --helpGitHub API 查询 commit 后向用户确认在耗时的 setup 前排除装错/装旧一键式选择降低交互成本Step 4memu-host docs install逐字执行打包指南doctor把关复用旧config.envMEMU_*新增项要提示用户最终报告 memorization / retrieval 两条接缝状态这套流程的本质是Agent 自助安装所有步骤都可被 agent 独立执行、独立验证用户只在版本确认和 API key 这类必要时刻介入。如果你手上是已发布的稳定版仓库内的各 host 打包指南如 claude_code/INSTALL.md与 SKILL.md 走的是同一条init→docs install→doctor配置路径本文的 git 安装方式只是把获取二进制这一步换成了 main 分支的最新源码。【免费下载链接】memUPersonal memory across agents项目地址: https://gitcode.com/GitHub_Trending/mem/memU创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 memU 最新开发版安装指南：从 git main 分支到 host adapter 配置的完整流程
memU 最新开发版安装指南从 git main 分支到 host adapter 配置的完整流程【免费下载链接】memUPersonal memory across agents项目地址: https://gitcode.com/GitHub_Trending/mem/memU本文以 INSTALL-LATEST.md 为主体讲解如何从 gitmain分支安装 memU 的最新开发构建development build清除旧安装、以持久方式安装、验证版本并完成 host adapter 初始化配置。读完后你可以掌握一套可复现的装最新流程并理解 memU 为何坚持安装必须落在PATH上、配置为何集中在~/.memu/config.env这些设计约束的底层原因。该文档的受众是Agent如 Claude Code、Codex 等助手当用户要求读这个文档并安装最新 memU时Agent 应自行执行全部命令而不是把命令抛给用户手工运行。这一定位决定了文档中每一步都带有明确的验证闸门verify gate和用户交互约定。Step 1清除机器上已有的 memU 安装旧版本的 memU 可能仍留在PATH上并遮蔽shadow即将安装的构建——真正被执行的版本将不是你期望的最新代码。因此第一步是依次尝试三个安装器的卸载命令忽略未安装的报错uv tool uninstall memu-cli pipx uninstall memu-cli pip uninstall -y memu-cli文档要求清理完成后要告知用户清除了什么——旧安装的名称和版本或未发现旧安装——确保用户知道旧版本已移除后才继续。关键细节这一步只移除 memU包即二进制命令~/.memu/下的 store记忆数据和~/.memu/config.env配置文件不受影响用户的记忆与配置会原样带到新版本。因此 Step 4 会直接复用已有的config.env而不重复提问若新构建需要旧文件里缺失的配置项Step 4 中的doctor闸门会指名道姓地告诉你要补什么。这个包与数据分离的行为与源码一致所有 host 共享唯一一份~/.memu/config.env其目录权限为0700、文件权限为0600写入采用临时文件 os.replace的原子替换见 config_file.py 模块文档所以卸载/重装包不会触碰它。Step 2从 git 安装并确保安装持久化在 PATH 上文档对安装方式有一条硬性要求安装必须持久保留在PATH上。原因是 memU 会注册一个定时执行的 bridging 任务稍后从裸的、非交互的 shell中调用这些二进制命令。所以绝不能用一次性运行器uvx、npx安装——它们执行完一条命令就消失定时任务将无命令可找。这一点在源码中得到印证env.py 的模块文档明确解释配置为何必须落在~/.memu/config.env这个固定绝对路径的文件里而不是 shell profile 的export中——因为定时任务没有可靠的工作目录也不会继承交互式 shell。同一个定时任务运行在裸 shell的约束正是安装必须持久化的原因。前置要求机器PATH上要有git。然后按以下顺序选用第一个可行的方案uv首选——隔离、全局、在 PATH 上uv tool install githttps://github.com/NevaMind-AI/memU没有 uv 但能安装先安装 uv再执行上面命令。curl -LsSf https://astral.sh/uv/install.sh | sh # macOS / Linux powershell -c irm https://astral.sh/uv/install.ps1 | iex # Windowspip 兜底仅当装入一个稳定的、在 PATH 上的环境pip install githttps://github.com/NevaMind-AI/memU如果要固定某个精确提交而非不断移动的main在 URL 后追加sha即可。安装器会打印它实际解析到的 commit——用 uv 时形如Building memu-cli git…sha的一行。记下这个 SHA将在 Step 3 中向用户确认。从包结构看一次安装会同时落地多个入口点pyproject.toml 的[project.scripts]段定义了memu算法主表面以及九个 host adapter 二进制memu-codex、memu-claude-code、memu-cursor、memu-openclaw、memu-hermes、memu-workbuddy、memu-cola、memu-pi还有兜底通用的memu-agent第 60–75 行。源码注释说明了为何 host adapter 各自拥有独立二进制而非memu的子命令memu是算法表面这些是桌面 agent 的伴生程序sidecar。Step 3验证安装并与用户确认版本验证必须在一个新开的 shell中执行安装器所在的 shell 的PATH可能已过期memu --help memu-your-host --help # 例如 memu-claude-code、memu-codex两者都必须打印出 usage。若不能说明安装器的 bin 目录不在PATH上用 uv 时是~/.local/bin——必须先修好再继续因为定时任务依赖的是同一套命令解析。接着在进入耗时较长的 setup 之前先与用户确认版本。裸的 SHA 难以判断新旧所以要把这个 commit 是什么报告出来SHA来自 Step 2它的subject line 与日期供查看的 commit 页面链接形如github.com/NevaMind-AI/memU/commit/sha。subject 和日期通过 GitHub API 获取无需克隆仓库curl -s https://api.github.com/repos/NevaMind-AI/memU/commits/sha读取返回 JSON 的.commit.message第一行与.commit.author.date。然后给用户一个一键式选择而不是开放式问题。若宿主能渲染可选项就给出恰好这两项否则接受纯文本 yesUse this version使用此版本→ 直接进入 Step 4 并自行执行到底不要让用户去跑docs install或任何 setup 命令只有真正需要用户时例如提供 embedding API key才暂停。Pick a different commit换一个 commit→ 问用户要哪个用 Step 2 的sha方式重装然后回到这里再次确认。裸的 yes / ok 一律按Use this version处理——默认继续。Step 4确定你所在的 host按打包指南完成配置此时最新二进制已就位。第一步是识别你自己是哪个 agent并使用它对应的二进制——memU 共有九个 host adapter你是你的二进制Codexmemu-codexClaude Codememu-claude-codeCursormemu-cursorOpenClawmemu-openclawHermesmemu-hermesWorkBuddymemu-workbuddyColamemu-colapimemu-pi其他一切memu-agent—— 不确定时先跑memu-agent detect上表与 pyproject.toml 中[project.scripts]注册的九个 host 二进制一一对应。其中memu-agent是通用兜底适配器它不硬编码任何 host 的路径而是用memu-agent detect探测机器上的 agent报告记忆化memorization是否可行存在可识别的 session 日志和注入retrieval是否可行存在可打补丁的指令文件如 AGENTS.md / CLAUDE.md / SOUL.md见 generic/cli.py 的模块说明。然后打印你所处 host 的打包安装指南并逐字照做memu-your-host docs installdocs子命令是各 host adapter 的统一表面之一。从 host_cli.py 可以看到它的映射关系DOCS {install: INSTALL.md, task: BRIDGING_TASK.md, uninstall: UNINSTALL.md}即docs install打印该 host 打包的INSTALL.md安装指南每个 host 目录下都有各自的 INSTALL.md、BRIDGING_TASK.md 等模板。该指南会带你逐步完成在~/.memu/config.env中选择本地或云端后端、注册定时 bridging 任务、给指令文件打检索补丁——每一步都带一个验证闸门。由于复用了已有的config.env文档还要求用它对照本构建所文档化的配置项指南中会列出如果本版本识别出某个MEMU_*选项而用户文件里没有设置就要告诉用户这个选项的名字和作用——这是新构建引入的配置。可选项缺省也能工作必选项缺省则会被doctor闸门捕获。doctor的职责是验证MEMU_*配置可解析、且所选记忆后端可达见 host_cli.py 的命令定义它刻意执行与 inject hook 完全相同的调用保证doctor 绿灯等价于检索真能工作。配置解析的优先级在 env.py 中有明确定义进程环境变量 ~/.memu/config.env 默认值。文档注释指出这是一个刻意为之的无默认设计——缺少必选配置必须显式暴露绝不能悄悄回退一个 bridging 运行如果回退到./data/memu.sqlite3而检索端读的是配置好的 store运行会成功却查不到任何记忆这正是该模块要防止的静默失败。全部完成后向用户报告哪些接缝seam已生效memorization记忆化与 retrieval检索各自的可用状态。小结流程要点与设计约束步骤关键动作为什么这么做Step 1依次尝试uv tool/pipx/pip卸载旧安装可能遮蔽新装版本但~/.memu/数据与配置不动记忆平滑迁移Step 2uv tool install githttps://github.com/NevaMind-AI/memU可加sha固定定时 bridging 任务从裸 shell 调用二进制安装必须持久在PATH禁用uvx/npxStep 3新 shell 中memu --helpmemu-host --helpGitHub API 查询 commit 后向用户确认在耗时的 setup 前排除装错/装旧一键式选择降低交互成本Step 4memu-host docs install逐字执行打包指南doctor把关复用旧config.envMEMU_*新增项要提示用户最终报告 memorization / retrieval 两条接缝状态这套流程的本质是Agent 自助安装所有步骤都可被 agent 独立执行、独立验证用户只在版本确认和 API key 这类必要时刻介入。如果你手上是已发布的稳定版仓库内的各 host 打包指南如 claude_code/INSTALL.md与 SKILL.md 走的是同一条init→docs install→doctor配置路径本文的 git 安装方式只是把获取二进制这一步换成了 main 分支的最新源码。【免费下载链接】memUPersonal memory across agents项目地址: https://gitcode.com/GitHub_Trending/mem/memU创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考