Package Information
Documentation
n8n-nodes-hindsight
An n8n community node package for the Hindsight AI memory API by Vectorize.io.
Give your n8n workflows persistent AI memory -- store, search, and reflect on memories organized into banks.
Two nodes included:
- Hindsight -- 46 operations across 8 resources. Works as a regular node or as a tool for AI agents (
usableAsTool: true). - Hindsight Memory -- AI Agent memory sub-node. Plugs into the Agent's memory slot for persistent conversation history backed by Hindsight's semantic memory.
Installation
Community Nodes (recommended)
- Open your n8n instance
- Go to Settings > Community Nodes
- Select Install
- Enter
n8n-nodes-hindsight - Agree to the risks and install
Manual installation
cd ~/.n8n/nodes
npm install n8n-nodes-hindsight
Restart n8n after installation.
Credentials
- Go to Settings > Credentials > Add Credential
- Search for Hindsight API
- Configure:
- API Key -- Your Hindsight API key (leave empty for self-hosted without auth)
- Base URL -- Defaults to
http://localhost:8888. For Hindsight Cloud usehttps://api.hindsight.vectorize.io
- Click Test to verify, then Save
Resources and Operations
Bank
Manage memory banks -- top-level containers for all Hindsight data.
| Operation | Description |
|---|---|
| Clear Observations | Remove all observations from a bank |
| Consolidate | Trigger observation synthesis |
| Create or Update | Create or update a bank (upsert) |
| Delete | Delete a bank and all its data |
| Get Config | Get resolved bank configuration |
| Get Profile | Get bank profile and disposition |
| Get Stats | Get bank statistics |
| List | List all banks |
| List Tags | List tags with counts |
| Reset Config | Reset config to server defaults |
| Update Config | Update configuration overrides |
| Update Disposition | Set personality traits (skepticism, literalism, empathy) |
Memory
Store and retrieve memories.
| Operation | Description |
|---|---|
| Clear | Delete memories (optional type filter) |
| Clear Observations | Clear observations for a specific memory |
| Get | Get a specific memory by ID |
| List | List memories with optional filtering |
| Recall | Semantic search across memories |
| Reflect | AI-generated response grounded in memories |
| Retain | Store new content as a memory |
Directive
Rules that shape how Hindsight processes and reflects.
| Operation | Description |
|---|---|
| Create | Create a directive |
| Delete | Delete a directive |
| Get | Get a directive |
| List | List all directives in a bank |
| Update | Update a directive |
Mental Model
Persistent, auto-refreshing knowledge summaries.
| Operation | Description |
|---|---|
| Create | Create a mental model |
| Delete | Delete a mental model |
| Get | Get a mental model |
| Get History | Get revision history |
| List | List mental models in a bank |
| Refresh | Trigger a manual refresh |
| Update | Update a mental model |
Document
Manage source documents that group related memories.
| Operation | Description |
|---|---|
| Delete | Delete a document and its memories |
| Get | Get document details |
| List | List documents with search and tag filters |
| Update Tags | Update document tags |
Entity
Browse entities extracted from memories.
| Operation | Description |
|---|---|
| Get | Get entity details |
| List | List entities in a bank |
Operation
Track async jobs (retain, consolidation).
| Operation | Description |
|---|---|
| Cancel | Cancel a pending operation |
| Get | Get operation status |
| List | List operations in a bank |
| Retry | Retry a failed operation |
Webhook
Event-driven notifications from Hindsight.
| Operation | Description |
|---|---|
| Create | Register a webhook |
| Delete | Delete a webhook |
| List | List webhooks in a bank |
| List Deliveries | View delivery attempts |
| Update | Update a webhook |
Hindsight Memory (AI Agent)
The Hindsight Memory node plugs into n8n's AI Agent memory slot, giving your agents persistent semantic memory.
Setup
- Add an AI Agent node to your workflow
- Connect a Hindsight Memory node to the Agent's Memory input
- Configure: Bank ID, Session ID source, Context Window Length (default: 10)
How it works
- Each conversation turn is stored via the Retain API, tagged with the session ID
- Before each response, recent history is recalled using tag-scoped search
- Hindsight extracts entities, facts, and observations automatically -- building long-term semantic memory beyond the chat window
Chat Trigger --> AI Agent (with Hindsight Memory + LLM)
Test Workflow
A test workflow is included at examples/test-workflow.json. Import it into n8n to verify all operations work with your Hindsight instance.
The workflow tests: Bank Create --> List --> Get Profile --> Get Stats --> Memory Retain --> Recall --> Reflect --> Directive Create --> Bank Delete.