Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ct83/facial-recognition-attendance-system
An attendance system which uses facial recognition to detect which people are present in any image.
https://github.com/ct83/facial-recognition-attendance-system
algorithm angular attendance aws-s3 deep-learning django django-rest-framework face-api face-detection face-detection-using-opencv face-recognition facial-recognition javascipt machine-learning microsoft microsoft-cognitive-services opencv paper python rest-api
Last synced: 16 days ago
JSON representation
An attendance system which uses facial recognition to detect which people are present in any image.
- Host: GitHub
- URL: https://github.com/ct83/facial-recognition-attendance-system
- Owner: CT83
- License: mit
- Created: 2018-07-31T14:05:01.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-05-23T02:10:27.000Z (over 4 years ago)
- Last Synced: 2024-10-12T16:26:22.604Z (about 1 month ago)
- Topics: algorithm, angular, attendance, aws-s3, deep-learning, django, django-rest-framework, face-api, face-detection, face-detection-using-opencv, face-recognition, facial-recognition, javascipt, machine-learning, microsoft, microsoft-cognitive-services, opencv, paper, python, rest-api
- Language: Python
- Size: 221 MB
- Stars: 61
- Watchers: 2
- Forks: 17
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Facial Recognition Attendance System using Deep Learning with Microsoft FaceAPI, Django and Raspberry Pi-es!
### F.R.A.S!
> #### No Longer Maintained - About to be rewritten.
> Guys, I am extremely sorry to say that the Django Server code is severely broken and needs a complete rewrite, I'll be doing that really soon, so until then. Stay Tuned. 🤷🏽♂️
Other than being a mouthful to say;
_FRAS_ allows **tens of facial-recognition-camera-clients** aka tiny *Raspberry Pi-es* to be deployed all across a college,
or an industrial campus, which then record who they see and when they see then to a central database.
The entire system runs for dirt cheap on cloud using [Microsoft Face API](https://azure.microsoft.com/en-us/services/cognitive-services/face), [Heroku](https://fras-1.herokuapp.com) and [AWS S3](https://aws.amazon.com/s3) and using multiple [Raspberry Pi Zeros](https://www.raspberrypi.org/products/raspberry-pi-zero), which cost about **15**-**17$**
## How does it work?
#### Dystopian node-based Facial Recognition in 5 simple steps.
1. A [Django REST Server](), with a **PostGres Database** runs on [Heroku](https://fras-1.herokuapp.com).
2. A **15$** [Raspberry Pi Zero](https://www.raspberrypi.org/products/raspberry-pi-zero) with a [Camera Module](https://www.raspberrypi.org/products/camera-module-v2) and internet connection is placed at any location - entrances, exits, hallways
3. The **Raspberry Pi** - *Camera Client* takes an image at regular intervals and sends this to [Microsoft Face API](https://azure.microsoft.com/en-us/services/cognitive-services/face), which tells who-is-who in the image.
4. The *Camera Client* then sends the names of recognized persons to the **REST Server** for storage with the captured images which are sent to [AWS S3](https://aws.amazon.com/s3) for storage.
5. [Angular Frontend](https://fras-ui.herokuapp.com) allows users to view the stored data.
> This was my high school's final semester project on which I barely spent 48 hours building. The REST Server and
Angular proved to be quite an undertaking! But, the professor seems pleasantly surprised with what
I built so it all ended just fine. :)
## Architectural Overview
### Basic Architecture
Every Camera Client is responsible for recognizing all of the faces on it’s own and communicating with the **Microsoft Face API** as well as saving the images to S3, also the users connected to the Angular Client can also need to see the uploaded images, so everything ends up looking like this.
### User Interface
#### Main Page
The Main Page shows the list of all registered people, **Face API** is sent about ~20 images of each person during the initial setup.
#### Recent Images
Shows the most recently captured images from all Camera Clients
#### Attendance Table
Shows a list of all dates and number of present people, selecting one of them takes you to the next page.
#### Working Day Details
Shows all of the lectures which were held that day in school, and how many people were present for those.
#### Lecture Details
Shows how many students were present for that particular lecture.
## Hardware
### Raspberry Pi Zero - Camera Module
#### Add a 5$ Case and Viola!
## How do I run it? -- Ehh
This is a high level description of what you could do, but feel free to hit me up on Hangouts at [email protected] if you are interested in getting something like this up and running.
1. [Setup Microsoft Face API](https://docs.microsoft.com/en-us/azure/cognitive-services/Face/Tutorials/FaceAPIinPythonTutorial)
2. [Build OpenCV on a Raspberry Pi Zero](https://www.pyimagesearch.com/2015/12/14/installing-opencv-on-your-raspberry-pi-zero)
3. [Setup up Django Server on Heroku](https://devcenter.heroku.com/articles/deploying-python)
4. [Setup Angular Frontend on Heroku](https://medium.com/@hellotunmbi/how-to-deploy-angular-application-to-heroku-1d56e09c5147)
5. [Setup AWS S3](https://www.whizlabs.com/blog/aws-s3/)
## Problem that I started out to solve
On one rainy day in July, I dejectedly shook my head at the distressed professor who stared back at me, wondering where half of the class was? I shrugged helplessly, and went back to daydreaming about the Black Mirror episode which I watched earlier that day. The school had tried everything, taking attendance twice during lectures, making everyone sign a piece of paper passed around the class, fining for those who remained absent … you name it. All of these seemed like foolproof solutions to the problems according to the school’s middle management, me? I had my doubts.
Lack of attendance in school during lectures…hmm, maybe AI could help me solve this, and helped me-solve-this it did, well at least on paper for the time being.
YES! We could turn the college campus into a total surveillance state, monitor everyone, store everyone’s faces, track their every move, and use that to generate **helpful insights** to make the world a better place. 🙃
That was how everything started, there are still a lot of features which I left unexplored, *Face API* also provides support for emotion recognition…
Why? So we know our happy students from the sad ones?
Maybe I could add activity recognition? That would help teachers pick the sleepiest of their pupils.
:down-the-rabbit-hole: 🐇
#### Moving on…
## Vision
In my worst nightmares, I imagine a highly sophisticated version of this running running on embedded devices like the [Nvidia Nano](https://www.nvidia.com/en-us/autonomous-machines/embedded-systems/jetson-nano/) - on every street corner, every shop and every stop light, the data could be continuously stored in on the blockchain with no central point of failure, as we try and hope hard that our [Funky-Glasses](https://www.theverge.com/2016/11/3/13507542/facial-recognition-glasses-trick-impersonate-fool) are enough to fool the cutting edge ML Models.