Skip to content

An attendance system which uses facial recognition to detect which people are present in any image.

License

Notifications You must be signed in to change notification settings

CT83/Facial-Recognition-Attendance-System

Repository files navigation

Facial Recognition Attendance System using Deep Learning with Microsoft FaceAPI, Django and Raspberry Pi-es!

GitHub issues

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, Heroku and AWS S3 and using multiple Raspberry Pi Zeros, 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.
  2. A 15$ Raspberry Pi Zero with a Camera Module 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, 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 for storage.
  5. Angular Frontend 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

arch-1

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.

arch-1

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.

img

Recent Images

Shows the most recently captured images from all Camera Clients

img

Attendance Table

Shows a list of all dates and number of present people, selecting one of them takes you to the next page.

img

Working Day Details

Shows all of the lectures which were held that day in school, and how many people were present for those.

img

Lecture Details

Shows how many students were present for that particular lecture.

img

Hardware

Raspberry Pi Zero - Camera Module

Image

Add a 5$ Case and Viola!

Image

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
  2. Build OpenCV on a Raspberry Pi Zero
  3. Setup up Django Server on Heroku
  4. Setup Angular Frontend on Heroku
  5. Setup AWS S3

Problem that I started out to solve

Image

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 - 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 are enough to fool the cutting edge ML Models.