Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jimbobbennett/attendeedetectorworkshop

A Python and Azure workshop to look for faces in photos and store the resutls in Cosmos DB, exposed via a Flask app
https://github.com/jimbobbennett/attendeedetectorworkshop

azure azureappservices cognitive-services cosmosdb flask python

Last synced: 11 days ago
JSON representation

A Python and Azure workshop to look for faces in photos and store the resutls in Cosmos DB, exposed via a Flask app

Host: GitHub
URL: https://github.com/jimbobbennett/attendeedetectorworkshop
Owner: jimbobbennett
License: mit
Created: 2019-04-11T16:33:40.000Z (over 5 years ago)
Default Branch: master
Last Pushed: 2020-12-05T00:12:09.000Z (almost 4 years ago)
Last Synced: 2024-10-09T12:42:26.914Z (29 days ago)
Topics: azure, azureappservices, cognitive-services, cosmosdb, flask, python
Language: Python
Size: 1.45 MB
Stars: 3
Watchers: 1
Forks: 2
Open Issues: 2
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # Attendee Detector Workshop

This workshop shows how to build a web app using [Python](https://www.python.org) and [Flask](http://flask.pocoo.org) running on [Microsoft Azure](https://azure.microsoft.com/free/students/?WT.mc_id=pythonworkshop-github-jabenn) that takes images from a desktop app, analyses them for faces using AI and stores information about the age and emotion of any faces in the image, along with if anyone is smiling. The web app also serves up a simple page showing the data captured.

This workshop is designed for students, and can be run using the free services available as part of the [Azure for students](https://azure.microsoft.com/free/students/?WT.mc_id=pythonworkshop-github-jabenn) offer.

## Prerequisites

To complete this workshop, you will need:

* An Azure account. Sign up for free using [Azure for students](https://azure.microsoft.com/free/students/?WT.mc_id=pythonworkshop-github-jabenn), or the [Azure free account](https://azure.microsoft.com/free/?WT.mc_id=pythonworkshop-github-jabenn) if you are not at an academic institution.

* [Python 3](https://www.python.org/downloads/).

  

  > If you are using Windows you will need to restart your machine after installing to ensure you can use Python and Pip from the command line.

* [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=pythonworkshop-github-jabenn)

* The [Python Extension for Visual Studio Code](https://marketplace.visualstudio.com/itemdetails?itemName=ms-python.python&WT.mc_id=pythonworkshop-github-jabenn). This can be installed from inside VS Code using the *Extensions* tab.

  

  ![The Python extension in Visual Studio Code](./Images/PythonExtension.png)

* The [Azure App Service Extension for Visual Studio Code](https://marketplace.visualstudio.com/itemdetails?itemName=ms-azuretools.vscode-azureappservice&WT.mc_id=pythonworkshop-github-jabenn). This can be installed from inside VS Code using the *Extensions* tab.

  

  ![The Azure App Service extension in Visual Studio Code](./Images/AppServiceExtension.png)

* The [Azure Cosmos DB Extension for Visual Studio Code](https://marketplace.visualstudio.com/itemdetails?itemName=ms-azuretools.vscode-cosmosdb&WT.mc_id=pythonworkshop-github-jabenn). This can be installed from inside VS Code using the *Extensions* tab.

  

  ![The Cosmos DB extension in Visual Studio Code](./Images/CosmosExtension.png)

  > You will need to restart Visual Studio Code before using this extension.

* A laptop with a Web Cam, or an external camera.

This workshop works on MacOS and Windows.

## The Attendee Detector app

The attendee detector is a Python app. It uses a library called [OpenCV](https://opencv.org) which is accessible from Python to access the Web Cam and take a picture. Once a picture has been taken, this app will send it to a Web Api built in Python, using a framework called [Flask](http://flask.pocoo.org) and running in the cloud. This is a special type of web site address that doesn't return a web page, but instead allows you to send and receive data.

The Web Api will take the picture, and analyze it using the [Azure Face Api](https://azure.microsoft.com/services/cognitive-services/face/?WT.mc_id=pythonworkshop-github-jabenn) from [Azure Cognitive Services](https://azure.microsoft.com/services/cognitive-services/?WT.mc_id=pythonworkshop-github-jabenn). This is an AI service that can recognize faces in images, as well as estimating the age of the face, if the person is smiling amongst other things. The Web Api will use this service to detect the age and emotion of all the faces and if they are smiling. This will then be saved into a database called [CosmosDB](https://azure.microsoft.com/services/cosmos-db/?WT.mc_id=pythonworkshop-github-jabenn). This is a document database - instead of storing data in rows and columns in tables, it stored data as documents. These documents contain key/value pairs of data stored in a format called [JSON](https://www.json.org).

The Web Api will then have a web site added. This web site will load all the data from CosmosDB and show it in a simple HTML table, showing all details from all faces captured.

![The web app showing a page with a table of age, smiling, emotion with 4 rows](./Images/RunningWebsite.png)

## Code format

All code in this sample is shown in code blocks like this one:

```python

print('Here is some code')

```

Ellipses will be used to indicate other code, removed to make new code or the code that is being discussed easier to see. For example a code block like this:

```python

def func():

  ...

  print('end of the suite')

```

means that the `print('end of the suite')` will need to go inside the `func` function, but *after* all existing code in this function

## Steps

The steps for this workshop are:

1. [Build an app to take a photo](./Steps/BuildAnAppToTakeAPhoto.md)

1. [Create a Flask Web App](./Steps/CreateAFlaskWebApp.md)

1. [Deploy the Web App to Azure](./Steps/DeployTheWebAppToTheCloud.md)

1. [Add a Web Api to accept a photo](./Steps/AddWebApi.md)

1. [Analyse the photo using AI](./Steps/AnalyseThePhotoUsingAI.md)

1. [Save the face details to a database](./Steps/SaveTheResultsToADatabase.md)

1. [Call the web Api from the app](./Steps/CallTheWebApiFromDesktop.md)

1. [Add a web page to view the results](./Steps/ViewTheResults.md)

1. [Clean up](./Steps/CleanUp.md)

## Code

For reference, you can find the final code for this workshop in the [Code](./Code/) folder.

## Clean up Azure resources

This workshop uses resources that are available in the [Azure for Students account as free services](https://azure.microsoft.com/en-us/free/free-account-students-faq/). As there are limits on the number of free services you can create, you may want to delete the resources created once you are done. The instructions to do this are in the last step - [Clean up](./Steps/CleanUp.md).