# isic-cli
The official command line tool for interacting with the [ISIC Archive](https://isic-archive.com).
> **Note:** Looking to download the entire Archive? A [prebuilt snapshot](https://isic-archive.s3.us-east-1.amazonaws.com/snapshots/ISIC_images.zip) (60GB) is available through the [AWS Open Data Program](https://registry.opendata.aws/isic-archive/) for easier bulk access.
## Installation
- Download the [latest isic-cli release](https://github.com/ImageMarkup/isic-cli/releases/latest).
- 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](https://support.apple.com/guide/mac-help/apple-cant-check-app-for-malicious-software-mchleab3a043/mac) 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
``` sh
isic image download images/ # downloads the entire archive, images and metadata, to images/
# optionally filter the results
isic image download --search 'diagnosis_3:"Melanoma Invasive"' images/
isic image download --search 'age_approx:[5 TO 25] AND sex:male' images/
```
### Downloading metadata
``` sh
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
```
Raw data
{
"_id": null,
"home_page": "https://github.com/ImageMarkup/isic-cli",
"name": "isic-cli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": "Kitware, Inc.",
"author_email": "kitware@kitware.com",
"download_url": "https://files.pythonhosted.org/packages/91/f7/516a9b37d884e66dbbdbaa218df4b5c9c56753456bc1f38b435885079c91/isic_cli-12.4.0.tar.gz",
"platform": null,
"description": "# isic-cli\n\nThe official command line tool for interacting with the [ISIC Archive](https://isic-archive.com).\n\n> **Note:** Looking to download the entire Archive? A [prebuilt snapshot](https://isic-archive.s3.us-east-1.amazonaws.com/snapshots/ISIC_images.zip) (60GB) is available through the [AWS Open Data Program](https://registry.opendata.aws/isic-archive/) for easier bulk access.\n\n## Installation\n- Download the [latest isic-cli release](https://github.com/ImageMarkup/isic-cli/releases/latest).\n- Extract the executable to a location where it can be invoked from the command line.\n\nIf running on macOS, you may need to [add the executable to the list of trusted software](https://support.apple.com/guide/mac-help/apple-cant-check-app-for-malicious-software-mchleab3a043/mac) to launch isic-cli in the same way you would any other registered app.\n\n## Common use cases\n\nNote: `isic` will be `isic.exe` on Windows.\n\n### Downloading images\n\n``` sh\nisic image download images/ # downloads the entire archive, images and metadata, to images/\n\n# optionally filter the results\nisic image download --search 'diagnosis_3:\"Melanoma Invasive\"' images/\nisic image download --search 'age_approx:[5 TO 25] AND sex:male' images/\n```\n\n\n### Downloading metadata\n\n``` sh\nisic metadata download # downloads the entire archive metadata to a csv\n\n# find a collection to filter by\nisic collection list # grab the ID for the 2020 Challenge training set (70)\nisic metadata download --collections 70\n```\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": null,
"version": "12.4.0",
"project_urls": {
"Bug Reports": "https://github.com/ImageMarkup/isic-cli/issues",
"Homepage": "https://github.com/ImageMarkup/isic-cli",
"Source": "https://github.com/ImageMarkup/isic-cli"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "8e999c1568acbf2aec7395f8a1cfd5bd003aff70c48c362d825d2514c0cb8ba7",
"md5": "a0b8ebd605f2ca4b29ae707a5e0c0d3a",
"sha256": "a8ff28fd26009d70391673fa7fb1d4255b959c71af1518fc9178ac95d18b2696"
},
"downloads": -1,
"filename": "isic_cli-12.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a0b8ebd605f2ca4b29ae707a5e0c0d3a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 34231,
"upload_time": "2025-08-21T03:09:55",
"upload_time_iso_8601": "2025-08-21T03:09:55.141637Z",
"url": "https://files.pythonhosted.org/packages/8e/99/9c1568acbf2aec7395f8a1cfd5bd003aff70c48c362d825d2514c0cb8ba7/isic_cli-12.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "91f7516a9b37d884e66dbbdbaa218df4b5c9c56753456bc1f38b435885079c91",
"md5": "47139edebeee85a09e922c46a5a07080",
"sha256": "090108513863193a5eec9b827408b1a4db60b2262975fb654f77e137bb5c6b25"
},
"downloads": -1,
"filename": "isic_cli-12.4.0.tar.gz",
"has_sig": false,
"md5_digest": "47139edebeee85a09e922c46a5a07080",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 31588,
"upload_time": "2025-08-21T03:09:56",
"upload_time_iso_8601": "2025-08-21T03:09:56.026152Z",
"url": "https://files.pythonhosted.org/packages/91/f7/516a9b37d884e66dbbdbaa218df4b5c9c56753456bc1f38b435885079c91/isic_cli-12.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-21 03:09:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ImageMarkup",
"github_project": "isic-cli",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "isic-cli"
}
JSON
