Import files with CLI commands

Some datasets may contain too much data for a simple drag and drop. You may also want to import existing annotations to the images you've imported. In each case, CLI commands will provide the most effective way to get the data you want into V7.


You will need Python 3.7 or higher installed to complete these steps

Basics for using CLI Commands

Open the Command Prompt in Windows, or Terminal on a Mac.

For each command in these instructions, paste the text into the Command Prompt or Terminal and hit Enter to run the command.

1. Setup

Install or update the Darwin Software Development Kit using these instructions.

2. Authentification

Next, to enable remote operations, you'll first need to generate a team-specific API key.

In V7, head to the Settings menu and click API Keys to generate a new key

Name the key, tick all of the access permissions, and click Create before copying the access key to your keyboard. You'll need it in a second.

Back in the Command Prompt/Terminal, enter the command below:

darwin authenticate

You'll then be prompted to enter the API key that you just created. The API key is encrypted, so don't be surprised if you don't see the actual text after pasting it into the Command Prompt/Terminal.

Enter Y and hit Enter when prompted to make ****your team in V7 the default team.

This will create a configuration file on your device at ~/.darwin/config.yaml.

Now you're ready to upload your data

3. Upload data

Uploading data uses the 'push' command which is detailed on this page, but generally follows this structure.

darwin dataset push team-slug/dataset-slug /path/to/images/

There is also an option to fetch the command pre-written in V7 as shown in the image below. Select New Dataset or Add Data in an existing dataset to copy the Command Line Upload command. This command will push data from your device into the dataset in V7.


If you're uploading video files, you can specify the extraction rate by entering --fps<frame_rate> to the end of the path that command that V7 creates for you, the default fps being 2.

Replace the /path/to/images/ text with the path to the folder that contains the saved files on your device.

Hit enter one last time, and once the data has finished uploading, refresh the dataset page in V7 to review your data.

Next up

Now that you've imported data using CLI commands (and looked like a hacker doing it), you can use CLI commands to import annotations.