Skip to content


Repository files navigation

DataKit plugin

Commands to manage project integration with

  • Free software: ISC license


  • Create a project (dataset) on
  • Push data files from a local directory to a project

Setup instructions

Assuming you have DataKit installed, run the following to install the datakit-dworld plugin:

$ pip install datakit-dworld

Create a configuration file at ~/.datakit/plugins/datakit-dworld/config.json to tell the plugin about your account. It should look like this:

  "username": "USERNAME",
  "api_token": "API_TOKEN"

Replace USERNAME with the username you will use on to publish datasets.

Log in to as that same user, and go to your Advanced settings page. You'll see two long tokens under the "API Token" section. Copy the one labeled "Admin", and paste that into your configuration file in place of API_TOKEN.

How to use

When in a datakit project, you'll have two new commands:

  • datakit dworld create, which creates a new project (dataset) on This requires a --slug option to help set the project's URL. For example, if your username is example-human, then running datakit dworld create --slug example-dataset will create an empty dataset at
  • datakit dworld push, which uploads data files (CSV, etc.) from your project to This defaults to uploading any files in your project's data/public directory, but you can specify a different directory with --source-dir.
  • datakit dworld summary, which updates the dataset's overall Markdown summary on This assumes a Markdown file exists at publish/; if that is not present, it creates one based on the dataset's existing summary.


This plugin was created with Cookiecutter and the associatedpress/cookiecutter-datakit-plugin project template (a modified version of the most excellent audreyr/cookiecutter-pypackage).


Commands to manage project integration with







No releases published


No packages published