azface.md

MLHub package azface - Face Detection and Recognition

azface is a MLHub package that provides a quick introduction of the Face API of Microsoft Azure's Cognitive Services.

NOTE: The face detection and recognition tasks in azface are carried out via the Face Python SDK (azure-cognitiveservices-vision-face). To use azface, Azure face service should be subscribed and a 7-days free subscription account can be obtained at Try Cognitive Services. In addition, MLHub is a command line tool mainly targeted on Ubuntu, so a Ubuntu machine is needed as well.

Installation

$ pip3 install mlhub             # Install MLHub
$ ml install simonzhaoms/azface  # Install azface
$ ml configure azface            # Configue azface, install required dependencies

Face Detection

The face detection feature can find all faces in a photo and tell the gender, age, emotion of the persons:

$ ml detect azface --key-file key.txt --photo '~/.mlhub/azface/photo/detection'

Face recognition

Face recognition can find similar faces between two photos.

$ ml similar azface --target '~/.mlhub/azface/photo/PersonGroup/Family1-Dad-Bill/Family1-Dad1.jpg' --candidate '~/.mlhub/azface/photo/identification/identification1.jpg'
$ ml similar azface --target '~/.mlhub/azface/photo/identification/identification1.jpg' --candidate '~/.mlhub/azface/photo/PersonGroup/Family1-Dad-Bill/'