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.
Required
| Variable |
Description |
ANTHROPIC_API_KEY |
Anthropic API key. Required when LLM_PROVIDER is anthropic or when no Bedrock credentials are set. |
Optional
| Variable |
Default |
Description |
BEDROCK_API_KEY |
— |
AWS Bedrock bearer token. Required when using Bedrock with token-based authentication. |
BEDROCK_AWS_ACCESS_KEY_ID |
— |
AWS access key ID. Required when using Bedrock with IAM credentials. |
BEDROCK_AWS_REGION |
us-west-2 |
AWS region for Bedrock API calls. |
BEDROCK_AWS_SECRET_ACCESS_KEY |
— |
AWS secret access key. Required when using Bedrock with IAM credentials. |
LLM_PROVIDER |
auto-detect |
LLM provider: anthropic or bedrock. Auto-detected from available credentials if not set. |