Skip to content

Environment Variables

On startup, Falcon loads env vars from the following files in order — earlier sources win: .env (cwd), ~/.hawkeye.env, ~/.neubird.env, ~/.falcon.env. All files are optional. Variables already set in the environment always take precedence.

VariableDescription
ANTHROPIC_API_KEYAnthropic API key. Required when LLM_PROVIDER is anthropic or when no Bedrock credentials are set.
VariableDefaultDescription
BEDROCK_API_KEYAWS Bedrock bearer token. Required when using Bedrock with token-based authentication.
BEDROCK_AWS_ACCESS_KEY_IDAWS access key ID. Required when using Bedrock with IAM credentials.
BEDROCK_AWS_REGIONus-west-2AWS region for Bedrock API calls.
BEDROCK_AWS_SECRET_ACCESS_KEYAWS secret access key. Required when using Bedrock with IAM credentials.
LLM_PROVIDERauto-detectLLM provider: anthropic or bedrock. Auto-detected from available credentials if not set.