为 AI 智能体和应用提供长期记忆层,跨会话保存并检索用户与上下文信息。
vectorize-io/hindsight
面向 AI 智能体的记忆系统,支持存储、检索与反思记忆,让智能体随时间学习而非仅回放对话历史。
- Star
- 51,907
- Fork
- 6,178
- 未关闭 Issue
- 148
- 最近提交
- 6小时前
这是什么?
Hindsight 是一个面向 AI 智能体的记忆系统,目标是让智能体能够从经验中学习,而不只是记住对话历史。它将记忆组织为世界事实、智能体自身的经历、整合后的观察结论以及随时间形成的心智模型。
核心接口包含三类操作:retain 用于写入新信息,由 LLM 抽取事实、实体和关系;recall 并行执行语义向量、BM25 关键词、实体图谱和时间范围检索,再合并排序结果;reflect 则在已有记忆之上做更深入的分析。记忆按 bank 隔离,每个 bank 可对应一个用户、智能体或项目,服务端还为每个 bank 提供 MCP 端点。
部署方式包括 Docker、pip 安装和 Kubernetes Helm Chart,存储基于 PostgreSQL 与 pgvector。项目提供 Python、Node.js、Go 和 CLI 客户端,支持多种大模型提供商,也可接入 Ollama、LM Studio 等本地模型。
核心功能
- 01提供 retain、recall、reflect 三类操作,用于写入和查询智能体记忆
- 02recall 结合向量、关键词、实体图谱与时间检索,并进行重排序
- 03记忆按 bank 隔离,可分别对应用户、智能体或项目
- 04每个 bank 内置 MCP 端点,便于兼容 MCP 的客户端调用
- 05支持 25 个以上大模型提供商,包括通过 Ollama、LM Studio 运行的本地模型
- 06提供 Python、Node.js、Go 和 CLI 客户端以及 REST API
适用场景
- 为聊天机器人记住每位用户的偏好与历史,实现个性化
- 为编程智能体提供项目架构与历史会话的长期记忆
- 通过封装 OpenAI 或 Anthropic 客户端,为现有 LLM 应用添加记忆
- 构建能根据累积反馈调整行为的自主智能体
快速上手
- 1
用 Docker 启动服务器
docker run -it --pull always --name hindsight --restart unless-stopped -p 8888:8888 -p 9999:9999 -e HINDSIGHT_API_LLM_API_KEY=$OPENAI_API_KEY -v hindsight-data:/home/hindsight/.pg0 ghcr.io/vectorize-io/hindsight:latest - 2
安装 Python 客户端
pip install hindsight-client -U - 3
连接客户端并进行存储、召回或反思记忆
使用前须知
- 完整自托管需要 LLM 提供商的 API 密钥或本地模型配置。
- Intel 芯片的 Mac 需要单独的 hindsight-all-slim 包才能嵌入使用。
标签
常见问题
- hindsight 是什么?
- 面向 AI 智能体的记忆系统,支持存储、检索与反思记忆,让智能体随时间学习而非仅回放对话历史。 Hindsight 是一个面向 AI 智能体的记忆系统,目标是让智能体能够从经验中学习,而不只是记住对话历史。它将记忆组织为世界事实、智能体自身的经历、整合后的观察结论以及随时间形成的心智模型。
- hindsight 可以免费使用吗?用的什么许可证?
- hindsight 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- hindsight 还在维护吗?
- 活跃维护中。hindsight 最近一次提交是在 2026年10月20日。
- hindsight 适合用来做什么?
- 为聊天机器人记住每位用户的偏好与历史,实现个性化 为编程智能体提供项目架构与历史会话的长期记忆 通过封装 OpenAI 或 Anthropic 客户端,为现有 LLM 应用添加记忆 构建能根据累积反馈调整行为的自主智能体
- hindsight 怎么安装和运行?
- 用 Docker 启动服务器: docker run -it --pull always --name hindsight --restart unless-stopped -p 8888:8888 -p 9999:9999 -e HINDSIGHT_API_LLM_API_KEY=$OPENAI_API_KEY -v hindsight-data:/home/hindsight/.pg0 ghcr.io/vectorize-io/hindsight:latest 安装 Python 客户端: pip install hindsight-client -U 连接客户端并进行存储、召回或反思记忆
- 在哪里获取 hindsight?
- 源代码和安装说明在 GitHub 上:https://github.com/vectorize-io/hindsight
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
面向 AI 应用与助手的记忆与上下文引擎,通过统一 API 提供持久记忆、RAG、用户画像和数据连接器。
面向智能体的记忆基础设施,将对话与执行过程转化为可持久化的结构化记忆,支持 Python 与 TypeScript。
用于构建、测试和部署 AI 智能体与工作流的可视化平台,可通过 API 或 MCP 服务器对外调用。
开源 RAG 引擎,将检索增强生成与智能体能力结合,为大模型应用提供上下文层。
本地优先的 AI 记忆系统,逐字保存对话历史,并通过语义搜索检索,提供 MCP 服务与命令行工具。