https://github.com/lehoangduc/face-recognition-api
⭐️Facial Recognition API made easy
https://github.com/lehoangduc/face-recognition-api
face-recognition hapijs machine-learning nodejs python service zeromq zerorpc
Last synced: 6 months ago
JSON representation
⭐️Facial Recognition API made easy
- Host: GitHub
- URL: https://github.com/lehoangduc/face-recognition-api
- Owner: lehoangduc
- License: mit
- Created: 2017-03-17T18:05:57.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-03-20T07:07:26.000Z (over 8 years ago)
- Last Synced: 2025-03-23T06:41:22.689Z (7 months ago)
- Topics: face-recognition, hapijs, machine-learning, nodejs, python, service, zeromq, zerorpc
- Language: JavaScript
- Homepage:
- Size: 140 KB
- Stars: 68
- Watchers: 9
- Forks: 14
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Face Recognition API
======
> An Open-source built on top of Python and NodeJs that lets you build your own Face Recognition API
## Requiments
- Python3
- NodeJs >= 7.0.0
- [Face Recognition Python module](https://github.com/ageitgey/face_recognition)
- [zeromq](http://zeromq.org)
- [zerorpc](http://www.zerorpc.io)
## Installation
```bash
$ cd api
$ npm install
$ cp .env.example .env
$ pip3 install zerorpc
```
## How It Works
User request an URL <==> NodeJs API (Download image from URL) <==> Python RPC Server (Identify the face from known images)
## Quick Start
* Edit variables in .env file
* Copy person pictures you already know to "examples/images" folder
* Run commands
```bash
# Start RPC server
$ cd rpc
$ python3 server.py -h 127.0.0.1 -p 8001 -d examples/images
# Start NodeJs API service
$ cd api
$ npm start
# Run with example URL
$ curl http://127.0.0.1:8000/find?url=http://media.doanhnghiepvn.vn/Images/thuphuong/2016/11/18/obama.jpg
```
## Contributing
All contributions are welcome to help improve Face Recognition API.
## License
[MIT](http://opensource.org/licenses/MIT)
Copyright (c) 2017-present, Golr