Attendance system

<h1 align="center">Attendance System using Face Recognition</h1> <a href="https://github.com/codeglitchz/attendance-system/blob/master/LICENSE" target="_blank"> <img alt="License: MIT" src="https://img.shields.io/github/license/codeglitchz/attendance-system" /> </a> <a href="https://github.com/codeglitchz/attendance-system/releases/tag/v2.1.1" target="_blank"> <img alt="Version" src="https://img.shields.io/badge/version-v2.1.1-blue.svg?cacheSeconds=2592000" /> </a>

A simple, modern and scalable facial recognition based attendance system
built with Python back-end & Angular front-end.

Watch Demonstration Video

Table of contents

• Prerequisites
• Installation
  1. Setup backend
  2. Setup frontend
• Usage
  a. Using CLI
  b. Using Web Interface

Prerequisites

• Windows or Linux (macOS not officially supported, but might work)
• Nvidia CUDA (optional - for nvidia gpus)
• CMake
• Visual Studio Build Tools
• Miniconda for Python v3.7+
• Node.js LTS v12.8.3+ (npm v6.14.6+)
• Angular CLI v10.1.2+

Installation

1. Setup backend

Install all dependencies using conda package manager

Note: This will install the dependencies listed in environments.yml file

shCopy
$ cd backend
$ conda env create -f environment.yml

Now you can activate this environment using the following command

Note: You can run the app only if this environment is activated

shCopy
$ conda activate attendance-system

2. Setup frontend

Install all dependencies using npm package manager

Note: This will install the dependencies listed in package.json file

shCopy
$ cd frontend
$ npm install

Usage

A. Using CLI

Follow these steps to run the app in command line interface mode

• Activate the attendance-system conda environment
• Launch run_cli.py from the backend directory

shCopy
$ cd backend
$ conda activate attendance-system
$ python run_cli.py

B. Using Web Interface

Start the Flask Web Server

• Rename .env.example file to .env
• Activate the attendance-system conda environment
• Launch run.py from the backend directory

Note: This will start a flask web server listening on http://localhost:5000

shCopy
$ cd backend
$ conda activate attendance-system
$ python run.py

Launch the Angular Web Application

Note: This will launch angular web app in browser @ http://localhost:4200

shCopy
$ cd frontend
$ ng serve -o

🤝 Contributing

Contributions, issues and feature requests are welcome!<br />Feel free to check issues page.

Show your support

Give a ⭐️ if this project helped you!