Part 1: Introduction to Amazon Rekognition

The application being built will leverage Amazon Rekognition to detect objects in images and videos. This part of the tutorial will teach you more about Rekognition and how to detect objects with its API.

Install the AWS CLI

To interact with the Rekognition API, the AWS CLI will need to be installed.

Instructions

1. Check to see the CLI is installed:

   $ aws --version
   aws-cli/1.15.60 Python/3.6.5 Darwin/15.6.0 botocore/1.10.59
   

   The version of the CLI must be version 1.15.60 or greater. We recommend using AWS CLI v2.

2a. If the CLI is not installed, follow the installation instructions in the

Setting up AWS credentials section.

2b. If your current CLI version is older than the minimum required version,

follow the upgrade instructions in the user guide to upgrade to the latest version of the AWS CLI.

Verification

1. Run the following command:

   $ aws --version
   aws-cli/1.15.60 Python/3.6.1 Darwin/15.6.0 botocore/1.10.59
   

   The version displayed of the CLI must be version 1.15.60 or greater.

Detect image labels using Rekognition

Use the Rekognition API via the AWS CLI to detect labels in an image.

Instructions

1. If you have not already done so, clone the repository for this workshop:

   $ git clone https://github.com/aws-samples/chalice-workshop.git
   

2. Use the detect-labels command to detect labels on a sample image:

   $ aws rekognition detect-labels \
       --image-bytes fileb://chalice-workshop/code/media-query/final/assets/sample.jpg
   

Verification

The output of the detect-labels command should be:

{
    "Labels": [
        {
            "Confidence": 85.75711822509766,
            "Name": "Animal"
        },
        {
            "Confidence": 85.75711822509766,
            "Name": "Canine"
        },
        {
            "Confidence": 85.75711822509766,
            "Name": "Dog"
        },
        {
            "Confidence": 85.75711822509766,
            "Name": "German Shepherd"
        },
        {
            "Confidence": 85.75711822509766,
            "Name": "Mammal"
        },
        {
            "Confidence": 85.75711822509766,
            "Name": "Pet"
        },
        {
            "Confidence": 84.56783294677734,
            "Name": "Collie"
        }
    ]
}