CaviraOSS/LongMemory

LongMemory – AI 에이전트를 위한 지속적이고 시간 인식되며 관리되는 메모리

이것은 무엇인가

• 대규모 언어 모델(LLM) 애플리케이션 및 자율 에이전트를 위해 설계된 로컬 우선, SQLite 기반 메모리 엔진입니다.
• Hydrograph 그래프에 불변의 “노드”와 실행 가능한 엣지를 저장하여 출처, 타임스탬프 및 다국어 콘텐츠를 보존합니다.
• 여러 회상 모드（严格、历史、联想、世界基础）提供，强制执行时间真相、矛盾处理和访问控制。

关键能力

• 时间真相 – 分离记录时间和有效时间，确定性衰减、强化和整合。
• 治理 – 项目、租户、用户、角色和智能体范围，支持 ACL。
• 可解释回忆 – 基于证据的结果，可选通过 answer_from_evidence 进行单模型调用。
• 多语言支持 – 脚本检测、音译、跨语言嵌入。
• 集成 – 用于仓库、文件、Web 源、云文档的原生连接器；嵌入后端（兼容 OpenAI、Gemini、Bedrock、Ollama 等）； 智能体框架（CrewAI、AutoGen、LangGraph/LangChain、OpenAI Agents SDK）、IDE 插件（VS Code）、自动化工具（n8n、Dify、Flowise）以及 MCP 工具集。
• 操作界面 – TypeScript 库、CLI、HTTP API、MCP（可流式）、Web 仪表板、VS Code 扩展。

如何开始

1. 库 – npm install longmemory（或 pip install longmemory-sdk 用于 HTTP 客户端）。使用 createMemory() 创建记忆；使用 memory.ingest() / memory.recall() 摄取文本和回忆。
2. CLI – npm install -g longmemory；运行 longmemory init、longmemory ingest …、longmemory recall …。
3. 自托管服务 – 从源码运行（pnpm install && pnpm build && pnpm start）或通过 Docker（docker run -p 7331:7331 -v longmemory-data:/data ghcr.io/caviraoss/longmemory）。通过 ui compose 配置文件，仪表板可在端口 3000 上使用。

架构概览

• 摄取管道 → 不可变节点存储在 SQLite 中 → Hydrograph（节点、边、世界、实体的图）。
• 图驱动三个回忆引擎（严格、联想、世界基础），为 LLM 生成有界上下文。
• 图、API、MCP 工具和 UI 都基于单一 TypeScript 代码库构建。

典型用例

• 聊天助手的持久个人或团队记忆（聊天记忆、技能、LLM-Wiki）。
• 项目级知识库，保留决策、架构说明和代码影响事实。
• 智能体工具，其中操作需要基于证据的回忆（例如，自主 DevOps 机器人）。

部署选项

• Docker / Docker-Compose（API + 可选 UI）。
• 云平台（Heroku、Railway、Render、DigitalOcean App Platform、Vercel – 仅 UI）。
• 用于本地后台服务的原生 Windows 脚本。

基准与质量

• 附带基准测试工具（pnpm bench*），报告检索质量、时间行为、延迟和证据指标。

许可证

• Apache License 2.0（核心）；捆绑的 n8n 节点按要求使用 MIT。

了解更多

• 文档：docs/answering.md、docs/python-sdk.md、docs/mcp.md、ARCHITECTURE.md。
• 仓库根目录中的仪表板演示 GIF。
• 提供贡献指南和治理文档，供社区参与。