Employee Attendance System by Real-Time Face Detection

• Powered by Python, Django, and OpenCV.

OS support: Windows10 or Linux.

• Some commands may differ depending on OS. Just google it.

Instructions:

• Install latest version of Python
• Install and active virtual environment directory
  1. Open cmd
  2. pip install virtualenv
  3. Choose destination: cd Desktop> virtualenv YourEnvironmentName
  4. cd YourEnvironmentName\Scripts>activate
  5. cd.. (exit from Scripts)
• Clone this GitHub repository into your local virtual environment directory (YourEnvironmentName)
• Go to project directory (GitHub repository) where 'manage.py' file exist
• Install all the requirements using previously opened cmd where the virtual environment was activated:
  1. pip install -r requirements.txt
• Run local server:
  1. python manage.py runserver

Type those URLs to the browser:

• API: http://127.0.0.1:8000/matched-user/galib/ (API takes any username for: /galib/)
• EAS Admin dashboard: http://127.0.0.1:8000/admin/
• Manual input: http://127.0.0.1:8000/user/input/
• Single object: http://127.0.0.1:8000/user/single-user/galib/ (takes any username for: /galib/)
• All objects: http://127.0.0.1:8000/user/all-users/

Run OpenCV Face Detection:

• Go to project directory (GitHub repository) where 'manage.py' file exist
• Go to openCV_face_recognition directory
• Open cmd here
• Type and Hit Enter:
  1. python facerecognition.py

Open both CMD (local server and face recognition) and API dashboard to monitoring the outputs

• status code 201 = Attendance created
• status code 200 = Attendance already exists
• status code 404 = ERROR

Server cmd output

OpenCV cmd output

EAS Admin dashboard

API dashboard

API JSON

Manual Input from browser (http://127.0.0.1:8000/user/input/)

Verification matched for single object

Single object by URL (http://127.0.0.1:8000/user/single-user/galib/)

All objects by URL (http://127.0.0.1:8000/user/all-users/)