Hindsight Docker Compose配置：多服务部署方案完整指南 🚀

【免费下载链接】hindsight Hindsight: Agent Memory That Learns 项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight

Hindsight是一款革命性的AI代理记忆系统，能够帮助AI智能体学习和记忆，而不是简单的数据存储。通过Docker Compose多服务部署方案，您可以轻松搭建高性能的记忆系统，支持从个人项目到企业级应用的各种场景。本文将为您详细介绍Hindsight的8种Docker Compose配置方案，帮助您选择最适合的部署方式。

为什么选择Hindsight作为AI代理记忆系统？ 🤔

Hindsight不同于传统的RAG或知识图谱方案，它采用仿生数据结构来组织AI记忆，让智能体真正学会从经验中学习。系统提供三种核心操作：Retain（存储）、Recall（检索） 和 Reflect（反思），让AI能够建立长期记忆和心智模型。

Docker Compose部署方案总览 📊

Hindsight提供了8种不同的Docker Compose配置，每种都针对特定的使用场景：

配置方案	核心特点	适用场景
外部PostgreSQL	标准部署，使用pgvector扩展	通用场景
Timescale扩展	高性能向量搜索和文本搜索	大规模生产环境
AlloyDB Omni	Google AlloyDB + ScaNN算法	企业级向量搜索
S3文件存储	SeaweedFS S3兼容存储	文件密集型应用
自定义模型	离线模型嵌入	隐私敏感环境
Nginx反向代理	API路径代理	微服务架构
vchord向量搜索	TensorChord向量扩展	专业向量搜索需求
pg_textsearch	BM25文本搜索扩展	文本检索优化

基础配置：外部PostgreSQL部署 🐘

这是最常用的部署方案，使用PostgreSQL + pgvector扩展作为后端存储。配置位于 docker/docker-compose/external-pg/docker-compose.yaml：

# 核心服务配置
services:
  db:
    image: pgvector/pgvector:pg18
    environment:
      POSTGRES_PASSWORD: ${HINDSIGHT_DB_PASSWORD}
  
  hindsight:
    image: ghcr.io/vectorize-io/hindsight:latest
    ports:
      - "8888:8888"  # API端口
      - "9999:9999"  # 控制面板端口

启动命令：

export HINDSIGHT_DB_PASSWORD=your_password
export OPENAI_API_KEY=sk-xxx
cd docker/docker-compose
docker compose up -d

高性能方案：Timescale扩展部署 ⚡

对于需要处理大规模数据的企业应用，Timescale扩展提供了卓越的性能。配置位于 docker/docker-compose/timescale/docker-compose.yaml：

核心特性：

• pgvectorscale：基于DiskANN的磁盘向量搜索算法
• pg_textsearch：高性能BM25文本搜索
• 健康检查机制：确保服务稳定性
• 扩展初始化：自动安装所需扩展

优势：

• 支持数十亿级别的向量数据
• 磁盘优化，内存占用低
• 混合搜索（语义+关键词）性能卓越

企业级方案：Google AlloyDB Omni 🏢

Google AlloyDB Omni提供了企业级的向量搜索能力，特别适合需要高可用性和性能的生产环境。配置位于 docker/docker-compose/alloydb/docker-compose.yaml：

核心组件：

• AlloyDB Omni容器：Google的企业级PostgreSQL分支
• ScaNN算法：Google的高效向量相似性搜索
• 自动扩展安装：简化部署流程

配置亮点：

services:
  db:
    image: google/alloydbomni:17
    # 使用ScaNN扩展进行向量搜索

文件存储方案：S3兼容存储 📁

对于需要处理大量文件上传的应用，S3存储方案提供了更好的扩展性。配置位于 docker/docker-compose/s3-file-storage/docker-compose.yaml：

核心特性：

• SeaweedFS：轻量级S3兼容存储
• 文件元数据分离：PostgreSQL存储元数据，S3存储文件内容
• 成本优化：降低数据库存储压力

适用场景：

• 文档处理应用
• 多媒体文件存储
• 大规模文件上传需求

隐私保护方案：自定义模型部署 🔒

在隐私敏感的环境中，您可以使用自定义模型部署，避免依赖外部API。配置位于 docker/docker-compose/custom-models/docker-compose.yaml：

核心优势：

• 离线模型：嵌入本地模型，无需网络连接
• 隐私保护：数据不出本地环境
• 自定义嵌入：支持多种本地模型

配置示例：

services:
  hindsight:
    build:
      args:
        EMBEDDER: sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2
        RERANKER: cross-encoder/mmarco-mMiniLMv2-L12-H384-v1
    environment:
      HF_HUB_OFFLINE: "1"  # 强制离线模式

生产环境方案：Nginx反向代理 🌐

对于需要API网关和负载均衡的生产环境，Nginx配置提供了完整的解决方案。配置位于 docker/docker-compose/nginx/docker-compose.yml：

架构特点：

