fleet-memory/hindsight-docs/docs/developer/api/quickstart.md

sidebar_position
1

Quick Start

Get up and running with Hindsight in 60 seconds.

import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem';

:::tip Prerequisites Make sure you've installed Hindsight and configured your LLM provider. :::

Basic Usage

With All-in-One Package

import os
from hindsight import HindsightServer, HindsightClient

# Start embedded server (PostgreSQL + HTTP API)
with HindsightServer(
    llm_provider="openai",
    llm_model="gpt-4o-mini",
    llm_api_key=os.environ["OPENAI_API_KEY"]
) as server:
    client = HindsightClient(base_url=server.url)

    # Retain: Store information
    client.retain(bank_id="my-bank", content="Alice works at Google as a software engineer")
    client.retain(bank_id="my-bank", content="Bob prefers Python over JavaScript")

    # Recall: Search memories
    results = client.recall(bank_id="my-bank", query="What does Alice do?")
    for r in results:
        print(r["text"])

    # Reflect: Generate personality-aware response
    response = client.reflect(bank_id="my-bank", query="Tell me about Alice")
    print(response["text"])

With Client Only

from hindsight_client import Hindsight

client = Hindsight(base_url="http://localhost:8888")

# Retain: Store information
client.retain(bank_id="my-bank", content="Alice works at Google as a software engineer")

# Recall: Search memories
results = client.recall(bank_id="my-bank", query="What does Alice do?")

# Reflect: Generate response
response = client.reflect(bank_id="my-bank", query="Tell me about Alice")
print(response["text"])

const { HindsightClient } = require('@hindsight/client');

const client = new HindsightClient({ baseUrl: 'http://localhost:8888' });

// Retain: Store information
await client.retain({
    bankId: 'my-bank',
    content: 'Alice works at Google as a software engineer'
});

// Recall: Search memories
const results = await client.recall({
    bankId: 'my-bank',
    query: 'What does Alice do?'
});

// Reflect: Generate response
const response = await client.reflect({
    bankId: 'my-bank',
    query: 'Tell me about Alice'
});
console.log(response.text);

# Retain: Store information
hindsight retain my-bank "Alice works at Google as a software engineer"

# Recall: Search memories
hindsight recall my-bank "What does Alice do?"

# Reflect: Generate response
hindsight reflect my-bank "Tell me about Alice"

What's Happening

Retain → Content is processed, facts are extracted, entities are identified and linked in a knowledge graph

Recall → Four search strategies (semantic, keyword, graph, temporal) run in parallel to find relevant memories

Reflect → Retrieved memories are used to generate a personality-aware response with formed opinions

Next Steps

• Retain — Advanced options for storing memories
• Recall — Search and retrieval strategies
• Reflect — Personality-aware reasoning
• Memory Banks — Configure personality and background
• Server Options — Production deployment