Skip to content

ImageMarkup/isic-cli

Repository files navigation

isic-cli

The official command line tool for interacting with the ISIC Archive.

Installation

  • Download the latest isic-cli release.
  • Extract the executable to a location where it can be invoked from the command line.

If running on macOS, you may need to add the executable to the list of trusted software to launch isic-cli in the same way you would any other registered app.

Common use cases

Note: isic will be isic.exe on Windows.

Downloading images

isic image download images/  # downloads the entire archive, images and metadata, to images/

# optionally filter the results
isic image download --search 'diagnosis:"basal cell carcinoma"' images/
isic image download --search 'age_approx:[5 TO 25] AND sex:male' images/

Downloading metadata

isic metadata download  # downloads the entire archive metadata to a csv

# find a collection to filter by
isic collection list  # grab the ID for the 2020 Challenge training set (70)
isic metadata download --collections 70