Repolode
vectorize-io

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. 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. 2

    安装 Python 客户端

    pip install hindsight-client -U
  3. 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 数据每日更新。

相关项目