Skip to main content

Commands to manage project integration with

Project description

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 -e 'git+'

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).

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

datakit-dworld-1.0.0.tar.gz (16.0 kB view hashes)

Uploaded Source

Built Distribution

datakit_dworld-1.0.0-py3-none-any.whl (10.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page