ctrl-gaurav / mark-it

Facial Recognition Attendance System

Mark IT

A Realtime Facial Recognition Attendance System.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

• Table of Contents
• About The Project
• Built With
• Getting Started
  • Prerequisites
  • Installation
• Product Screenshots
• Roadmap
• Contributing
• License
• Contact

About The Project

Built With

• OpenCV
• Face Recognition
• Firebase

Getting Started

To get a local copy up and running follow these simple example steps.

Prerequisites

You will need:

• A webcam
• Visual Studio installed in your PC
• Desktop development with C++ in Visual Studio
• Python
• cmake
• dlib
• OpenCV
• Firebase Account

Installation

1. Make sure you have python3 setup on your system
2. Clone the repo

git clone https://github.com/ctrl-gaurav/Mark-IT.git

3. Create a Virtual Environment

python -m venv env

4. Activate Virtual Environment

.\env\Scripts\activate

5. Install requirements

pip install -r Bare-Minimum-Requirements.txt

6. Create a project in firebase
7. Download config.json file for accessing Cloud Firestore ( make sure language selected is Python )
8. Copy its content to attendance.py config dictionary
9. Copy existing images in Image Database Folder ( there are two images in it for testing purpose if you want you can remove that )
10. Run Attendance.py

python Attendance.py

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

To add your contributions to this project follow these steps :

1. Fork the Project
2. Create your improvements Branch (git checkout -b improvements/myimprovements)
3. Commit your Changes (git commit -m 'Done some Improvements')
4. Push to the Branch (git push origin improvements/myimprovements)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

• Gaurav
  • Insta Handle - @ig_itsgk
  • LinkedIn - Gaurav
    
• Project Link: https://github.com/ctrl-gaurav/Mark-IT