faceattend 0.0.2

An attendance system using face recognition

Face Attend

An attendance system using face detection

Features

• Adding face data of a person to the database
• Detect face of known person using video feed
• Mark attendance of a valid person when detected
• Generating a csv file with attendance for a particalar date

Instructions 📝

• Create a virtual environment: python3 -m venv .venv
• Activate the virtual environment: source .venv/bin/activate
• Install the package: pip install faceattend

[!NOTE] The above instructions are specific to macOS and Linux.

Windows specific instructions

• Creating virtual environments see here
  
• For issues with installation of the face-recognition package see here

Database setup 🛢

Create the database

• Open the python interactive console
  python3 or python

• Import the create_database() function from create_database module
  from faceattend.create_datebase import create_database

• Then just use the create_database() function to create the database create_database()

• When database is successfully created it displays
  Database created!

Add valid faces in database

• Open the python interactive console
  python3 or python

• Import the Face class from face module
  from faceattend.face import Face

• Now use the Face class's add_face method to add face data and name of the person
  Face.add_face("Person's Name","Path to the Person's image file")

• If the face was added successfully it displays
  Face Added

Generating CSV file

For a particular date

• Import the Attendance class from attendance module
  from faceattend.attendance import Attendance
• Now use Attendance class's generate_csv_date() function Attendance.generate_csv_date("sample_date")

For a particular employee

• Use Attendance class's generate_csv_emp() function Attendance.generate_csv_date("emp_id")

If CSV file was generated it displays

CSV file generated!

How to run?

python3 detect.py or python detect.py