lehoangduc / face-recognition-api

⭐️Facial Recognition API made easy

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
• zeromq
• zerorpc

Installation

$ 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

# 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

Copyright (c) 2017-present, Golr