This guide will cover how to install the data tool and verify that it is working properly. data is distributed as a command line tool.

There are two options for installation:

  1. Installing pre-built binaries. These have no dependencies and will work “out of the box”
  2. Install via npm: if you have node (>= v7.6) and npm installed you can install via npm

Installing binaries

  1. Go to the releases page

  2. Download the pre-built binary for your platform (MacOS, LinuxOS x64 or Windows)

  3. Uncompress downloaded asset

    # MacOS and Linux:
    $ gunzip -f data-{os-distribution}.gz
    # Windows:
    $ gzip -d data-win.exe.gz
  4. Make it executable

    # MacOS and Linux only:
    $ chmod +x data-{os-distribution}
  5. Move the binary into your $PATH e.g. on Mac you could move to /usr/local/bin/

    # MacOS and Linux:
    $ mv data-{os-distribution} /usr/local/bin/data
    # Windows (the path may change depending on your OS distribution and configurations):
    $ move data-win.exe "C:\Windows\System32\data.exe"

For linux users, if you encounter errors related to location of xdg-open package. Use the following command to copy it from /usr/bin/xdg-open to /usr/local/bin/xdg-open:

$ cp /usr/bin/xdg-open /usr/local/bin/xdg-open

Installing via npm

You can also install it from npm as follows:

$ npm install -g data-cli


To test that it is installed correctly run:

$ data --version

This should output a version number, for example on my machine it shows:


A first step

Finally, and as a last test, you can try out your first ❒ data command: info.

Note: This command makes no changes to anything on your machine or on the DataHub so it is completely safe to try out!

The info command provides info on a data file or dataset whether it is on the DataHub or your local disk. Here’s an example for you to try:

data info

It should something like this:

CBOE Volatility Index (VIX) time-series dataset including daily open, close, high and low …

You can learn more about data tool here -

If you have questions, comments or feedback join our chat channel or open an issue on our tracker.