# Copy to .env and uncomment one provider block.
# SHANNON_AI_MODEL is <provider>:<model-id>, split on the first colon.
# Defaults to anthropic:claude-sonnet-4-6.

# --- Anthropic ---------------------------------------------------------------
SHANNON_AI_API_KEY=your-api-key-here
SHANNON_AI_MODEL=anthropic:claude-sonnet-4-6
# CLAUDE_CODE_OAUTH_TOKEN=your-oauth-token-here

# --- OpenAI ------------------------------------------------------------------
# SHANNON_AI_API_KEY=your-api-key-here
# SHANNON_AI_MODEL=openai:gpt-5.5

# --- xAI ---------------------------------------------------------------------
# SHANNON_AI_API_KEY=your-api-key-here
# SHANNON_AI_MODEL=xai:grok-4.5

# --- AWS Bedrock -------------------------------------------------------------
# Bearer token only; model must be enabled in your region.
# AWS_REGION=us-east-1
# AWS_BEARER_TOKEN_BEDROCK=your-bearer-token
# SHANNON_AI_MODEL=amazon-bedrock:us.anthropic.claude-opus-4-8

# --- Custom Base URL ---------------------------------------------------------
# Route through a proxy or gateway (LiteLLM, an internal endpoint).
# Pick the block matching the API dialect your gateway speaks, and uncomment all
# three lines. The provider prefix picks the dialect; the model id is whatever
# name your gateway serves it under.

# Anthropic compatible - Anthropic Messages:
# SHANNON_AI_API_KEY=your-gateway-key-here
# SHANNON_AI_BASE_URL=https://llm-gateway.example.com
# SHANNON_AI_MODEL=anthropic:claude-sonnet-4-6

# OpenAI compatible - Chat Completions (default) or Responses:
# SHANNON_AI_API_KEY=your-gateway-key-here
# SHANNON_AI_BASE_URL=https://llm-gateway.example.com/v1
# SHANNON_AI_MODEL=openai:gpt-5.5
# SHANNON_AI_OPENAI_FORMAT=responses

# --- Other provider ----------------------------------------------------------
# Any other provider the Pi harness supports. Name it in SHANNON_AI_MODEL and
# supply the key via the generic SHANNON_AI_API_KEY. Pi validates the provider
# and model at preflight.
# SHANNON_AI_MODEL=openrouter:moonshotai/kimi-k3
# SHANNON_AI_API_KEY=your-api-key-here

# --- Misc --------------------------------------------------------------------
# Forward /etc/hosts entries into the worker container.
# SHANNON_FORWARD_HOSTS=false

# See the guide below to use an OpenAI subscription
# https://github.com/KeygraphHQ/shannon/blob/main/docs/ai-providers.md#openai-codex-chatgpt-pluspro-subscription
# SHANNON_USE_PI_AUTH=1
# SHANNON_AI_MODEL=openai-codex:gpt-5.5
