---
title: Paydirt Model Updates
emoji: 🏒
colorFrom: red
colorTo: yellow
sdk: docker
app_port: 8501
pinned: false
---

# 🏒 Paydirt NHL Model Updates

A Streamlit application for generating NHL DFS lineup projections and updating model data in real-time.

## Features

- **NHL Lineup Generation**: Automated lineup optimization for DraftKings and FanDuel
- **Real-time Updates**: Integrates with Google Sheets for live data updates
- **Multiple Platforms**: Supports both DK and FD contests
- **Ownership Projections**: ML-powered ownership predictions using XGBoost, LightGBM, and KNN models
- **Discord Notifications**: Automatic notifications when updates complete
- **MongoDB Integration**: Stores historical data and projections

## Architecture

- **Python/Streamlit**: Web interface and data processing
- **Go**: High-performance lineup generation
- **MongoDB**: Data storage and retrieval
- **Google Sheets API**: Live data integration
- **Docker**: Containerized deployment

## Setup

### Local Development

1. **Install Dependencies**
```bash
pip install -r requirements.txt
```

2. **Configure Secrets**

Create `.streamlit/secrets.toml`:
```toml
MONGODB_URI = "your-mongodb-uri"
GOOGLE_PROJECT_ID_1 = "your-project-id"
# ... (see .streamlit/secrets.toml.example for full template)
```

3. **Build Go Programs** (if developing locally on Windows)
```bash
cd func/dk_nhl_go
go build -o NHL_seed_frames.exe NHL_seed_frames.go

cd ../fd_nhl_go
go build -o NHL_seed_frames.exe NHL_seed_frames.go
```

4. **Run the App**
```bash
streamlit run src/streamlit_app.py
```

### Hugging Face Deployment

This app is configured for deployment on Hugging Face Spaces using Docker.

1. **Create a Space** on Hugging Face with Docker SDK
2. **Add Secrets** in Space settings (Settings → Repository secrets)
   - Add all variables from `.streamlit/secrets.toml.example`
3. **Push Code** to your Space repository
4. The Docker build will automatically:
   - Build Go programs for Linux
   - Install Python dependencies
   - Configure the environment

## Project Structure

```
Paydirt_model_updates/
├── src/
│   └── streamlit_app.py      # Main Streamlit application
├── func/
│   ├── NHL_own_regress.py    # Ownership prediction models
│   ├── dk_nhl_go/            # DraftKings lineup generator (Go)
│   └── fd_nhl_go/            # FanDuel lineup generator (Go)
├── Dockerfile                # Docker configuration
├── requirements.txt          # Python dependencies
├── go.mod                    # Go module definition
└── README.md                 # This file
```

## Technologies Used

### Python Stack
- **Streamlit**: Web interface
- **pandas**: Data manipulation
- **numpy**: Numerical operations
- **xgboost/lightgbm/scikit-learn**: Machine learning models
- **pymongo**: MongoDB client
- **gspread**: Google Sheets API
- **ortools**: Linear optimization

### Go Stack
- **MongoDB Driver**: Database connectivity
- High-performance lineup generation algorithms

## Environment Variables

Required environment variables (can be set in `.streamlit/secrets.toml` or as environment variables):

| Variable | Description |
|----------|-------------|
| `MONGODB_URI` | MongoDB connection string |
| `GOOGLE_PROJECT_ID_1` | Google Cloud project ID (primary) |
| `GOOGLE_PRIVATE_KEY_1` | Service account private key (primary) |
| `GOOGLE_CLIENT_EMAIL_1` | Service account email (primary) |
| `GOOGLE_PROJECT_ID_2` | Google Cloud project ID (backup) |
| `GOOGLE_PRIVATE_KEY_2` | Service account private key (backup) |
| `GOOGLE_CLIENT_EMAIL_2` | Service account email (backup) |
| `DISCORD_WEBHOOK_URL` | Discord webhook for notifications |
| `MASTER_SHEET_URL` | Google Sheets URL for master data |

## Usage

1. Open the app in your browser
2. Check connection status in the sidebar
3. Click "🚀 Generate NHL Lineups" to start the process
4. Monitor progress as the app:
   - Builds prop betting tables
   - Generates player-level outcomes
   - Creates stack matrices
   - Runs lineup optimization
   - Updates MongoDB with results
   - Sends Discord notifications

## Security Notes

- Never commit `.streamlit/secrets.toml` to version control
- Use Hugging Face Secrets for production deployment
- Rotate service account keys regularly
- Keep MongoDB credentials secure

## License

Proprietary - Paydirt Sports

## Support

For issues or questions, contact the development team.