• API路径代理：将API挂载到 /hindsight 路径
• 控制面板直连：管理界面直接访问
• 健康检查：自动服务监控
• SSL支持：易于配置HTTPS

专业搜索方案：vchord向量搜索 🔍

TensorChord的vchord扩展提供了专业的向量搜索能力，特别适合需要高级搜索功能的场景。配置位于 docker/docker-compose/vchord/docker-compose.yaml：

技术特性：

• vchord扩展：优化的向量相似性搜索
• pg_tokenizer：高级文本分词
• llmlingua2：智能文本压缩
• vchord_bm25：混合搜索支持

部署选择指南 🧭

根据需求选择方案

需求场景	推荐配置	理由
个人项目/测试	外部PostgreSQL	简单易用，资源消耗低
企业生产环境	Timescale扩展	高性能，可扩展性强
大规模向量搜索	AlloyDB Omni	企业级向量搜索能力
文件密集型应用	S3存储方案	存储分离，成本优化
隐私敏感环境	自定义模型	数据不出本地
微服务架构	Nginx代理	API网关，易于集成
专业搜索需求	vchord扩展	高级搜索功能

环境变量配置要点

所有配置都支持以下关键环境变量：

# 必需配置
export OPENAI_API_KEY=sk-xxx
export HINDSIGHT_DB_PASSWORD=your_password

# 可选配置
export HINDSIGHT_API_LLM_PROVIDER=openai  # 或 anthropic、gemini等
export HINDSIGHT_VERSION=latest

性能优化建议 ⚡

1. 内存优化

• PostgreSQL调优：根据数据量调整shared_buffers
• 向量索引优化：合理设置HNSW参数
• 连接池配置：使用PgBouncer减少连接开销

2. 存储优化

• SSD存储：向量搜索对IOPS要求高
• 分区策略：按时间分区历史数据
• 备份策略：定期备份重要记忆数据

3. 搜索优化

• 混合搜索：同时使用向量和关键词搜索
• 缓存策略：热点数据内存缓存
• 查询优化：合理设置召回数量

监控与维护 🔧

健康检查

所有配置都包含健康检查机制，确保服务稳定性：

healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost:8888/hindsight/health"]
  interval: 10s
  timeout: 5s
  retries: 3

日志管理

• 结构化日志：JSON格式便于分析
• 日志轮转：防止日志文件过大
• 监控集成：支持Prometheus和Grafana

备份策略

1. 数据库备份：定期备份PostgreSQL数据
2. 配置文件备份：保存Docker Compose配置
3. 环境变量加密：使用secrets管理敏感信息

故障排除 🛠️

常见问题

Q: 服务启动失败

• 检查环境变量是否正确设置
• 确认端口是否被占用
• 查看容器日志：docker logs hindsight-app

Q: 向量搜索性能差

• 检查硬件资源（CPU、内存、磁盘IO）
• 调整向量索引参数
• 考虑升级到Timescale或AlloyDB

Q: 内存占用过高

• 调整PostgreSQL内存配置
• 启用查询缓存
• 优化向量索引大小

调试技巧

1. 查看服务状态：docker compose ps
2. 检查日志：docker compose logs -f
3. 进入容器：docker exec -it hindsight-app bash
4. 测试API：curl http://localhost:8888/health

总结 🎯

Hindsight的Docker Compose多服务部署方案为不同规模的应用提供了灵活的部署选择。从简单的个人项目到复杂的企业级系统，您都可以找到合适的配置方案。

核心优势：

• ✅ 开箱即用：预配置的Docker Compose文件
• ✅ 灵活扩展：支持多种数据库和存储后端
• ✅ 性能优化：针对不同场景的性能调优
• ✅ 易于维护：完整的监控和健康检查
• ✅ 社区支持：活跃的开源社区

无论您是AI开发者、系统管理员还是企业架构师，Hindsight的Docker Compose配置都能帮助您快速搭建稳定、高性能的AI代理记忆系统。

立即开始：克隆仓库并选择适合您的配置方案，让您的AI智能体拥有真正的长期记忆能力！

git clone https://gitcode.com/GitHub_Trending/hindsight2/hindsight
cd hindsight/docker/docker-compose
# 选择您的配置方案开始部署

配置文件路径参考：

• 外部PostgreSQL：docker/docker-compose/external-pg/docker-compose.yaml
• Timescale扩展：docker/docker-compose/timescale/docker-compose.yaml
• AlloyDB Omni：docker/docker-compose/alloydb/docker-compose.yaml
• S3文件存储：docker/docker-compose/s3-file-storage/docker-compose.yaml
• 自定义模型：docker/docker-compose/custom-models/docker-compose.yaml
• Nginx代理：docker/docker-compose/nginx/docker-compose.yml
• vchord搜索：docker/docker-compose/vchord/docker-compose.yaml

选择适合您需求的配置，开始构建智能的AI代理记忆系统吧！ 🚀

【免费下载链接】hindsight Hindsight: Agent Memory That Learns 项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight