fleet-memory/hindsight-docs/docs/developer/api/installation.md
Nicolò Boschi 3e72984cd2 chunks
2025-11-29 16:34:13 +01:00

2.3 KiB

sidebar_position
0

Installation

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

Choose Your Setup

The hindsight-all package includes everything: embedded PostgreSQL, HTTP API server, and Python client.

pip install hindsight-all

Use when: You want the simplest setup for development or small deployments.

Client Only

If you already have a Hindsight server running:

pip install hindsight-client

Use when: You're connecting to an existing Hindsight server (development, staging, or production).

npm install @hindsight/client

Requires: A running Hindsight server (see Server Deployment for setup).

# Coming soon

The CLI is included with the Rust distribution. See CLI documentation for installation.

LLM Provider Setup

Hindsight requires an LLM that supports structured output for fact extraction and reasoning. Configure your provider:

export OPENAI_API_KEY=sk-...

Requirement: Model must support structured output (JSON mode)

export GROQ_API_KEY=gsk_...

Requirement: Model must support structured output (JSON mode)

# No API key needed - runs locally

Requirement: Model must support structured output (JSON mode)

See Ollama documentation for setup.

Verify Installation

import hindsight
print(hindsight.__version__)
const { HindsightClient } = require('@hindsight/client');
console.log('Hindsight client loaded');
hindsight --version

Next Steps