Who is it

Find out what famous people are on your photos

Stack:

• Golang
• Serverless Framework
• Amazon S3
• Amazon DynamoDB
• Amazon SQS

CI/CD

• code is deployed to aws with each push to the master branch (done via Github Actions)

Endpoints

Upload your images using to /dev/celeb endpoint

POST /celeb

• uploads image to the s3 and runs the celebrity recognition event. Body structure:

  {
    imageBase64: string,
    fileName: string,
    extension: string
   }
  

• this request will return an url to an object created in the s3 that will be used later
• related serverless functions:
  • image-upload - executed by this request
  • image-created - event triggered by sqs

GET /celeb

• returns list of celebrities recognized from your photos. Each celebrity contains an array of photos representing him (that were uploaded to s3)
• related serverless functions:
  • get-celebs - executed by this request

Demo

1. Add many photos asynchronously

./scripts/batch_post_directory.sh ${API}/celeb ${PHOTOS_LIBRARY}

for the sake of testing, you can use ./images as your PHOTO_LIBRARY

1.1. Observe how SQS allows to queue uploading images to the dynamodb

1.2. You can also see the queued messages in SQS console

2. List celebrities found in your library

curl ${API}/celeb | jq