Hindsight 部署指南容器、嵌入、云端三种方式 3 步落地【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsightHindsight 是一个面向 AI 智能体的记忆系统让智能体记住经验而不只是聊天记录。Hindsight 部署本身不复杂拉一个容器镜像、配好 LLM 密钥、用客户端 SDK 存一条记忆全程十几分钟。下面按这条主线给出最小操作路径只保留跑通服务必需的东西。 一分钟认知Retain、Recall、Reflect 怎么分工Hindsight 把记忆组织成类似人类记忆的结构数据落在 PostgreSQL 里内置 pgvector。它对外只暴露三个动作Retain把内容写进记忆库Recall按查询取回相关记忆Reflect在取回内容上生成一段综合性的洞察回答。一个记忆库bank对应一个独立的命名空间多用户、多智能体可以各用一个 bank 互相隔离。 场景选型三种方式一张表选部署方式前先想清楚服务跑在哪、给谁用。三种方式的差别主要在要不要独立进程和数据放哪方式适合场景特点Docker 容器本地试验、独立部署一条命令起服务内置 pg0 数据库最快外部 PostgreSQL Compose独立部署、小型生产数据与容器解耦方便备份本地嵌入式Python开发测试、原型验证不起独立服务pip install后进程内使用企业级场景高可用、横向扩展在这三者基础上换成云托管 PostgreSQL 和 S3 存储配置思路一致只是连接串换成云实例地址。⚙️ 分步落地三步跑起来第一步选定环境拉取镜像容器方式内置 pg0 数据库数据目录映射到本机重启不丢export OPENAI_API_KEYsk-xxx docker run --rm -it --pull always -p 8888:8888 -p 9999:9999 \ -e HINDSIGHT_API_LLM_API_KEY$OPENAI_API_KEY \ -v $HOME/.hindsight-docker:/home/hindsight/.pg0 \ ghcr.io/vectorize-io/hindsight:latest如果要用外部 PostgreSQL 做 Docker 部署记忆服务改用现成的 Compose 文件export HINDSIGHT_DB_PASSWORDchoose-a-password cd docker/docker-compose/external-pg docker compose up -d第二步配置密钥启动服务启动后 API 在 http://localhost:8888管理界面在 http://localhost:9999。换 LLM 提供商只需改两个环境变量例如HINDSIGHT_API_LLM_PROVIDERanthropic配HINDSIGHT_API_LLM_MODELclaude-sonnet-4-20250514接本地模型LM Studio则把HINDSIGHT_API_LLM_BASE_URL指向http://localhost:1234/v1。第三步用客户端 SDK 存一条记忆嵌入式路线不用起服务装包即用pip install hindsight-all hindsight-clientfrom hindsight import HindsightServer, HindsightClient with HindsightServer(llm_provideropenai, llm_modelgpt-5-mini, llm_api_keysk-xxx) 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?))远程服务用同一套客户端把base_url换成http://localhost:8888即可。✅ 验收与避坑健康检查和三类高频故障先确认服务活着curl http://localhost:8888/api/health返回 200 后再发一次 Retain/Recall 往返能取回刚存的内容才算跑通。遇到下面三类问题按对应思路处理数据库连不上检查 PostgreSQL 是否在运行、HINDSIGHT_API_DATABASE_URL中的主机、端口、库名是否与服务实际暴露的一致Compose 网络里用服务名db而非localhost。API 密钥错误确认HINDSIGHT_API_LLM_API_KEY传到了容器内-e或环境变量密钥本身在提供商后台有效且未过期。内存不足pg0 单文件数据库 模型调用较吃内存给容器留足内存上限生产建议切外部 PostgreSQL 并控制并发。后续参考到这里Hindsight 部署的完整闭环已经走通镜像、密钥、客户端验证各占一步剩下的只是按场景换数据库和存储。现在就选一种方式跑一条docker run把第一条记忆存进去。Compose 配置目录含 external-pg、S3、TEI 等变体docker/docker-compose/官方文档hindsight-docs/docs/Kubernetes Helm Charthelm/hindsight/【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考