How yogeswar142/hindsight works
Hindsight is an agent-memory system: clients and agents submit information to retain, search it with recall, or generate responses with reflect. The API server exposes these operations, while the engine handles memory processing, search, and persistence. The README also documents memory banks, mental models, knowledge pages, MCP, and multiple client and deployment options; these appear as product branches, though their internal wiring is not established by the sampled excerpts. The graph uses documented workflows and repository structure; some subsystem links are therefore intentionally omitted.
Main entry points: main.py API server · memory_engine.py Memory engine · orchestrator.py Retain processing · retrieval.py Recall search
Components 22
Access and serving
- Client SDKs
hindsight-clients/go/client.go - Command-line client
hindsight-cli/src/main.rs - CrewAI storage
hindsight-integrations/crewai/hindsight_crewai/storage.py - API server
hindsight-api-slim/hindsight_api/main.py - HTTP and MCP APIs
hindsight-api-slim/hindsight_api/api/http.py - MCP tools
hindsight-api-slim/hindsight_api/mcp_tools.py
Memory operations
- Memory engine
hindsight-api-slim/hindsight_api/engine/memory_engine.py - Retain processing
hindsight-api-slim/hindsight_api/engine/retain/orchestrator.py - Recall search
hindsight-api-slim/hindsight_api/engine/search/retrieval.py - Reflect responses
hindsight-api-slim/hindsight_api/engine/reflect/agent.py - Memory consolidation
hindsight-api-slim/hindsight_api/engine/consolidation/consolidator.py
Knowledge features
- Memory banks
hindsight-api-slim/hindsight_api/engine/bank_aliases.py - Mental models
hindsight-api-slim/hindsight_api/engine/mental_model_refresh.py - Knowledge pages
hindsight-api-slim/hindsight_api - Import and export
hindsight-api-slim/hindsight_api/engine/transfer/importer.py
Storage and integrations
- Memory database
hindsight-api-slim/hindsight_api/engine/db/postgresql.py - LLM providers
hindsight-api-slim/hindsight_api/engine/providers - Webhook delivery
hindsight-api-slim/hindsight_api/webhooks/manager.py - Embedded daemon
hindsight-embed/hindsight_embed/daemon_embed_manager.py
Other components
- Agent or user
- LLM service
- Webhook receiver
Connections 25
- Agent or user → Client SDKs: uses
- Agent or user → Command-line client: uses
- Agent or user → CrewAI storage: integrates
- Client SDKs → API server: HTTP requests
- Command-line client → API server: API requests
- CrewAI storage → API server: retain and recall
- API server → HTTP and MCP APIs: creates API
- HTTP and MCP APIs → Memory engine: memory operations
- MCP tools → Memory engine: agent tools
- Memory engine → Retain processing: retains content
- Memory engine → Recall search: searches memories
- Memory engine → Reflect responses: generates responses
- Retain processing → Memory consolidation: consolidates memories
- Retain processing → Memory database: stores memory data
- Recall search → Memory database: queries memory data
- Reflect responses → Recall search: retrieves context
- Memory engine → LLM providers: requests model work
- LLM providers → LLM service: calls model
- API server → Memory banks: supports bank operations
- API server → Mental models: supports refresh
- API server → Knowledge pages: supports knowledge pages
- API server → Import and export: supports transfers
- Webhook delivery → Memory database: loads dispatch config
- Webhook delivery → Webhook receiver: delivers events
- Embedded daemon → API server: starts daemon