Microsoft Azure SDK for Python


Face service access is limited based on eligibility and usage criteria in order to support our Responsible AI principles. Face service is only available to Microsoft managed customers and partners. Use the Face Recognition intake form to apply for access. For more information, see the Face limited access page.


Microsoft will be retiring facial recognition capabilities that can be used to try to infer emotional states and identity attributes which, if misused, can subject people to stereotyping, discrimination or unfair denial of services. These include capabilities that predict emotion, gender, age, smile, facial hair, hair and makeup. Existing customers have until June 30, 2023 to discontinue use of these capabilities before they are retired. Read more about this decision in the announcement post.

This is the Microsoft Azure Cognitive Services Face Client Library. This package has been tested with Python 2.7, 3.5, 3.6, 3.7 and 3.8. For a more complete view of Azure libraries, see the azure sdk python release.


After installing Python, you can install the client library with:

pip install --upgrade azure-cognitiveservices-vision-face

For code examples, see Cognitive Services Face on

Next Steps

Go to the Face service Overview or follow a quickstart to get started.

Provide Feedback

If you encounter any bugs or have suggestions, please file an issue in the Issues section of the project.