econdatasets

The ‘EconDataverse’ is a universe of open-source packages to work seamlessly with economic data. This package is designed to make it easy to download selected datasets that are preprocessed by ‘EconDataverse’ packages and publicly hosted on ‘Hugging Face’. Learn more about the ‘EconDataverse’ at econdataverse.org.

Installation

You can install econdatasets from CRAN via:

install.packages("econdatasets")

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

# install.packages("pak")
pak::pak("tidy-intelligence/r-econdatasets")

Usage

library(econdatasets)

Use ed_get() to load a specific table from a dataset:

counterparts <- ed_get("wbids", "counterparts")
#> → Reading dataset from
#>   https://huggingface.co/datasets/econdataverse/wbids/resolve/main/counterparts.parquet
#> ✔ Successfully loaded counterparts from wbids
head(counterparts, 5)
#>   counterpart_id counterpart_name counterpart_iso2code counterpart_iso3code
#> 1            001          Austria                   AT                  AUT
#> 2            002          Belgium                   BE                  BEL
#> 3            003          Denmark                   DK                  DNK
#> 4            004           France                   FR                  FRA
#> 5            005          Germany                   DE                  DEU
#>   counterpart_type
#> 1          Country
#> 2          Country
#> 3          Country
#> 4          Country
#> 5          Country

Use ed_get_tables() to see all tables available in a specific dataset:

ed_get_tables("imfweo")
#> → Fetching file tree from
#>   https://huggingface.co/api/datasets/econdataverse/imfweo/tree/main?recursive=1
#> ✔ Found 3 Parquet table(s).
#>              table                 filename                     path     size
#> 1 economic_outlook economic_outlook.parquet economic_outlook.parquet 48413034
#> 2         entities         entities.parquet         entities.parquet     7290
#> 3           series           series.parquet           series.parquet    11779
#>                                                                                          url
#> 1 https://huggingface.co/datasets/econdataverse/imfweo/resolve/main/economic_outlook.parquet
#> 2         https://huggingface.co/datasets/econdataverse/imfweo/resolve/main/entities.parquet
#> 3           https://huggingface.co/datasets/econdataverse/imfweo/resolve/main/series.parquet

Use ed_get_datasets() to view all published datasets:

ed_get_datasets()
#> → Fetching dataset list from
#>   https://huggingface.co/api/datasets?author=econdataverse
#> ✔ Found 2 datasets.
#>                dataset total_downloads            last_modified is_private
#> 1  econdataverse/wbids              24 2025-10-28T14:57:47.000Z      FALSE
#> 2 econdataverse/imfweo               4 2025-11-10T06:05:06.000Z      FALSE
#>   is_gated
#> 1    FALSE
#> 2    FALSE

If you miss a specific datasets, please consider opening an issue with your request.

Contributing

Contributions to econdatasets are welcome! If you’d like to contribute, please follow these steps:

1. Create an issue: Before making changes, create an issue describing the bug or feature you’re addressing.
2. Fork the repository: After receiving supportive feedback from the package authors, fork the repository to your GitHub account.
3. Create a branch: Create a branch for your changes with a descriptive name.
4. Make your changes: Implement your bug fix or feature.
5. Test your changes: Run tests to ensure your changes don’t break existing functionality.
6. Submit a pull request: Push your changes to your fork and submit a pull request to the main repository.