Hindsight 安装指南：一条 Docker 命令跑起智能体记忆服务

Hindsight 安装指南一条 Docker 命令跑起智能体记忆服务【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsightHindsight 是一个智能体记忆系统它不只保存对话还让智能体 retain存、recall取、reflect反思。本文带你完整走一遍 Hindsight 部署一条 Docker 命令跑起服务再接进你的 Python 应用。适合想给对话机器人或编码智能体加长期记忆的开发者和运维。跑起来后你会看到什么终端会持续滚动启动日志数据库自动完成建表迁移Web 管理界面直接在浏览器打开。你可以创建记忆库bank一个隔离的记忆存储空间、查看实体和知识页手动执行记忆存取。一条 Docker 命令跑起 Hindsight 部署 前置条件装好 Docker把程序和依赖打包、在隔离环境里运行的工具和一个 LLM 密钥。以 OpenAI 为例。第 1 步设置密钥并启动容器。你做什么执行下面的命令把 LLM 密钥传进容器数据用命名卷持久化。export HINDSIGHT_API_LLM_API_KEYsk-xxx docker run -it --pull always --name hindsight --restart unless-stopped \ -p 8888:8888 -p 9999:9999 \ -e HINDSIGHT_API_LLM_API_KEY$HINDSIGHT_API_LLM_API_KEY \ -v hindsight-data:/home/hindsight/.pg0 \ ghcr.io/vectorize-io/hindsight:latest成功后应该看到日志依次输出数据库迁移、模型加载最后 API 服务开始监听 8888 端口容器不退出。第 2 步打开管理界面。你做什么浏览器访问http://localhost:9999。成功后应该看到控制平面Control Plane页面加载出来左侧是记忆库、实体、知识页等导航可以直接新建 bank 并测试查询。第 3 步冒烟测试。你做什么终端执行curl http://localhost:8888/health/live。成功后应该看到返回一段 JSONstatus字段是alive。验证 Hindsight 服务健康的快速方法用两个端点回答两个不同的问题curl http://localhost:8888/health/live存活探针。进程能应答就说明活着不查数据库。curl http://localhost:8888/health/ready就绪探针。它会真实地连一次数据库返回 200 说明健康返回 503 说明数据库不可达。浏览器里http://localhost:9999能打开控制平面说明 UI 侧也活着。把 Hindsight 客户端接入你的应用 安装 Python 客户端pip install hindsight-client -U。然后三个核心调用覆盖全部使用场景from hindsight_client import Hindsight client Hindsight(base_urlhttp://localhost:8888) client.retain(bank_idmy-bank, contentAlice works at Google) print(client.recall(bank_idmy-bank, queryWhere does Alice work?)) print(client.reflect(bank_idmy-bank, queryTell me about Alice))retain把信息存进记忆库recall按相关性取回记忆reflect基于已有记忆做更深的归纳问答。bank_id就是那个隔离的记忆空间一个用户或项目给一个 bank 即可。走向 Hindsight 部署生产的三个关键点数据库默认容器内是 pg0——一个内嵌的 PostgreSQL适合开发不建议用于生产。生产换成外部 PostgreSQL 14并启用 pgvector 向量扩展。关键配置给 worker 设一个稳定身份否则容器重启后它正在处理的任务会被孤儿化。常用变量如下变量它的作用填什么HINDSIGHT_API_DATABASE_URL连接外部 PostgreSQLpostgresql://user:passhost:5432/hindsightHINDSIGHT_API_WORKER_IDworker 的固定身份跨重启不丢任务hindsight-prodHINDSIGHT_API_LLM_PROVIDER/HINDSIGHT_API_LLM_MODELLLM 提供商与模型openai/gpt-4o-miniHINDSIGHT_API_OTEL_TRACES_ENABLED开启分布式追踪true监控API 在/metrics暴露 Prometheus 指标仓库 monitoring/grafana/ 里有三套现成的仪表盘 JSON导入你的 Grafana 就能看到 LLM 调用、token 消耗和操作延迟细节见监控文档。排查 Hindsight 安装常见报错 症状启动日志报Permission denied内嵌数据库起不来。原因用宿主目录挂载时目录不归容器用户UID 1000所有。解决chown -R 1000:1000该目录或改用本文的命名卷方式。症状启动崩溃KeyError: getpwuid(): uid not found。原因用--user指定了镜像里没有的用户。解决去掉--user让容器以默认的 hindsight 用户UID 1000运行。症状docker compose up报Please set the HINDSIGHT_DB_PASSWORD env variable。原因外部 PostgreSQL 的 compose 文件要求先导出数据库密码和 LLM 密钥。解决先export HINDSIGHT_DB_PASSWORDxxx和export HINDSIGHT_API_LLM_API_KEYxxx再启动配置见 docker compose 目录。症状retain失败日志出现 401 或密钥无效。原因HINDSIGHT_API_LLM_API_KEY没传进容器或密钥与HINDSIGHT_API_LLM_PROVIDER不匹配。解决核对密钥换提供商时同时改 provider 和 model 变量。症状/health/ready返回 503。原因API 进程活着但数据库连不上。解决检查HINDSIGHT_API_DATABASE_URL是否正确、网络是否通、数据库是否已建好并启用 pgvector。症状容器起不来提示端口被占用。原因8888 或 9999 已被其他服务占用。解决改宿主侧端口映射例如-p 18888:8888并同步修改客户端的base_url。总结与下一步Hindsight 部署其实就三件事跑容器、给 LLM 密钥、接客户端。下一步建议先读安装指南了解 slim 镜像和外部数据库的完整选项再把外部 PostgreSQL 的 compose 配置跑起来完成一次真实的数据落盘验证。【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考