Statewave 是面向 AI 智能体的开源内存运行时，目标是让 AI 系统拥有持久、结构化的记忆，并以可复现、带来源标记的上下文包取代查询时检索。它使用 Apache-2.0 许可，自托管于 Postgres + pgvector，提供 Python 与 TypeScript SDK。据官方说明，它并非聊天机器人框架、向量数据库、RAG 管道或托管服务，而是与应用程序并排运行的基础设施。
用途
多数 AI 应用没有记忆，每次对话都从头开始，跨会话上下文丢失、决策不被记住、用户历史在会话结束即消失。直接加向量数据库或把聊天日志塞进提示词，会形成脆弱、非结构化且难以扩展的上下文。Statewave 为 AI 系统提供持久、结构化的记忆，并给出清晰的数据生命周期：摄取、编译、检索、治理。所有内容围绕“主题”组织，主题可以是用户、账户、智能体、仓库或任何被跟踪的实体。
主要能力
- 编译式上下文包：按主题与任务生成排名、token 受限、确定性的上下文，同一主题在同一时间点使用同一查询总是产生相同字节。
- 来源追溯：每条记忆都可追溯到其源事件，回执采用内容哈希。
- 可插拔编译器：启发式编译器（正则、完全本地）或 LLM 编译器（任何 LiteLLM 提供商）。
- 主题组织：支持 user:、repo:、account: 或自定义实体前缀。
- 状态组装回执：不可变、ULID 可寻址，记录哪些记忆影响了每个包；HMAC-SHA256 签名、内嵌策略快照，并提供 POST /v1/receipts/{id}/replay。
- 敏感度标签与策略引擎：基于每条记忆标签（pii、financial、secret 等）的声明式 YAML 策略，支持 deny / redact，具有 log_only 与 enforce 模式；v0.9 增加启发式检测器给出的建议标签（pii.email/phone、financial.card、secret.token），需操作员审核并通过管理应用显式提升。
- 多租户：通过 X-Tenant-ID 请求头实现查询范围内的数据隔离，支持每租户配置与策略；v0.9 增加按租户区域固定，固定到 eu 的租户在其他区域请求会收到 403。
- 自托管：基于 Postgres + pgvector，无供应商锁定，运行在自有基础设施上。
- 无需 GPU：API 进程仅用 CPU，只有自托管 LLM 编译器或嵌入模型时才涉及 GPU。
- 框架无关：通过 REST API 或类型化 SDK 与任何 AI 技术栈、任何语言协作。
使用方式
最快方式是一行命令启动服务器（具体命令见官方文档）；也可自行运行，默认会拉起 Postgres（pgvector）+ API，容器启动时自动执行迁移，API 位于 http://localhost:8100。默认以演示模式启动，使用基于哈希的桩嵌入 + 启发式编译器，没有真正的语义搜索。如需 LLM 支持的行为，在 docker-compose.yml 旁添加 .env 并重新执行 docker compose up -d。可通过 GET /readyz 确认 LLM 密钥是否被读取。也支持 Docker / Helm 自托管，SDK 文档见 statewave-py（Python）与 statewave-ts（TypeScript）。设置全部使用 STATEWAVE_ 环境前缀，可复制 .env.example 到 .env 开始。官方推荐将 STATEWAVE_COMPILER_TYPE 设为 llm、STATEWAVE_EMBEDDING_PROVIDER 设为 litellm，并提供 STATEWAVE_LITELLM_API_KEY；Statewave 通过 LiteLLM 支持 OpenAI、Anthropic、Azure、Ollama、Cohere、Gemini、Bedrock、Mistral、Groq 等 100+ 提供商，只需将 STATEWAVE_LITELLM_MODEL 设为对应的 LiteLLM 模型标识。不使用 LLM 密钥时启发式编译器仍可工作。
Statewave 不仅限于实时聊天记录，连接器可将真实事件作为事件喂入 Statewave，连接器位于独立仓库，模块化安装。示例包括：客服智能体（跨会话识别回访客户、带 token 预算的排名上下文、来源追溯、升级时的交接包）、长时运行编码智能体（多会话项目记忆，技术栈、偏好、架构决策在对话间保持）、无状态与记忆驱动智能体的对比（使用真实 LLM）。官方示例仓库还提供最小快速开始、评估套件（23 个测试、56 个断言）、基准测试，以及 LangChain、CrewAI、AutoGen 等框架集成。
适用场景
适合需要为 AI 智能体增加持久、可追溯、可治理记忆的团队，例如客服、编码智能体、多会话助理，以及需要自托管、可控数据流、多租户隔离和审计能力的企业应用。
限制
据官方 v1.5.0 状态：速率限制按 IP，默认内存策略为每进程，多副本部署需 STATEWAVE_RATE_LIMIT_STRATEGY=distributed（由 Postgres 支持），且仅按 IP 而不按租户或 API 密钥。多租户位于应用层，尚无 Postgres RLS。无内置认证提供方，只校验你配置的 API 密钥，不签发密钥。尚无管理员操作身份，v0.9 自动标签提升端点会记录 promoted_at 与标签，但 promoted_by 在管理员身份层发布前为 null。无可视化策略编辑器，策略包以 YAML 在 git 中编写并通过管理流程上传。无跨区域联邦审计，v0.9 按设计实施严格区域隔离。回放为“当前代码 + 原始策略”，字节级历史复现需要记忆快照，尚未提供。多副本生产可运行（Fly 多机 + Helm HPA 已验证），重负载瓶颈在 Postgres 与嵌入提供商。当前版本 v1.5.0，处于活跃开发中。
以上信息均来自官方仓库说明；未提及的收费、价格、具体平台覆盖范围等事实暂未提供。
