Skip to content

rekognition

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

rekognition

README.md

Amazon Rekognition code examples for the SDK for Python

Overview

Shows how to use the AWS SDK for Python (Boto3) to work with Amazon Rekognition.

Also includes a utility that you can use to create a custom label image-level manifest file from a CSV file.

Amazon Rekognition makes it easy to add image and video analysis to your applications.

⚠ Important

  • Running this code might result in charges to your AWS account. For more details, see AWS Pricing and Free Tier.
  • Running the tests might result in charges to your AWS account.
  • We recommend that you grant your code least privilege. At most, grant only the minimum permissions required to perform the task. For more information, see Grant least privilege.
  • This code is not tested in every AWS Region. For more information, see AWS Regional Services.

Code examples

Prerequisites

For prerequisites, see the README in the python folder.

Install the packages required by these examples by running the following in a virtual environment:

python -m pip install -r requirements.txt

Single actions

Code excerpts that show you how to call individual service functions.

Scenarios

Code examples that show you how to accomplish a specific task by calling multiple functions within the same service.

Run the examples

Instructions

Build a collection and find faces in it

This example shows you how to do the following:

  • Create an Amazon Rekognition collection.
  • Add images to the collection and detect faces in it.
  • Search the collection for faces that match a reference image.
  • Delete a collection.

Start the example by running the following at a command prompt:

python rekognition_collections.py

Detect and display elements in images

This example shows you how to do the following:

  • Detect elements in images by using Amazon Rekognition.
  • Display images and draw bounding boxes around detected elements.

Start the example by running the following at a command prompt:

python rekognition_image_detection.py

Detect objects in images

This example shows you how to build an app that uses Amazon Rekognition to detect objects by category in images.

Detect people and objects in a video

This example shows you how to detect people and objects in a video with Amazon Rekognition.

Tests

⚠ Running tests might result in charges to your AWS account.

To find instructions for running these tests, see the README in the python folder.

Additional resources

Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.

SPDX-License-Identifier: Apache-2.0