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 and LinuxOS x64 at present)

  3. Move the binary into your $PATH e.g. on Mac you could move to /usr/local/bin/

    $ mv data-{os-distribution} /usr/local/bin/data
    

Installing via npm

You can also install it from npm as follows:

$ npm install -g datahub-cli

Verifying

To test that it is installed correctly run:

$ data --version

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

0.4.1

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 https://datahub.io/core/finance-vix

It should something like this:

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

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