UrbanWorldModel/.env.example at main · AdnanSattar/UrbanWorldModel · 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
# UrbanSim WM - Environment Configuration
# Copy this file to .env and fill in your actual values

# ========================================
# Backend Configuration
# ========================================
API_HOST=0.0.0.0
API_PORT=8000
ENVIRONMENT=development

# Model Configuration
MODEL_CHECKPOINT_PATH=./checkpoints/model_final.json
WARM_MODEL_ON_STARTUP=true

# ========================================
# ETL Bootstrap
# ========================================
# Run lightweight ETL on API startup (checks and fills missing files)
RUN_ETL_ON_STARTUP=false
# Comma-separated list of cities to bootstrap
ETL_CITIES=Lahore,Karachi,Islamabad,Peshawar,Quetta
# Hours of history to fetch from OpenAQ during bootstrap (reduced for faster runs)
ETL_OPENAQ_HOURS=6
# Max sensors per city to query (0 = no limit; reduces API calls)
ETL_OPENAQ_MAX_SENSORS=50
# Delay between sensor API requests (seconds) to avoid rate limiting
ETL_REQUEST_DELAY_SECS=0.5
ETL_REQUEST_TIMEOUT_SECS=10
ETL_STARTUP_TIMEOUT_SECS=10
LOGS_DIR=/logs
PROCESSED_DATA_DIR=/etl/processed_data

# ========================================
# External API Keys
# ========================================

# WAQI (World Air Quality Index) API Token - RECOMMENDED
# Free token available at: https://aqicn.org/api/
# This is the primary data source for air quality data
WAQI_API_TOKEN=

# OpenAQ API Key (optional, fallback if WAQI not configured)
# Get your key at: https://openaq.org/
OPENAQ_API_KEY=

# Mobility Data API Key (placeholder for future integration)
MOBILITY_API_KEY=

# Energy Data API Key (placeholder for future integration)
ENERGY_API_KEY=

# ========================================
# Frontend Configuration
# ========================================
NEXT_PUBLIC_API_URL=http://localhost:8000
NEXT_TELEMETRY_DISABLED=1

# ========================================
# Redis Configuration (for future use with Celery)
# ========================================
REDIS_HOST=redis
REDIS_PORT=6379

# ========================================
# Training Configuration
# ========================================
WANDB_API_KEY=
WANDB_PROJECT=urbansim-wm

# ========================================
# Database (for future use)
# ========================================
# DATABASE_URL=postgresql://user:password@localhost:5432/urbansim
# POSTGRES_USER=urbansim
# POSTGRES_PASSWORD=changeme
# POSTGRES_DB=urbansim_db