This is the data repository for the COVID-19 Forecast Hub, which is the data source for the official CDC COVID-19 Forecasting page.
If you are a modeling team interested in submitting to the Hub, please visit our technical README with detailed submission instructions.
If you are interested in using the forecast data in a research project, you may clone this repo or use our covidHubUtils R package to access the data through an API. Participating teams provide their
forecasts
in a quantile-based format. Please also follow the data license and citation guidelines below.
If you are a developer interested in the infrastructure here, we encourage you to check out the Hub documentation wiki.
We are grateful to the teams who have generated these and made their data public available under different terms and licenses. You will find the licenses (when provided) within the model-specific folders in the data-processed directory. Please consult these licenses before using these data to ensure that you follow the terms under which these data were released.
All source code that is specific to this project, along with our d3-foresight visualization tool is available under an open-source MIT license. We note that this license does NOT cover model code from the various teams (maybe available from them under other licenses) or model forecast data (available under specified licenses as described above).
To cite the COVID-19 Forecast Hub, please use a relevant research article or preprint produced by the group and a permanent DOI for the GitHub repo (the DOI is updated by Zenodo when we create a new "release" of this GitHub repository).