CaviraOSS/LongMemory

这是什么？

核心功能

• 01基于本地 SQLite 持久化，重新打开数据库后可恢复节点、实体、关系和时间历史。
• 02提供严格、历史、关联和外部核验四种检索模式。
• 03项目记忆涵盖决策、任务、失败经验和代码影响分析。
• 04按 token 预算组装上下文，并说明每条证据被选中的原因。
• 05支持 stdio 或带鉴权的 Streamable HTTP MCP 服务，并提供 CLI、HTTP 和 Python SDK 接口。
• 06可从 Claude Code、Codex、Gemini CLI 等编码智能体导入会话。

适用场景

• 让聊天机器人或编程智能体跨会话记住用户偏好。
• 记录项目决策与变更，使智能体能回答过去某一时间点的事实。
• 通过 MCP 为 LangGraph、CrewAI、AutoGen 等框架构建的智能体添加长期记忆。
• 在个人电脑或小型服务器上部署私有的自托管记忆服务。

快速上手

1. 1

   从 npm 安装该库

   npm install longmemory
2. 2

   全局安装命令行工具

   npm install --global longmemory
3. 3

   在项目中初始化 LongMemory

   longmemory init

使用前须知

• !Python SDK 只是 HTTP 客户端，需要单独运行自托管的 TypeScript 服务。
• !托管部署需要你自行设置 API 密钥、提供持久化存储，并在平台边缘处理 TLS。

收录于专题

标签

常见问题

LongMemory 是什么？

本地优先、可自托管的持久化记忆引擎，供 LLM 应用和智能体使用，支持时间感知检索与 MCP 集成。 LongMemory 是为 LLM 应用和自主智能体提供的记忆层，将对话、文档和项目事件存入本地 SQLite 数据库。与仅依赖向量相似度检索不同，它会区分记录时间与有效时间，能按指定时间回溯当时的事实，并处理新信息对旧信息的替代。检索支持严格、历史、关联和外部事实核验等模式，结果受 token 预算限制，并附带每条证据被选中的原因。

LongMemory 可以免费使用吗？用的什么许可证？

LongMemory 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

LongMemory 还在维护吗？

活跃维护中。LongMemory 最近一次提交是在 2026年10月18日。

LongMemory 适合用来做什么？

让聊天机器人或编程智能体跨会话记住用户偏好。 记录项目决策与变更，使智能体能回答过去某一时间点的事实。 通过 MCP 为 LangGraph、CrewAI、AutoGen 等框架构建的智能体添加长期记忆。 在个人电脑或小型服务器上部署私有的自托管记忆服务。

LongMemory 怎么安装和运行？

从 npm 安装该库: npm install longmemory 全局安装命令行工具: npm install --global longmemory 在项目中初始化 LongMemory: longmemory init

在哪里获取 LongMemory？

源代码和安装说明在 GitHub 上：https://github.com/CaviraOSS/LongMemory