# =============================================================================
# AI-Trader-Server Environment Configuration
# =============================================================================
# Copy this file to .env and fill in your actual values
# Docker Compose automatically reads .env from project root

# AI Model API Configuration
# OPENAI_API_BASE: Leave empty to use default OpenAI endpoint, or set to custom proxy URL
OPENAI_API_BASE=
OPENAI_API_KEY=your_openai_key_here # https://platform.openai.com/api-keys

# Data Source Configuration
ALPHAADVANTAGE_API_KEY=your_alphavantage_key_here  # https://www.alphavantage.co/support/#api-key
JINA_API_KEY=your_jina_key_here # https://jina.ai/

# API Server Port (exposed on host machine for REST API)
# Container ALWAYS uses port 8080 internally (hardcoded in entrypoint.sh)
# This variable ONLY controls the host port mapping (host:API_PORT -> container:8080)
# Change this if port 8080 is already in use on your host machine
# Example: API_PORT=8889 if port 8080 is occupied by another service
# Used for Windmill integration and external API access
API_PORT=8080

# Agent Configuration
AGENT_MAX_STEP=30

# Simulation Configuration
# Maximum number of days allowed in a single simulation range
# Prevents accidentally requesting very large date ranges
MAX_SIMULATION_DAYS=30

# Price Data Configuration
# Automatically download missing price data from Alpha Vantage when needed
# If disabled, all price data must be pre-populated in the database
AUTO_DOWNLOAD_PRICE_DATA=true

# Data Volume Configuration
# Base directory for all persistent data (will contain data/ and configs/ subdirectories)
# Use relative paths (./volumes) or absolute paths (/home/user/ai-trader-volumes)
# Defaults to current directory (.) if not set
VOLUME_PATH=.

# =============================================================================
# Deployment Mode Configuration
# =============================================================================
# DEPLOYMENT_MODE controls AI model calls and data isolation
# - PROD: Real AI API calls, uses data/agent_data/ and data/trading.db
# - DEV: Mock AI responses, uses data/dev_agent_data/ and data/trading_dev.db
DEPLOYMENT_MODE=PROD

# Preserve dev data between runs (DEV mode only)
# Set to true to keep dev database and files for debugging
PRESERVE_DEV_DATA=false