.env.example

# Environment Variables

Copy this file to `.env` and fill in your values.

## Required

```bash
# Database (PostgreSQL with PostGIS)
DATABASE_URL=postgresql://user:password@localhost:5432/vibemap
```

## Optional (Real-Time Data)

```bash
# OpenWeatherMap API (free tier: 1000 calls/day)
# Get key: https://home.openweathermap.org/api_keys
OPENWEATHER_API_KEY=your_openweather_api_key

# Reddit API (free: 60 requests/minute)
# Create app: https://www.reddit.com/prefs/apps
REDDIT_CLIENT_ID=your_reddit_client_id
REDDIT_CLIENT_SECRET=your_reddit_client_secret

# Google Places API (free tier available)
# Venue data uses OpenStreetMap (no key needed)
# GOOGLE_PLACES_API_KEY=  # not required

# Twitter/X API (paid: $100+/month for Basic)
# Only needed if you want X sentiment instead of Reddit
TWITTER_BEARER_TOKEN=your_twitter_bearer_token

# Enterprise API Key (for /v1/enterprise/* endpoints)
# Generate a strong random key for production
ENTERPRISE_API_KEY=your_enterprise_api_key_here
```

## Application Settings

```bash
# App configuration
APP_NAME=Vibemap
APP_VERSION=1.0.0
DEBUG=false

# Vibe calculation settings
VIBE_DECAY_HOURS=24.0
VIBE_RADIUS_METERS=500.0

# Genesis Anchor coordinates
GENESIS_LAT=25.7997
GENESIS_LON=-80.1986
GENESIS_NAME="Genesis Anchor - Wynwood"
```

## Notes

- All real-time data sources have free tiers
- If API keys are not provided, the system uses simulated data
- Reddit API is the recommended free alternative to X/Twitter
- Keep your `.env` file private (never commit to git)