Hindsight:AI 长期记忆
Hindsight 是面向 AI Agent 的 PostgreSQL-native 长期记忆服务。
Pigsty 提供 app/hindsight 配置模板(conf/app/hindsight.yml),默认使用 Pigsty 托管的 PostgreSQL,而不是 Hindsight 内置的开发数据库。
快速开始
默认访问地址:
- UI:
http://hs.pigsty或http://<IP>:9999 - API:
http://hs-api.pigsty或http://<IP>:8888
关键配置
conf/app/hindsight.yml 会在 apps.hindsight.conf 中覆盖 /opt/hindsight/.env。重点参数:
HINDSIGHT_API_PORT:容器内 API 监听端口,默认8888(控制面连接地址HINDSIGHT_CP_DATAPLANE_API_URL默认自动联动此端口)HINDSIGHT_API_PUBLISH_PORT:API 宿主机发布端口,默认8888HINDSIGHT_UI_PUBLISH_PORT:UI 宿主机发布端口,默认9999HINDSIGHT_DB_HOST/HINDSIGHT_DB_PORT/HINDSIGHT_DB_NAME/HINDSIGHT_DB_USER/HINDSIGHT_DB_PASSWORDHINDSIGHT_API_VECTOR_EXTENSION:默认pgvectorHINDSIGHT_API_TEXT_SEARCH_EXTENSION:默认nativeHINDSIGHT_API_LLM_PROVIDER:默认noneHF_HUB_OFFLINE:默认1,直接使用官方镜像内预置的本地模型,避免运行时请求 Hugging Face Hub;如需下载未缓存的新模型,将其设为0并开放出站网络
默认 none LLM Provider 可以保留文本并使用本地 embedding/reranker 模型召回;事实抽取、反思与整合能力需要配置 Ollama 或 OpenAI 兼容 API。
Compose 将命名卷 hindsight-cache 挂载到 /home/hindsight/.cache,利用 Docker 命名卷的首次 copy-up 机制保留镜像内预置模型并在容器重建后持久化缓存。
数据库需启用 vector 以及安装在 public 模式下的 pg_trgm(上游 trigram 索引迁移依赖 public 模式)。conf/app/hindsight.yml 已默认声明 extensions: [ vector, { name: pg_trgm, schema: public } ];若接入已有数据库,请确认 pg_trgm 位于 public(CREATE EXTENSION IF NOT EXISTS 不会移动已安装在其他模式中的扩展)。
运维命令
容器内置健康检查与 make health 会同时探测 API 的 /health/ready 和 UI 代理的 /api/banks?limit=1,确认数据面就绪且控制面能够正常连接 API。
参考
- Hindsight 项目: https://github.com/vectorize-io/hindsight
- Pigsty 模板: https://github.com/pgsty/pigsty/blob/main/conf/app/hindsight.yml
这个页面对您有帮助吗?
感谢反馈,我们会据此改进这篇文档。
哪里没有解决?(可选)