# Unitlab CLI

{% hint style="info" %}
This **guide** shows how to use the most common CLI commands
{% endhint %}

#### Common commands

After [installing the Unitlab package](https://docs.unitlab.ai/cli-python-sdk/get-started), you can efficiently manage your projects and datasets through the terminal. To access all the available commands,  run `unitlab --help`. However, before executing any command, ensure you have an API key, which can be obtained by visiting the user account page.

<figure><img src="https://1366014570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVY6yJqW9wWHP6u0XYu5Q%2Fuploads%2Fsr5v3CYfkRUTkspnbhfj%2Fimage_2024-04-09_11-47-11.png?alt=media&#x26;token=1bebb371-ef17-4628-848a-03fd32ea3174" alt=""><figcaption></figcaption></figure>

#### Configuration

This command helps you configure your credentials. It saves the API key and URL in a configuration file  `~/.unitlab/credentials`for future use. Other commands can override the default API key if provided as an `--api-key`option.&#x20;

<figure><img src="https://1366014570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVY6yJqW9wWHP6u0XYu5Q%2Fuploads%2FbmjuWpte0xxM0VTVuBkP%2Fimage_2024-04-09_13-32-41.png?alt=media&#x26;token=ee76af76-0b57-43cf-af59-258492a54d2c" alt=""><figcaption></figcaption></figure>

#### Project list

To retrieve a list of your current projects, execute `unitlab project list`.

<figure><img src="https://1366014570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVY6yJqW9wWHP6u0XYu5Q%2Fuploads%2FWyt9Mq3f4hMfEkHIb5uE%2Fimage_2024-04-09_12-54-54.png?alt=media&#x26;token=608eec92-6590-4586-85cb-7b761126a963" alt=""><figcaption></figcaption></figure>

#### Uploading data

Users can upload images to the Unitlab project by using the `unitlab project upload` command.

<figure><img src="https://1366014570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVY6yJqW9wWHP6u0XYu5Q%2Fuploads%2FecvJbVzefdia6TWlBQeJ%2Fimage_2024-04-09_14-29-19.png?alt=media&#x26;token=74a12f2a-3b13-4025-a0f0-24022fe08585" alt=""><figcaption></figcaption></figure>

#### Dataset list

The command `unitlab dataset list` allows users to list available public and private datasets.

<figure><img src="https://1366014570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVY6yJqW9wWHP6u0XYu5Q%2Fuploads%2FBMjZYoF8ewIFCkktMrQn%2Fimage_2024-04-09_15-07-46.png?alt=media&#x26;token=3ee35247-1963-4319-bbfe-450ad2d64c83" alt=""><figcaption></figcaption></figure>

#### Download a dataset

To download datasets, use `unitlab dataset download` command:

<figure><img src="https://1366014570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVY6yJqW9wWHP6u0XYu5Q%2Fuploads%2FHxleA7gvWCu77i4nXpL7%2Fimage_2024-04-09_15-17-58.png?alt=media&#x26;token=d28998eb-e7c5-48a4-8d80-5ebee72a3a8f" alt=""><figcaption></figcaption></figure>

The examples are just a few of the CLI commands available to users. Depending on your specific needs and preferences, you can use a wide range of other commands.