smaramwbc/statewave

Open-source memory runtime for AI agents — reproducible, provenance-tagged context bundles instead of query-time retrieval. Apache-2.0, self-hosted on Postgres + pgvector, Python + TypeScript SDKs.

解决的问题

Statewave 为 AI 代理提供持久化、结构化的内存运行时，防止会话间上下文丢失。它用确定性系统取代了脆弱、非结构化的提示填充或简单向量数据库检索，确保代理在不同对话中都能记住偏好、决策和历史记录。

工作原理

Statewave 作为基础设施运行，采用“先编译后使用”的方法：

  1. 摄入：原始事件（剧集）以仅追加格式记录。
  2. 编译：这些剧集被处理为带有置信度分数和出处的类型化、摘要化记忆。
  3. 检索：系统按需组装排名、令牌受限的上下文包。
  4. 治理：支持检查主题时间线，并按主题删除数据。

该过程具有幂等性，即对同一主体在相同时间点的相同查询始终产生相同结果，消除了查询时检索中常见的采样噪声。

适用人群

需要在多个会话中记住用户特定数据和架构决策，但又不想被锁定在特定聊天机器人框架中的 AI 代理开发者（如客户支持或长期运行的编码代理）。

主要亮点

  • 出处追踪：每个记忆均可通过内容哈希收据追溯到其原始来源剧集。
  • 确定性上下文：为每个主体和任务提供一致的令牌受限包。
  • 可插拔编译器：支持本地启发式编译器（正则表达式）和通过 LiteLLM 的 LLM 基础编译器。
  • 自托管：在 Postgres 和 pgvector 上运行，确保用户拥有存储，避免供应商锁定。
  • 多租户支持：支持查询范围内的数据隔离和区域固定，以满足数据驻留要求。
  • 框架无关：通过 REST API 或 SDK 与任何 AI 堆栈集成，包括 LangChain、CrewAI 和 AutoGen。

相关

  • 项目
    Atmosphere/atmosphere

    Atmosphere 是一个基于 JVM 的框架，让您可以将 AI 代理编写为带注解的 Java 类。它提供实时流式传输（WebSocket、SSE、gRPC、可选的 HTTP/3）、持久化内存、策略驱动的治理、人工介入审批，以及适用于许多 LLM 提供者的适配器。代理可以无需重写代码，即可暴露给浏览器、Slack、Discord、MCP、A2A 等。

  • 项目
    LeoYeAI/talewell

    Talewell 是一个基于 Git 和 Markdown 的 AI 代理长期记忆系统。它将每个记忆记录存储为版本控制文件，提供确定性的离线回忆功能，强制执行来源验证，并公开可移植的 AMP 协议，让任何代理平台（如 OpenClaw、Claude Code、Codex 等）都能通过插件或简单的文件惯例使用同一个记忆仓库。

  • 项目
    rtk-ai/icm

    ICM 是一个基于 Rust、使用 SQLite 存储的 AI 编码代理记忆系统。它无需调用 LLM 即可存储和回忆项目特定的事实，支持基于关键词或嵌入的搜索，可与许多编码助手集成，并达到与大型服务相当的基准准确率。

  • 项目
    basicmachines-co/basic-memory

    一个为 AI 助理设计的持久化双向记忆系统，利用共享 Markdown 文件与模型上下文协议 (MCP) 来建立长期知识图谱。

  • 项目
    yuruotong1/autoMate

    autoMate 是一个本地托管服务，为 AI 聊天客户端提供持久的个人存储（笔记、文件、提醒、长期记忆）和现实世界操作工具箱（Shell、浏览器、SaaS API）。它通过 MCP-over-HTTP 桥接与客户端通信，兼容 OpenClaw、Claude Desktop、Cursor、Cline 等，也可通过其自身 Web 聊天、Chrome 扩展、Docker 容器或二进制文件使用。