Skip to content

Configure Provider Keys

ThreadLens reads open-core runtime settings from open-core/.env. The Docker commands create that file from open-core/.env.example when it is missing.

Run from open-core/ if you want to create the file before Docker does:

Terminal window
cp .env.example .env
VariableRequiredPurpose
ANTHROPIC_API_KEYRequired for Anthropic-backed AI workflowsPowers Claude-based analysis and scoring paths.
GEMINI_API_KEYRequired when using Gemini as the AI providerProvides the Gemini fallback/provider path.
PARALLEL_API_KEYRequired for Google scouting when using Parallel.ai SearchEnables the Google search provider path.
BLUESKY_HANDLERequired for Bluesky scoutingIdentifies the Bluesky account used for API access.
BLUESKY_APP_PASSWORDRequired for Bluesky scoutingAuthenticates the Bluesky account.
SCOUT_ENV_FILEOptionalLets embedding repositories point Docker commands at a different env file.
SCOUT_DB_PATHOptionalOverrides the SQLite database path used by the Go API.
SCOUT_FRONTEND_DISTOptionalPoints the Go API at a built web app directory for static serving.
SCOUT_INIT_DEMOOptionalSeeds demo data when set to 1.
THREADLENS_RUNTIME_MODEOptionalSelects self_hosted or hosted; self-hosted is the default.

Use obviously fake values in examples, screenshots, and bug reports:

ANTHROPIC_API_KEY=sk-ant-example-not-real
GEMINI_API_KEY=gemini-example-not-real
PARALLEL_API_KEY=parallel-example-not-real
BLUESKY_HANDLE=example.bsky.social
BLUESKY_APP_PASSWORD=example-app-password-not-real

Do not commit real provider keys, private URLs, hosted credentials, billing tokens, or customer data.