/attendance-system

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

Primary LanguagePythonMIT LicenseMIT

Attendance System using Face Recognition

License: MIT Version

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

Install all dependencies using conda package manager

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

$ 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

$ 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

$ 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
$ cd backend
$ conda activate attendance-system
$ python run_cli.py

cli_snip

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

$ 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

$ cd frontend
$ ng serve -o

web_snip

🤝 Contributing

Contributions, issues and feature requests are welcome!
Feel free to check issues page.

Show your support

Give a ⭐️ if this project helped you!