Getting Started with Qri Desktop

Follow these steps to turn an ordinary CSV into a published & versioned Qri dataset.

  Download & Sign Up

Download Qri Desktop for MacOS or Windows. On first run, you'll be prompted to sign up for a free Qri account. Your username will be used to describe each of your datasets, so pick something you'll be happy to share later!

Download Desktop

  Create a new Qri dataset

Choose Create a Dataset to begin. You'll need to :

  • Choose a CSV file to import
  • Name the new dataset
  • Select a directory for Qri to store the dataset's files

Click Create, and you're ready to go!

  Add metadata

Qri datasets have Components. The data you imported now lives in the Body. Another component, Meta, is where you can add things like a title, description, and subject tags.

Good metadata will keep you organized and help others find, use, and understand your dataset.

  Make your first Commit

You've imported raw data and added metadata, but your dataset isn't ready to share until you commit your changes.

Use the commit form to write a short message describing the changes you've made. e.g. "Created new dataset, added title and description".

This message is saved with the dataset, so anyone who works on it in the future will know what you contributed.

  Publish your Dataset

Once you've made at least one commit, your dataset is ready to publish. Click the Publish button in Qri Desktop's header to share your dataset with the world!

Publishing will create a landing page for your dataset on Others will be able to find your dataset and start using it on their own.

  Next Steps...

Check out your dataset on Qri Cloud!

Here are a few more things to explore: