sportsdataverse

The sportsdataverse is a set of sports data packages that work in harmony because they share common data representations and API design. This package is designed to make it easy to install and load multiple sportsdataverse packages in a single step. Learn more about the sportsdataverse at sportsdataverse.org.

Data freshness and pipeline status for every SportsDataverse dataset: sportsdataverse.org/status.

Installation

You can install the latest build from R-universe with:

install.packages("sportsdataverse", repos = c("https://sportsdataverse.r-universe.dev", getOption("repos")))

You can install the development version of sportsdataverse from GitHub with:

if (!requireNamespace("pak", quietly = TRUE)) install.packages("pak")
pak::pak("sportsdataverse/sportsdataverse-R")
# or, with remotes:
# if (!requireNamespace("remotes", quietly = TRUE)) install.packages("remotes")
# remotes::install_github("sportsdataverse/sportsdataverse-R")

Quick start

library(sportsdataverse)

# Report the installed versions of the SportsDataverse packages
sportsdataverse_sitrep()

# Check for out-of-date SportsDataverse packages and print the install command
sportsdataverse_update()

library(sportsdataverse) will load the following packages:

baseballr, for MLB and college baseball data.
cfbfastR, for college football data.
cfbseedR, for simulating college football seasons and playoff seeding.
fastRhockey, for NHL and PWHL hockey data.
hoopR, for men’s college and professional basketball data.
mlbplotR, for MLB team and player logos, headshots, and plot themes.
oddsapiR, for sportsbook odds from The Odds API.
sportyR, for drawing regulation playing surfaces.
wehoop, for women’s college and professional basketball data.

Additional ecosystem packages — cfbplotR, cfb4th, recruitR, and softballR — are available in the SportsDataverse but are not auto-loaded by library(sportsdataverse).

sportsdataverse::sportsdataverse_logo()

R Packages in the SportsDataverse

`cfbfastR`

`cfbseedR`

`hoopR`

`wehoop`

`fastRhockey`

`baseballr`

`mlbplotR`

`sportyR`

`oddsapiR`

Documentation

Documentation website
Function reference
News and release notes
sportsdataverse-R cheat sheet (PDF): a printable one-page reference covering the metapackage. Every SportsDataverse package has one — browse them all at sportsdataverse.org/cheatsheets.

Companion packages

cfbplotR, for college football logo plots in ggplot2.
sdvplotR, for team logo plots in ggplot2, gt and reactable across the SportsDataverse leagues.
sdvmodels, for the fitted college football models that cfbfastR scores with.

The SportsDataverse

sportsdataverse is part of the SportsDataverse, a set of open-source packages for sports data.

Package	Sport / Scope
cfbfastR	College football
hoopR	Men’s basketball (NBA and NCAA)
wehoop	Women’s basketball (WNBA and NCAA)
fastRhockey	Hockey (NHL and PWHL)
baseballr	Baseball (MLB, MiLB, NCAA)
softballR	College softball
oddsapiR	Sports betting odds
recruitR	College football recruiting
usfootballR	US soccer
cfbseedR · cfb4th	CFB playoff simulation · fourth-down decisions
cfbplotR · sdvplotR · sportyR	Logos, colors, tables · playing surfaces
sportsdataverse-R	Umbrella R metapackage
sportsdataverse-py · sportsdataverse.js	Python and Node.js

See the full ecosystem at sportsdataverse.org.

Follow the SportsDataverse on X and star this repo

Our Authors

Saiem Gilani

Cheat sheet

A printable one-page reference for sportsdataverse — the metapackage, its loaders, and the packages it attaches.

📄 Download the sportsdataverse-R cheat sheet (PDF)

Free to download, print and hand out; light and dark, US Letter landscape. Every SportsDataverse package has one — browse them all at sportsdataverse.org/cheatsheets.

Citations

To cite the sportsdataverse R package in publications, use:

BibTeX Citation

@misc{saiemgilani2021sdv,
  author = {Gilani, Saiem},
  title = {sportsdataverse: The Set of R Packages for Sports Data.},
  url = {https://r.sportsdataverse.org},
  year = {2026}
}