Hindsight

Active
GitHub Python MIT

Description

Hindsight is an agent memory system that learns autonomously, supporting memory retention, recall, and reflection to give AI agents persistent experiential memory.

Key Features

  • Agent memory system focused on learning rather than just remembering, with retain/recall/reflect operations
  • State-of-the-art performance on LongMemEval benchmark, independently reproduced by Virginia Tech and Washington Post
  • LLM Wrapper for 2-line integration swapping your current LLM client with Hindsight memory-enabled client
  • Multi-provider support including OpenAI, Anthropic, Gemini, Groq, Ollama, LM Studio, and MiniMax
  • Embedded Python mode running without a server for lightweight integration
  • Per-user memory isolation with custom metadata for personalized conversational AI agents

Use Cases

💡 Personalizing AI chatbots with per-user memory that persists across sessions
💡 Building AI employees that learn from feedback and handle open-ended tasks autonomously
💡 Adding long-term experiential memory to coding agents for improved context retention
💡 Enterprise conversational AI requiring accurate recall of past interactions and preferences
💡 Autonomous agents that change behavior based on accumulated experience over time

Quick Start

Run `docker run -it --pull always --name hindsight --restart unless-stopped -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`, then install the client with `pip install hindsight-client` and use `client.retain()`, `client.recall()`, and `client.reflect()` to manage memories.

Related Projects