V7 Darwin

V7 Resources & Documentation

Welcome to the V7 resources & documentation hub. You'll find comprehensive guides and documentation to help you start working with V7 Darwin as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Getting Started

Using the Darwin cli is the fastest way to upload / download vast amounts of data to your dataset. It can also help you import and export annotations in various formats.

The cli is part of the darwin-py package which also includes our Python SDK. This section of documentation will focus on the command line tool aspects.


pip install darwin-py

Once installed, darwin will be available from the command line.


Python Versions

Darwin-py has been tested for python >= 3.6, while older versions might work they are not supported.


To perform remote operations on Darwin you first need to authenticate. Authentication requires a team-specific API-key.
If you do not already have a Darwin account, you can contact us and we can set one up for you.

To start the authentication process:

$ darwin authenticate
API key: ***********
Make example-team the default team? [y/N] y
Datasets directory [~/.darwin/datasets]: 
Authentication succeeded.

You will be then prompted to enter your API-key, whether you want to set the corresponding team as default and finally the desired location on the local file system for the datasets of that team. This process will create a configuration file at ~/.darwin/config.yaml. This file will be updated with future authentications for different teams.



The API key rights selected when requesting the key determine which commands in the SDK are allowed. If the key has insufficient permissions for an action an error will be shown: Insufficient permissions or Invalid API key.

Updated 2 months ago

Getting Started

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.