repowisevectorize-io/hindsight

Architecture of vectorize-io/hindsight

vectorize-io/hindsight is 4,411 source files holding 45,337 symbols across 17 modules, written mainly in Python, TypeScript, Go. The largest module is hindsight-api-slim, with 1,097 files, and 151 files are entry points into the dependency graph.

How hindsight fits together

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.

Largest modules

  • hindsight-api-slim: 1,097 files and 309,815 lines of code
  • hindsight-integrations: 773 files and 107,638 lines of code
  • hindsight-clients: 545 files and 113,489 lines of code
  • hindsight-control-plane: 251 files and 44,320 lines of code
  • hindsight-docs: 140 files and 12,553 lines of code
  • hindsight-system-tests: 125 files and 12,039 lines of code
  • hindsight-dev: 57 files and 12,416 lines of code
  • hindsight-system-evals: 52 files and 9,888 lines of code

Languages

By file count: Python 2,029 files, TypeScript 728 files, Go 255 files, Shell 77 files, JavaScript 70 files, Rust 36 files.

Documentation

Repowise documents hindsight in 2,775 pages generated from the source, 50 of them written explanations of the repository and its modules. Module guides include:

  • hindsight-control-plane/src/app/api: API
  • hindsight-api-slim/hindsight_api/alembic: Admin CLI and Reembedding
  • hindsight-control-plane/src/app/api/banks: Bank Operations Routes
  • hindsight-docs/src/theme/BlogLayout: Blog Layout Framework
  • hindsight-cli/src/commands: CLI Commands Suite

More on hindsight: summary and FAQ, codebase overview, code health.

Related guide: Best dependency graph tools for monorepos