Skip to main content
HQ uses foundation services to power different capabilities. Configure them in the Provider Configuration panel on the home screen.

Foundation Services

Language Models

Chat, classification, structured extraction. The core AI capability.

Embeddings

Vector search, similarity matching, semantic discovery within infospaces.

Web Search

Live web results for chat - ground responses in current information.

Geocoding

Extract and map locations from your documents. Powers geographic visualizations.
App Setup Each service type supports multiple providers. Pick what fits your needs — cloud APIs, local inference, or a mix.

API Key Storage

Two storage modes for each provider:
ModeWhat it doesUse when
Runtime OnlyKeys stay in your browserQuick testing, interactive use
Save for TasksKeys encrypted in databaseBackground jobs, large analysis runs, automation
Background tasks require saved keys. The Celery worker that processes large analysis runs can’t access your browser. If jobs hang or fail, check that you’ve saved keys to the backend.

Providers

Language Models

ProviderGet Key
Anthropicconsole.anthropic.com
OpenAIplatform.openai.com
Googleaistudio.google.com
OllamaLocal — no key needed

Ollama

Ollama is a local language model server that has many models available and is a great way to get started with local inference.
1

Select Ollama as LLM and Embedding Provider

Ollama
2

Select a model

Ollama

Embeddings

Used for vectorizing content in your infospaces. Configure separately from language models.
ProviderNotes
OpenAIReliable, widely used
OllamaLocal embeddings, complete privacy
Enables the chat to pull in live search results.
ProviderGet Key
Tavilytavily.com
SearXNG(soon back integrated in the stack)

Geocoding

Location extraction uses Nominatim. Self-hosted deployments include it by default. No API key needed for local Nominatim.

Verifying Setup

  1. Open Chat and send a message — confirms language model works
  2. Upload an asset and check if it appears in vector search — confirms embeddings
  3. Ask chat to search the web — confirms web search
  4. Run an analysis with location fields — confirms geocoding

Next Steps