← all repositories
vectorize-io/hindsight

Memory banks for agents that outgrew chat history

Hindsight is an agent memory system that tries to make AI agents learn from experience rather than just retrieving conversation logs.

18.7k stars Python AgentsRAG · Search
hindsight
Velocity · 7d
+37
★ / day
Trend
cooling
star history

What it does

Hindsight is a memory layer for AI agents that stores information in categorized banks—world facts, personal experiences, and synthesized mental models—then retrieves it through a mix of semantic search, keyword matching, graph traversal, and temporal filtering. It exposes three operations (retain, recall, and reflect) that agents use to ingest memories, fetch relevant context, or generate new insights by connecting existing dots. The system can run as a Dockerized service with a UI, embed directly into a Python process, or wrap an existing LLM client with minimal code changes.

The interesting bit

Instead of dumping everything into a vector database and hoping similarity search suffices, Hindsight uses an LLM to normalize incoming memories into canonical entities, relationships, and time series during ingestion. Recall merges four parallel retrieval strategies and reranks the results, while reflect actively synthesizes new observations—meaning the agent is meant to learn, not just remember.

Key highlights

  • Claims state-of-the-art scores on the LongMemEval benchmark; the README says results were independently reproduced by Virginia Tech and The Washington Post.
  • Organizes memory into three biomimetic pathways: world facts, experiences, and mental models.
  • Recall runs semantic, keyword (BM25), graph, and temporal searches in parallel, then fuses and reranks them.
  • Supports multiple LLM backends including OpenAI, Anthropic, Gemini, Ollama, and LM Studio.
  • Offers both serverless embedded mode and Docker deployment with PostgreSQL or Oracle AI Database storage.

Caveats

  • The README itself notes that simple workflow tools like n8n may find Hindsight over-engineered for their needs.

Verdict

Worth evaluating if you are building long-running autonomous agents or personalized AI employees that need to accumulate institutional knowledge. Skip it if you just need per-session chat history or simple RAG for a static document set.

Frequently asked

What is vectorize-io/hindsight?
Hindsight is an agent memory system that tries to make AI agents learn from experience rather than just retrieving conversation logs.
Is hindsight open source?
Yes — vectorize-io/hindsight is open source, released under the MIT license.
What language is hindsight written in?
vectorize-io/hindsight is primarily written in Python.
How popular is hindsight?
vectorize-io/hindsight has 18.7k stars on GitHub and is currently cooling off.
Where can I find hindsight?
vectorize-io/hindsight is on GitHub at https://github.com/vectorize-io/hindsight.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.