https://github.com/deven96/face_verify
Facial verification
https://github.com/deven96/face_verify
artificial-intelligence database facial-detection python verification
Last synced: about 2 months ago
JSON representation
Facial verification
- Host: GitHub
- URL: https://github.com/deven96/face_verify
- Owner: deven96
- License: mit
- Created: 2019-01-25T05:00:41.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2019-01-26T02:28:48.000Z (over 6 years ago)
- Last Synced: 2025-03-24T04:02:04.909Z (about 2 months ago)
- Topics: artificial-intelligence, database, facial-detection, python, verification
- Language: Python
- Size: 314 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Face Verify
Upload images to database and compare live video feed to existing images.
This project is to ultimately run as a standalone software for facial verification
[](https://travis-ci.com/deven96/face_verify)[](https://opensource.org/licenses/MIT)
- [Face Verify](#face-verify)
- [Getting Started](#getting-started)
- [Usage](#usage)
- [Upload](#upload)
- [Verification](#verification)
- [API Documentation](#api-documentation)
- [Credits](#credits)
- [Contribution](#contribution)
- [License (MIT)](#license-mit)
- [Todo](#todo)
## Getting Started
Before setting up virtualenv, get the following aptitude packages, as they are necessary for the python requirements to function
```bash
sudo apt-get install libboost-python-dev cmake
```
Setup Virtual environment and install requirements
```bash
mkvirtualenv face-verify && pip install -r requirements
```
## Usage
Currently only usable as python code or command line
### Upload
To upload an image to the database
```bash
python main.py upload --name "Firstname Lastname"
```
```python
from handlers import Uploader
uploader = Uploader(name="Firstname Lastname")
uploader.run()
```
### Verification
To run verification on images existing in the database
```bash
python main.py verify
```
```python
from handlers import Verifier
verifiier = Verifier()
verifier.run()
```
## API Documentation
[Github Pages](https://deven96.github.io/face_verify)
## Credits
- [Dlib](https://dlib.net)
- [Face_recognition](https://face-recognition.readthedocs.io/en/latest/face_recognition.html)
- [OpenCV](https://opencv-python-tutroals.readthedocs.io/en/latest/)
## Contribution
You are very welcome to modify and use them in your own projects.
Please keep a link to the [original repository](https://github.com/deven96/face_verify). If you have made a fork with substantial modifications that you feel may be useful, then please [open a new issue on GitHub](https://github.com/deven96/face_verify/issues) with a link and short description.
## License (MIT)
This project is opened under the [MIT 2.0 License](LICENSE) which allows very broad use for both academic and commercial purposes.
A few of the images used for demonstration purposes may be under copyright. These images are included under the "fair usage" laws.
## Todo
- Initialize GUI project
- Switch from folder to persistent database handling
- Multiple camera input attachment across local network
- Make into standard python package
- Integrate CI/CD for automatically pushing latest releases to PyPI
- Write unittests for package
- Use Cython for pre and post processing activities (targeted at speeding up the process)