nfl-predict/.env.example at master · jackc625/nfl-predict · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
# NFL Prediction System Environment Variables
# Copy this file to .env and fill in your actual values
# NEVER commit .env to version control!

# =============================================================================
# EXTERNAL API KEYS
# =============================================================================

# The Odds API (https://the-odds-api.com/)
# Required for live odds data ingestion
ODDS_API_KEY=your_odds_api_key_here

# Alternative odds data source (if using different provider)
# ODDS_API_BASE_URL=https://api.alternative-odds-provider.com/v1

# =============================================================================
# DATABASE & STORAGE
# =============================================================================

# DuckDB database file path (optional, defaults to in-memory)
# DUCKDB_PATH=./data/nfl_predictions.duckdb

# Data storage root (optional, overrides config.yaml)
# DATA_ROOT_PATH=./data

# =============================================================================
# SECURITY & API
# =============================================================================

# Secret key for API security (generate with: openssl rand -hex 32)
SECRET_KEY=your_secret_key_here_minimum_32_characters_long

# API host and port (optional, overrides config.yaml)
# API_HOST=0.0.0.0
# API_PORT=8000

# CORS allowed origins (comma-separated, optional)
# CORS_ORIGINS=http://localhost:3000,https://yourdomain.com

# =============================================================================
# EXTERNAL SERVICES
# =============================================================================

# Email notifications (optional)
# SMTP_SERVER=smtp.gmail.com
# SMTP_PORT=587
# SMTP_USERNAME=your_email@gmail.com
# SMTP_PASSWORD=your_app_password
# NOTIFICATION_EMAIL=alerts@yourdomain.com

# Slack notifications (optional)
# SLACK_WEBHOOK_URL=https://hooks.slack.com/services/YOUR/SLACK/WEBHOOK

# =============================================================================
# CACHING & PERFORMANCE
# =============================================================================

# Redis cache (optional)
# REDIS_URL=redis://localhost:6379/0
# REDIS_PASSWORD=your_redis_password

# =============================================================================
# MONITORING & LOGGING
# =============================================================================

# Log level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
LOG_LEVEL=INFO

# Structured logging format (json or text)
LOG_FORMAT=json

# External monitoring service (optional)
# SENTRY_DSN=https://your_sentry_dsn_here
# DATADOG_API_KEY=your_datadog_api_key

# =============================================================================
# DEVELOPMENT SETTINGS
# =============================================================================

# Environment mode
ENVIRONMENT=development

# Debug mode (true/false)
DEBUG=false

# Mock external APIs for testing (true/false)
MOCK_EXTERNAL_APIS=false

# =============================================================================
# TIMEZONE & LOCALE
# =============================================================================

# Default timezone for data processing
TIMEZONE=America/New_York

# Locale for number formatting
LOCALE=en_US

# =============================================================================
# BACKUP & STORAGE
# =============================================================================

# Cloud storage for backups (optional)
# AWS_ACCESS_KEY_ID=your_aws_access_key
# AWS_SECRET_ACCESS_KEY=your_aws_secret_key
# AWS_REGION=us-east-1
# AWS_S3_BUCKET=nfl-predictions-backup

# Google Cloud Storage (alternative)
# GOOGLE_CLOUD_PROJECT=your_project_id
# GOOGLE_CLOUD_BUCKET=nfl-predictions-backup

# =============================================================================
# FEATURE FLAGS
# =============================================================================

# Enable/disable specific features
ENABLE_LIVE_ODDS=true
ENABLE_WEATHER_DATA=true
ENABLE_BETTING_RECOMMENDATIONS=true
ENABLE_EMAIL_REPORTS=false
ENABLE_SLACK_NOTIFICATIONS=false

# =============================================================================
# RATE LIMITING
# =============================================================================

# Override default rate limits
# API_RATE_LIMIT_PER_MINUTE=60
# API_RATE_LIMIT_PER_HOUR=1000

# External API rate limits
# ODDS_API_CALLS_PER_HOUR=500
# WEATHER_API_CALLS_PER_DAY=1000

# =============================================================================
# TESTING & VALIDATION
# =============================================================================

# Test data settings
# TEST_DATA_SEASONS=2022,2023,2024
# VALIDATION_SPLIT=0.2

# =============================================================================
# EXAMPLE VALUES (for development)
# =============================================================================
# Uncomment and modify these for local development:

# ODDS_API_KEY=demo_api_key_for_testing
# SECRET_KEY=development_secret_key_not_for_production_use_only_32chars
# LOG_LEVEL=DEBUG
# DEBUG=true
# MOCK_EXTERNAL_APIS=true