Hindsight 智能体记忆系统怎么部署嵌入式、Docker 与 Kubernetes 三种方式快速上手【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight凌晨两点你重启了那台跑客服机器人的服务器它对用户的称呼、上周刚确认的订单细节全部清零——对话历史还在日志里但它又得从头认识你。问题出在记忆上传统方案只存对话文本而 Hindsight 是一个开源智能体记忆系统用 retain / recall / reflect 三个操作把信息沉淀成可检索、可推理的记忆重启后照样认得你。30 秒速览Hindsight 记忆系统解决什么问题Hindsight 把存入的信息拆成事实、经验、观察三类记忆后台自动把零散事实整合成带证据的观察检索时并行跑语义、关键词、图谱、时间四种策略再融合排序。它解决的核心场景是让长期运行的 AI 智能体跨会话保留并复用知识而不是每次都靠塞满上下文窗口。先判断你要走哪条路场景推荐方式备注Python 应用内直接集成嵌入式hindsight-all无独立服务进程Intel Mac 用 slim 版本地验证、小型部署Docker 单容器内置 pg0 数据库一条命令起步卷持久化数据生产环境Docker 外部 PostgreSQL仓库自带 compose 文件集群化、多副本Kubernetes Helm支持独立扩展 worker 副本不想管基础设施官方托管服务Hindsight Cloud客户端指向其 API 地址即可前置准备最小依赖清单一个可用的 LLM API KeyOpenAI、Anthropic、Groq 等 25 提供商或 Ollama 等本地端点。选 Docker容器/K8s 方案或 Python 3pip 方案其一。外部 PostgreSQL 需 14 版本并启用向量扩展pgvector 默认内置数据库方案不需要。资源底线Full 镜像约 2 GB 内存、slim 镜像约 1 GBPostgreSQL 约 1 GB依据安装文档 给出的硬件表。预留端口API 8888、管理界面 9999。方案一嵌入式部署到 Python 应用适合想在应用进程里直接持有记忆能力、不想多管一个服务的人。不适合多语言客户端共用、或需要独立扩缩容的团队。步骤安装完整包pip install hindsight-allIntel Mac 装hindsight-all-slim。在应用里启动内嵌服务拿到服务地址。用客户端执行 retain / recall。关键配置服务随应用同生命周期LLM 密钥走环境变量最稳from hindsight import HindsightServer, HindsightClient with HindsightServer(llm_provideropenai, llm_api_keysk-xxx) as server: client HindsightClient(base_urlserver.url) client.retain(bank_idalice, contentAlice prefers concise answers.) client.recall(bank_idalice, queryHow should I respond?)另有HindsightEmbedded模式服务以守护子进程运行可被多个进程共享适合脚本间复用同一套记忆。参考 hindsight-all 说明。方案二Docker 一键启动内置数据库适合本地验证、原型和小型部署。不适合需要跨节点共享数据库或独立备份策略的生产环境。步骤确认 Docker 已安装并运行。单行启动带数据卷与端口映射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 -v hindsight-data:/home/hindsight/.pg0 ghcr.io/vectorize-io/hindsight:latest curl http://localhost:8888/api/health浏览器打开 http://localhost:9999 确认管理界面可访问。关键配置数据卷用命名卷如上的hindsight-data而不是宿主目录宿主目录必须归 UID 1000 所有否则数据库报 Permission denied。HINDSIGHT_API_WORKER_ID设为固定值如-e HINDSIGHT_API_WORKER_IDhindsight-prod。容器默认用容器 ID 当 worker 身份重启后变化重启前正在处理的任务会滞留无法认领。镜像变体Full 版latest内置本地嵌入与重排模型slim 版约 500 MB但必须外接嵌入/重排服务。方案三Docker Compose 外部 PostgreSQL适合生产环境数据库要独立备份、独立扩缩容。不适合不想额外维护数据库的纯原型场景。步骤使用仓库现成的 compose 文件docker/docker-compose/external-pg/。设置必填环境变量export HINDSIGHT_DB_PASSWORDchoose-a-strong-password export HINDSIGHT_API_LLM_API_KEYsk-xxx docker compose -f docker/docker-compose/external-pg/docker-compose.yaml up -d等hindsight-db与hindsight-app两个容器就绪访问 8888/9999 端口验证。关键配置compose 文件用pgvector/pgvector官方镜像并挂载pg_data卷密码变量未设置会直接拒绝启动这是有意的防呆设计。若改用自己的托管 PostgreSQLSupabase、Neon、RDS 等对应设置HINDSIGHT_API_DATABASE_URL且库中须已执行CREATE EXTENSION vector;。方案四Kubernetes Helm 部署适合需要自动扩缩容、多副本高可用的团队。不适合只有单机资源的场景开销不划算。步骤确认 Helm 3.8 与集群访问权限。安装内置 PostgreSQLhelm install hindsight oci://ghcr.io/vectorize-io/charts/hindsight --set api.llm.provideropenai --set api.llm.apiKeysk-xxx --set postgresql.enabledtrue需要吞吐时加 worker 副本helm upgrade hindsight oci://ghcr.io/vectorize-io/charts/hindsight --set worker.enabledtrue --set worker.replicaCount3关键配置worker 以 StatefulSet 部署Pod 名固定任务身份在重启后依然可识别如果你换成普通 Deployment必须给每个副本显式设置HINDSIGHT_API_WORKER_ID否则任务会成孤儿。全部可调项见 helm/hindsight/values.yaml。踩坑速查高频问题三句话现象原因解决内置库启动报 Permission denied宿主绑定目录不归容器用户UID 1000所有改用命名卷或把目录属主改为 UID 1000容器重启后任务滞留、不再被认领worker 身份取容器 ID每次重启都变设固定的HINDSIGHT_API_WORKER_IDIntel Mac 上 pip 安装成功却行为异常完整包无 Intel Mac 轮子静默回退到旧版本改装hindsight-all-slim并配外部嵌入服务外部 PostgreSQL 连接报缺扩展数据库未装向量扩展建库后执行CREATE EXTENSION vector;LLM 调用超时网络或密钥问题先用 curl 单独验证提供商端点再检查密钥与代理进阶调优三条真正影响性能的点slim 镜像 外部嵌入/重排服务镜像从约 9 GB 降到约 500 MB常驻内存降到 1 GB 内代价是多一个外部服务依赖。recall 延迟瓶颈在重排CPU 上跑 cross-encoder 是主要开销可给 GPU 或把重排卸载到外部服务TEI、Cohere 等。worker 与 API 分离扩缩容worker.replicaCount独立加副本写入/整合吞吐提升不影响 API 面。收尾与下一步四种方式本质是同一个 API 服务在不同载体上嵌入式进你的进程Docker 管单机Compose 把数据库拆出去Helm 管集群。从嵌入式或单容器起步验证功能再按压力逐步外移数据库和副本是最平滑的路径。下一步都可以直接执行通读 hindsight-docs/docs/developer/installation.md里面有 Windows、slim 镜像等细节。跑一遍 docker/docker-compose/external-pg/ 的 compose体会生产形态。部署完成后对照 hindsight-docs/docs/developer/performance.md 做基线测量。【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考