Facerec - Linux Face Unlock

Facerec is a face authentication system for Ubuntu Linux that works while logging in, running "sudo" commands, etc. with a user-friendly CLI to operate it.

Installation

Using PPA

1. Update Sources

sudo apt update

2. add PPA to your machine

sudo add-apt-repository ppa:rushabh-v/facerec

3. Install Facerec

sudo apt install facerec

4. Source bashrc

source ~/.bashrc

Using deb package

1. Download the deb package

wget https://github.com/rushabh-v/linux_face_unlock/releases/download/v1.1/facerec_1.1_all.deb

2. Install all the dependencies

sudo apt install -y python3-pip python3-opencv python3-setuptools python-execnet cmake libatlas-base-dev build-essential

3. Install the deb package using

sudo dpkg -i facerec_1.1_all.deb

4. Source bashrc

source ~/.bashrc

NOTE: The deb package won't receive updates automatically. The PPA method is more preferable.

Command Line Interface

Try using the tab compeletions. It is one of the trivial features I am extra proud of :joy:

Contributions Welcome

• Bug reports, Feature requests and PRs will be highly appreciated.
• Dockerfile for the testing environment can be found here. (Will soon upload the image to docker hub)
• Currently, facerec is only supported on Ubuntu. Adding support for other distros is on the list of major future plans.

Troubleshoot

• If you don't have root access. Go to recovery mode as root and run,

facerec remove