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。
• 提供贡献指南和治理文档，供社区参与。