Configuration

Complete reference for configuring Hindsight server through environment variables and configuration files.

Environment Variables

Hindsight is configured entirely through environment variables, making it easy to deploy across different environments and container orchestration platforms.

LLM Provider Configuration

Configure the LLM provider used for fact extraction, entity resolution, and reasoning operations.

Common LLM Settings

Variable	Description	Default	Required
`HINDSIGHT_API_LLM_PROVIDER`	LLM provider: `groq`, `openai`, `ollama`	`groq`	Yes
`HINDSIGHT_API_LLM_API_KEY`	API key for LLM provider	-	Yes (except ollama)
`HINDSIGHT_API_LLM_MODEL`	Model name	Provider-specific	No
`HINDSIGHT_API_LLM_BASE_URL`	Custom LLM endpoint	Provider default	No

Provider-Specific Examples

Groq (Recommended for Fast Inference)

export HINDSIGHT_API_LLM_PROVIDER=groq
export HINDSIGHT_API_LLM_API_KEY=gsk_xxxxxxxxxxxx
export HINDSIGHT_API_LLM_MODEL=openai/gpt-oss-20b

OpenAI

export HINDSIGHT_API_LLM_PROVIDER=openai
export HINDSIGHT_API_LLM_API_KEY=sk-xxxxxxxxxxxx
export HINDSIGHT_API_LLM_MODEL=gpt-4o

Ollama (Local, No API Key)

export HINDSIGHT_API_LLM_PROVIDER=ollama
export HINDSIGHT_API_LLM_BASE_URL=http://localhost:11434/v1
export HINDSIGHT_API_LLM_MODEL=llama3.1

OpenAI-Compatible Endpoints

export HINDSIGHT_API_LLM_PROVIDER=openai
export HINDSIGHT_API_LLM_BASE_URL=https://your-endpoint.com/v1
export HINDSIGHT_API_LLM_API_KEY=your-api-key
export HINDSIGHT_API_LLM_MODEL=your-model-name

Database Configuration

Configure the PostgreSQL database connection and behavior.

Variable	Description	Default	Required
`HINDSIGHT_API_DATABASE_URL`	PostgreSQL connection string	-	Yes*

*Note: If DATABASE_URL is not provided, the server will use embedded pg0 (embedded PostGRE).

MCP Server Configuration

Configure the Model Context Protocol (MCP) server for AI assistant integrations.

Variable	Description	Default	Required
`HINDSIGHT_API_MCP_ENABLED`	Enable MCP server	`true`	No

# Enable MCP server (default)
export HINDSIGHT_API_MCP_ENABLED=true

# Disable MCP server
export HINDSIGHT_API_MCP_ENABLED=false

Configuration Files

.env File

The Hindisight API will look for a .env file:

# .env

HINDSIGHT_API_DATABASE_URL=postgresql://hindsight:hindsight_dev@localhost:5432/hindsight

HINDSIGHT_API_LLM_PROVIDER=groq
HINDSIGHT_API_LLM_API_KEY=gsk_xxxxxxxxxxxx

For configuration issues not covered here, please open an issue on GitHub.

2.8 KiB Raw Blame History