https://github.com/garysassano/cdk-aws-cat-rekognizer

CDK app that detects whether an uploaded image contains a cat or not using Amazon Rekognition
https://github.com/garysassano/cdk-aws-cat-rekognizer

amazon-rekognition aws aws-cdk aws-cdk-typescript cdk cdk-ts rekognition typescript

Last synced: 9 days ago
JSON representation

CDK app that detects whether an uploaded image contains a cat or not using Amazon Rekognition

• Host: GitHub
• URL: https://github.com/garysassano/cdk-aws-cat-rekognizer
• Owner: garysassano
• License: apache-2.0
• Created: 2023-12-16T10:15:09.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-05-07T22:52:05.000Z (2 months ago)
• Last Synced: 2025-05-07T23:26:58.055Z (2 months ago)
• Topics: amazon-rekognition, aws, aws-cdk, aws-cdk-typescript, cdk, cdk-ts, rekognition, typescript
• Language: TypeScript
• Homepage:
• Size: 1.91 MB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# cdk-aws-cat-rekognizer

CDK app that detects whether an uploaded image contains a cat or not using Amazon Rekognition.

## Prerequisites

- **_AWS:_**

  - Must have authenticated with [Default Credentials](https://docs.aws.amazon.com/cdk/v2/guide/cli.html#cli_auth) in your local environment.

  - Must have completed the [CDK bootstrapping](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html) for the target AWS environment.

- **_Node.js + npm:_**

  - Must be [installed](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) in your system.

## Installation

```sh

npx projen install

```

## Deployment

```sh

npx projen deploy

```

## Usage

1. Access the website by clicking the `` from the deployment outputs:

   ```sh

   Outputs:

   WebsiteDistributionUrl = 

   ```

2. Upload your image from the UI:

   ![Upload Image](./src/assets/upload.png)

3. In AWS Console, `DynamoDB` ➜ `idempotency-table-XXXXXXXX`:

   ![Persist Data](./src/assets/idempotency.png)

4. The DynamoDB table displays the cat detection result and S3 URL for unique uploaded images.

## Cleanup

```sh

npx projen destroy

```

## Architecture Diagram

![Architecture Diagram](./src/assets/arch.svg)