Hindsight 记忆系统：三种部署路径，Docker 最快 2 分钟跑通

Hindsight 记忆系统三种部署路径Docker 最快 2 分钟跑通【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsightHindsight 是一个让 AI 智能体持续学习的记忆系统不只是存聊天日志。本文带你走通三条部署路径Docker、本地 Python 嵌入式、云端与 K8s外加客户端接入、配置速查和上线前验证。它怎么记住东西的把 Hindsight 想成一个带后台整理的记忆库而不是搜索框。你写入的内容先被拆成事实、实体、时间关系存进向量索引和关系图检索时同时跑语义、关键词、图谱、时间四条通道。所以它能答出上个月 Alice 做了什么这种带时间维度的问题纯向量库做不到这一点。Docker 一键启动 Hindsight 记忆系统假设你已经export OPENAI_API_KEYsk-xxx最小启动命令docker run -d --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两个端口的分工8888 是 API 服务你所有 retain/recall 请求打这里9999 是 Web 管理界面浏览器里看 bank、记忆条数、运维状态。镜像内置 pg0 嵌入式数据库首次启动约 30 秒内/health就能返回 200不用额外装任何数据库。要换外部 PostgreSQL生产环境建议这样一行搞定compose 文件里有 pgvector 版 PG 18 和应用两个服务cd docker/docker-compose/external-pg HINDSIGHT_DB_PASSWORD你的密码 HINDSIGHT_API_LLM_API_KEY$OPENAI_API_KEY docker compose up -dPython 嵌入式部署不需要独立进程不想维护一个常驻服务的话hindsight-all直接把服务嵌进你的 Python 进程pip install hindsight-all -Uimport os from hindsight import HindsightServer, HindsightClient with HindsightServer(llm_provideropenai, llm_modelgpt-5-mini, llm_api_keyos.environ[OPENAI_API_KEY]) as server: client HindsightClient(base_urlserver.url) client.retain(bank_idmy-bank, contentAlice works at Google) print(client.recall(bank_idmy-bank, queryWhere does Alice work?))没有独立进程没有端口管理脚本结束服务就退出。适合开发测试和原型验证Intel Mac 上改用hindsight-all-slim。上生产云端部署与 Helm 最小 values 配置上生产主要动三处数据库换成云托管的RDS、Cloud SQL文件存储接 S3监控接 OpenTelemetry。关键环境变量就这几个HINDSIGHT_API_DATABASE_URL主库连接串读写都走它HINDSIGHT_API_READ_DATABASE_URL只读副本地址recall 流量可以分流过去HINDSIGHT_API_FILE_STORAGE_TYPEs3和HINDSIGHT_API_FILE_STORAGE_S3_BUCKET大文件不落本地盘HINDSIGHT_API_OTEL_TRACES_ENABLEDtrue追踪打到你的 OTLP 后端仓库自带 Helm Chart最小可用的 values 长这样api: replicaCount: 3 resources: limits: memory: 4Gi postgresql: enabled: true existingSecret: hindsight-secretsecret 里放HINDSIGHT_API_LLM_API_KEY和数据库密码即可Chart 的 liveness 打/health/live、readiness 打/health数据库抖了 pod 会自动摘流量而不是重启。客户端接入base_url 指向哪里无论上面哪条路径客户端接入方式都一样base_url填你 API 服务的地址Docker 是http://localhost:8888云端填你的域名。Pythonpip install hindsight-client -Ufrom hindsight_client import Hindsight client Hindsight(base_urlhttp://localhost:8888) client.retain(bank_idmy-bank, contentAlice works at Google) client.recall(bank_idmy-bank, queryWhat does Alice do?)Nodenpm install vectorize-io/hindsight-clientconst { HindsightClient } require(vectorize-io/hindsight-client); const client new HindsightClient({ baseUrl: http://localhost:8888 }); await client.retain(my-bank, Alice loves hiking); console.log(await client.recall(my-bank, What does Alice like?));配置速查5 个最常用的环境变量HINDSIGHT_API_LLM_PROVIDER/HINDSIGHT_API_LLM_MODEL/HINDSIGHT_API_LLM_API_KEY选哪家 LLM支持 openai、anthropic、gemini、ollama、lmstudio 等 25 种HINDSIGHT_API_DATABASE_URL数据库连接串不设置就用内置 pg0HINDSIGHT_API_READ_DATABASE_URL只读副本做读写分离HINDSIGHT_API_FILE_STORAGE_TYPE文件存储后端默认本地盘生产建议s3HINDSIGHT_API_LOG_LEVEL开发用debug生产用info上线前 5 分钟验证健康检查与记忆闭环先确认两个端口活着curl -sf http://localhost:8888/health echo API_OK curl -sf -o /dev/null -w %{http_code} http://localhost:9999/health会真实检查数据库连通性数据库不通返回 5039999 返回 200 即可。再跑一个 retain/recall 闭环验证 LLM 提取链路也通from hindsight_client import Hindsight client Hindsight(base_urlhttp://localhost:8888) client.retain(bank_idsmoke-test, content部署自检Hindsight 记忆系统上线) print(client.recall(bank_idsmoke-test, query部署自检))recall 能带出刚写入的内容闭环就通了。注意 retain 是异步抽取写入后隔 1-2 秒再 recall 更稳。踩坑三条症状/health返回 503日志里 LLM 调用报 401 或连接失败 →原因HINDSIGHT_API_LLM_API_KEY没传进容器或 provider 和 key 不匹配 →修复docker rm -f hindsight docker run ... -e HINDSIGHT_API_LLM_API_KEY$OPENAI_API_KEY ...照第 4 节命令重跑症状容器重建后所有记忆丢了 →原因没给 pg0 挂卷数据写在容器可写层里删容器即丢失 →修复启动命令加-v hindsight-data:/home/hindsight/.pg0数据落在 Docker volume 里持久化症状retain 一直不报错但 recall 结果为空 →原因LLM 抽取失败被静默吞掉或查询 bank_id 和写入的不一致 →修复把HINDSIGHT_API_LOG_LEVEL设为debug重跑一次 retain核对返回里的抽取条数确认两次调用的bank_id拼写完全相同方案对比速查三条路径怎么选场景路径优点注意点快速验证、中小规模Docker 单容器一条命令起步内置 pg0约 30 秒可用记得挂卷否则数据随容器消失开发测试、嵌入现有服务Python 嵌入式hindsight-all无独立进程、无端口随脚本生命周期单机单进程不适合高并发生产企业级、高可用Docker Compose 外置 PG / Helm 集群读写分离、多副本、S3 存储、OTel 监控配置项多secret 管理要提前规划下一步仓库里看什么docker/docker-compose/各种数据库与本地模型组合的 compose 文件helm/hindsight/values.yamlHelm Chart 全部可调项hindsight-docs/docs/官方文档含 retain/recall/reflect 细节【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考