🚨IMPORTANT 🚨 The NPM version of cacli is officially no longer supported. Please use the new installation instructions below.

The Cloud Annotations CLI requires you to already have labeled images in the Cloud Annotations online tool. For an in-depth guide on this process, check out the following links:

• Training a Classification Model – How to train your own model to label images on IBM Cloud.
• Training an Object Detection Model – How to train your own model to find objects in an image on IBM Cloud.

Cloud Annotations CLI should work on macOS, Windows, and Linux.
If something doesn’t work, please file an issue.

If you are on macOS and using Homebrew, you can install cacli with the following:

$ brew install cacli

If you are on Linux or macOS, you can install cacli with the following:

$ curl -sSL https://cloud.annotations.ai/install.sh | sh

1. Download the binary.
2. Rename it to cacli.exe.
3. cd to the directory where it was downloaded.
4. Run cacli --version to check that it's working.

(Optional) Add cacli.exe to your PATH to access it from any location.

Download the appropriate version for your platform from the releases page. Once downloaded, the binary can be run from anywhere. You don't need to install it into a global location. This works well for shared hosts and other systems where you don't have a privileged account.

Ideally, you should install it somewhere in your PATH for easy use. /usr/local/bin is the most probable location.

Note: The npm installation is deprecated and no longer supported.