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

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

aws aws-cdk aws-cdk-typescript awsrekognition cdk cdk-ts rekognition typescript

Last synced: 18 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/garysassano/cdk-aws-cat-rekognizer
• Owner: garysassano
• License: apache-2.0
• Created: 2023-12-16T10:15:09.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-11-22T00:16:56.000Z (about 1 month ago)
• Last Synced: 2024-11-22T01:20:06.790Z (about 1 month ago)
• Topics: aws, aws-cdk, aws-cdk-typescript, awsrekognition, cdk, cdk-ts, rekognition, typescript
• Language: TypeScript
• Homepage:
• Size: 1.9 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.

## 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 ``:

   ```sh

   ✅  cdk-aws-cat-rekognizer-dev

   ✨  Deployment time: 390.01s

   Outputs:

   cdk-aws-cat-rekognizer-dev.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)