# vectorize-io/hindsight

> Hindsight is an agent memory system for building AI agents that learn over time, not only recall conversation history. Agents store information with retain, search it with recall, and generate disposition-aware responses with reflect. The core is written in Python, with client libraries and tooling in TypeScript, Go and Rust.

Source: https://github.com/vectorize-io/hindsight
Indexed: commit 0bd5501 on 2026-11-09 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: MCP server
- Language: Python
- Stars: 61,199 at index time
- License: MIT
- Code health: 7.8/10, Good
- Last commit: 2026-11-07
- Contributors: 4

## Install

From the README: https://github.com/vectorize-io/hindsight#quick-start

Install the API server from PyPI.
    pip install hindsight-api

Set the API key for the LLM provider the server will use.
    export HINDSIGHT_API_LLM_API_KEY=sk-xxx

## How it works

Requests enter through the API server, which is started by hindsight-api-slim/hindsight_api/main.py and exposes HTTP routes defined in hindsight-api-slim/hindsight_api/api/http.py. The memory logic sits in hindsight-api-slim/hindsight_api/engine/memory_engine.py, which is one of the most frequently changed files in the code index. The hindsight-clients directory holds the client libraries that let an application store, search and reflect on memories in a running server without writing HTTP calls by hand. The hindsight-cli module provides the hindsight command-line tool, with each subcommand calling the server through one shared API client. The hindsight-embed module runs a local memory server as a background daemon so the hindsight-embed command can work without manual server setup.

- hindsight-all-npm/src/index.ts: entry point
- hindsight-all-npm/src/server.ts: entry point
- hindsight-all/hindsight/server.py: entry point
- hindsight-api-slim/hindsight_api/admin/cli.py: entry point
- hindsight-api-slim/hindsight_api/main.py: entry point
Modules: hindsight-api-slim, hindsight-integrations, hindsight-clients, hindsight-control-plane, hindsight-docs, hindsight-system-tests, hindsight-dev, hindsight-system-evals. 4,411 files, 654,934 lines, 45,337 symbols.

## Code health

- Score: 7.8/10 (Good)
- Trend: 7.5 on 2026-11-05, 7.8 on 2026-11-09
- Rank: #84 of 4,000+ indexed repos
- Hotspots: hindsight-api-slim/hindsight_api/engine/memory_engine.py, hindsight-api-slim/hindsight_api/config.py, hindsight-api-slim/hindsight_api/engine/consolidation/consolidator.py, hindsight-api-slim/hindsight_api/api/http.py, hindsight-api-slim/hindsight_api/engine/cross_encoder.py
- Lowest file: hindsight-api-slim/hindsight_api/engine/reflect/agent.py
- Dead code: 47 findings

## Maintenance

- Last commit 2026-11-07, 500 commits
- 4 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/vectorize-io/hindsight/security

## More

- Page: https://repowise.dev/repo/vectorize-io/hindsight
- Ask this codebase: https://repowise.dev/repo/vectorize-io/hindsight/chat
- Docs: https://repowise.dev/repo/vectorize-io/hindsight/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/vectorize-io/hindsight
