How carlmedinav/nba-ml works
NBA Totals ML is a basketball forecasting product with a reproducible data-to-model pipeline and user-facing dashboards. Its main workflow builds pre-game features from game data, trains models, and serves total, margin and player-prop projections; the web app also offers injury context and a Bet Builder. The graph includes documented capabilities whose implementation was not sampled. Some links are supported only by README descriptions, so uncertain internal wiring is omitted.
Main entry points: app.py FastAPI application · cli.py Command-line interface · app.js Web interface · build_dataset.py Game feature dataset
Components 26
Data and Features
- Project configuration
src/nba_ml/config.py - Game data download
src/nba_ml/data/download.py - Schedule data
src/nba_ml/data/schedule.py - ESPN data adapters
src/nba_ml/data/espn.py - Player data
src/nba_ml/data/players.py - Player game logs
src/nba_ml/data/player_logs.py - Game feature dataset
src/nba_ml/data/build_dataset.py - Exploratory analysis
src/nba_ml/eda.py
Modeling
- Game model training
src/nba_ml/models/train.py - Model results
src/nba_ml/models/results.py - Game predictions
src/nba_ml/models/predict.py - Player props model
src/nba_ml/models/player_props.py - Model and data artifacts
artifacts
Prediction and API
- Command-line interface
src/nba_ml/cli.py - FastAPI application
app.py - Streamlit dashboards
src/nba_ml/dashboard.py - Pro dashboard
src/nba_ml/dashboard_pro.py - Betting probabilities
src/nba_ml/betting/probability.py
Web Experience
- Web interface
public/app.js - Injuries view
public/injuries.js - Bet Builder
public/bet-builder.js - Advanced analytics
public/advanced-analytics.js
Other components
- NBA user
- NBA stats API
- ESPN data
- Web visitor
Connections 32
- NBA stats API → Game data download: provides game logs
README.md - NBA stats API → Schedule data: provides schedules
src/nba_ml/data/schedule.py - ESPN data → ESPN data adapters: provides updates
src/nba_ml/data/espn.py - Project configuration → Game data download: configures paths
src/nba_ml/data/download.py - Project configuration → Game feature dataset: configures paths
src/nba_ml/data/build_dataset.py - Game data download → Game feature dataset: supplies raw data
src/nba_ml/data/build_dataset.py - Game feature dataset → Exploratory analysis: analyzes features
src/nba_ml/eda.py - Game feature dataset → Game model training: trains from
src/nba_ml/models/train.py - Game model training → Model and data artifacts: writes models
README.md - Game model training → Model results: evaluates models
README.md - Player game logs → Player props model: builds player features
README.md - Player props model → Model and data artifacts: stores projections
src/nba_ml/models/player_props.py - Model and data artifacts → Game predictions: loads model state
src/nba_ml/models/predict.py - Command-line interface → Game data download: runs download
src/nba_ml/cli.py - Command-line interface → Game feature dataset: builds dataset
src/nba_ml/cli.py - Command-line interface → Game model training: runs training
src/nba_ml/cli.py - Command-line interface → Game predictions: requests prediction
src/nba_ml/cli.py - Command-line interface → Streamlit dashboards: opens dashboard
src/nba_ml/cli.py - Command-line interface → Pro dashboard: opens dashboard
src/nba_ml/cli.py - Streamlit dashboards → Game predictions: generates forecasts
src/nba_ml/dashboard.py - Pro dashboard → Game predictions: generates forecasts
src/nba_ml/dashboard_pro.py - FastAPI application → Game predictions: serves predictions
app.py - FastAPI application → Player props model: serves player props
app.py - FastAPI application → Model results: uses model results
app.py - FastAPI application → Betting probabilities: uses betting calculations
- Web visitor → Web interface: uses interface
README.md - Web interface → FastAPI application: requests app data
README.md - Web interface → Injuries view: shows injuries
README.md - Web interface → Bet Builder: offers Bet Builder
README.md - Web interface → Advanced analytics: offers analytics
- Bet Builder → FastAPI application: analyzes selections
README.md - Injuries view → FastAPI application: loads injury data
README.md