Python SDK for the Cognitive Face API
Microsoft Face API: Python SDK & Sample
This SDK has been deprecated and been replaced by Microsoft.Azure.CognitiveServices.Vision.Face which is a part of Azure SDK.
This repo contains the Python SDK for the Microsoft Face API, an offering within Microsoft Cognitive Services, formerly known as Project Oxford.
Install the module using pip:
pip install cognitive_face
import cognitive_face as CF KEY = 'subscription key' # Replace with a valid Subscription Key here. CF.Key.set(KEY) BASE_URL = 'https://westus.api.cognitive.microsoft.com/face/v1.0/' # Replace with your regional Base URL CF.BaseUrl.set(BASE_URL) img_url = 'https://raw.githubusercontent.com/Microsoft/Cognitive-Face-Windows/master/Data/detection1.jpg' result = CF.face.detect(img_url) print result
Installing from the source code
python setup.py install
Running the unit tests
To run the tests you will need a valid subscription. You can get one here.
- Change the
BASE_URLparameters to your own subscription's API key and endpoint.
- Run the following:
python setup.py test
Running the sample
A sample desktop application is also provided.
Currently it support the following combination of prerequisites:
P.S. WxPython 3 does not support Python 3 by design.
Then run the following:
git clone https://github.com/Microsoft/Cognitive-Face-Python.git cd Cognitive-Face-Python pip install -r requirements.txt python sample
We welcome contributions. Feel free to file issues and pull requests on the repo and we'll address them as we can. Learn more about how you can help on our Contribution Rules & Guidelines.
You can reach out to us anytime with questions and suggestions using our communities below:
All Microsoft Cognitive Services SDKs and samples are licensed with the MIT License. For more details, see LICENSE.
Sample images are licensed separately, please refer to LICENSE-IMAGE.
Developer Code of Conduct
Developers using Cognitive Services, including this sample, are expected to follow the “Developer Code of Conduct for Microsoft Cognitive Services”, found at http://go.microsoft.com/fwlink/?LinkId=698895.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size cognitive_face-1.5.0-py3-none-any.whl (30.9 kB)||File type Wheel||Python version py3||Upload date||Hashes View|
|Filename, size cognitive_face-1.5.0.tar.gz (18.8 kB)||File type Source||Python version None||Upload date||Hashes View|
Hashes for cognitive_face-1.5.0-py3-none-any.whl