coding-agents

行为说明

Hindsight 用 retain 保存信息，用 recall 搜索记忆，用 reflect 生成带有处置倾向的回答。每次调用都需要 bank_id，README 示例使用 my-bank。agent 可以按仓库或其他范围选择不同记忆银行。另有 LLM wrapper，可替换现有 LLM client，在 LLM 调用过程中自动保存和召回。

配置

Docker 示例使用以下设置：

设置	作用
OPENAI_API_KEY	示例中的 provider 凭据环境变量
HINDSIGHT_API_LLM_API_KEY	传给 API 容器的 LLM API key
HINDSIGHT_API_LLM_PROVIDER	选择 LLM provider

README 列出的 HINDSIGHT_API_LLM_PROVIDER 值包括 openai、anthropic、gemini、groq、ollama、lmstudio、minimax 和 atlas。

接口与存储

Docker 部署的 API 地址为 http://localhost:8888，UI 地址为 http://localhost:9999。推荐容器把命名 volume hindsight-data 挂载到 /home/hindsight/.pg0。外部 PostgreSQL 部署位于 docker/docker-compose；README 也列出 Oracle AI Database 的企业部署支持。

Python 客户端使用 hindsight_client 中的 Hindsight，Node.js 客户端使用 @vectorize-io/hindsight-client 中的 HindsightClient。嵌入式 Python 模式通过 HindsightServer 启动本地服务，再由 client 连接。

环境要求

嵌入式安装使用 hindsight-all。Intel（x86_64）Mac 需要改用 hindsight-all-slim。客户端示例使用 Python 包 hindsight-client 和 hindsight-all，或 npm 包 @vectorize-io/hindsight-client。