ReMe Python 嵌入式 API 完整指南在宿主 Agent 进程内直接调用记忆能力【免费下载链接】ReMeReMe: Memory Management Kit for Agents - Remember Me, Refine Me.项目地址: https://gitcode.com/GitHub_Trending/me/ReMeReMeRemember Me, Refine Me是面向 AI Agent 的本地优先记忆管理工具包它把对话和资源沉淀成可读、可检索的 Markdown 记忆文件。除了以独立服务运行外ReMe 还提供 Python 嵌入式 API你不需要启动服务、不占用端口直接在宿主 Agent 的 Python 进程内创建 ReMe 应用实例通过run_job调用search、auto_memory等记忆能力实现进程内记忆。为什么需要嵌入式模式大多数 Agent 接入 ReMe 有两条路方式运行位置需要端口/服务适合场景HTTP/MCP 服务独立reme start进程是多 Agent 共享、进程隔离、独立运维嵌入式Python API宿主 Agent 进程内否单机使用、不想维护服务和端口嵌入式模式的核心优势零服务依赖无需reme start不监听端口没有网络开销生命周期共享ReMe 应用与宿主 Agent 同起同落宿主关闭时资源一并释放能力全量复用文件读写、BM25 混合检索、auto_memory自动记忆沉淀、auto_dream等 Job 与 HTTP 模式完全一致。一键安装ReMe Python SDK 快速准备嵌入式模式要求宿主环境是 Python 3.11安装命令只有一条pip install reme-ai[core]基础文件操作、BM25 检索、wikilink 遍历不需要任何 LLM 凭据即可运行只有auto_memory、auto_dream这类记忆进化能力才需要配置 LLM 环境变量见 example.env。进程内启动三步创建 ReMe 应用嵌入式接入的核心三步完整装配逻辑见 reme/application.py测试中的标准写法可参考 tests/integration/_workspace_fixture.pyfrom reme import Application from reme.config import resolve_app_config cfg resolve_app_config(workspace_dir/path/to/reme-workspace, log_to_consoleFalse) app Application(**cfg) await app.start()关键参数说明workspace_dir指定记忆工作区位置目录结构包含session/、resource/、daily/、digest/等分层详见 README_ZH.md 的工作区布局配置默认读取 reme/config/default.yaml也可以传入其他配置名切换预设。调用记忆能力search 与 auto_memory应用启动后所有 Job 都通过await app.run_job(名称, **参数)直接调用接口定义见 reme/application.py# 模型调用前召回相关记忆 resp await app.run_job(search, query用户偏好的代码风格, limit5) # 回合结束后自动沉淀记忆 await app.run_job(auto_memory, session_idsess-001, messages[...]) # 宿主退出时 await app.close()典型宿主集成模式是调用前 prefetch、回合后写入每次模型调用前先search把相关记忆注入上下文完整回合结束后把对话交给auto_memory异步沉淀到daily/层。这正是官方 Hermes 集成的工作方式其实现可参考 integrations/hermes_agent/embedded_backend.py。进阶事件循环隔离的最佳实践如果宿主进程已有自己的 asyncio 事件循环或宿主本身是同步代码推荐的工程实践是为 ReMe 开一个专用线程和事件循环把所有run_job调用提交到该线程执行避免相互阻塞。官方嵌入式后端的完整实现含状态机、超时控制、失败清理就在 integrations/hermes_agent/embedded_backend.py可直接借鉴。如图中所示QwenPaw 就是通过 Python API 进程内嵌入 ReMe 的它复用宿主的生命周期和模型配置同时保持记忆完全本地化、文件化——这正是嵌入式模式的典型收益。选型建议与延伸阅读宿主是Python 进程、单机使用→ 选嵌入式本文方案即可需要多个 Agent 共享同一工作区或宿主不是 Python如 Node.js 插件 → 选 HTTP/MCP 服务对比两种召回模式的实际效果可看 integrations/hermes_agent/figures/hermes-http-recall.png 对应的 Hermes 集成文档中文。更多原理框架结构与 Application 生命周期docs/zh/framework.md记忆检索机制BM25 可选向量docs/zh/memory_search.md默认配置含 embedding 开关reme/config/default.yaml一句话总结只要宿主 Agent 跑在 Python 里用 ReMe 嵌入式 API 就能省去整个服务进程几行代码获得与 HTTP 模式同等的记忆检索与自进化能力。【免费下载链接】ReMeReMe: Memory Management Kit for Agents - Remember Me, Refine Me.项目地址: https://gitcode.com/GitHub_Trending/me/ReMe创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考