skip to navigation
skip to content

cognitive-face-latest 1.2.1

Python SDK for the Cognitive Face API

# Microsoft Face API: Python SDK
This repo contains the Python SDK for the Microsoft Face API, an offering within [Microsoft Cognitive Services]( formerly known as Project Oxford.

* [Learn about the Face API](
* [Read the documentation](
* [Find more SDKs & Samples](

## Installation

pip install cognitive_face

## Installation from Source Code

python install

## Unittests

Before running unittests, please refer to the [/cognitive_face/tests/](/cognitive_face/tests/ and set proper configuration with valid [Subscription Key]( to make the unittests work.

python test

## Minimal Usage

import cognitive_face as CF

KEY = 'subscription key' # Replace with a valid Subscription Key here.

img_url = ''
result = CF.face.detect(img_url)
print result

## Sample

A Python SDK sample built with wxPython is also provided, before execution,
please install all components listed below.

### Sample Prerequisite

- [Python 2.7]( (only Python 2 supported due
to limitation of wxPython)
- [wxPython](
- [cognitive_face package](

### Sample Execution

git clone
cd Cognitive-Face-Python
python sample

## Contributing
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:
- **Support questions:** [StackOverflow](<https:"" questions="" tagged="" microsoft-cognitive="">)
- **Feedback & feature requests:** [Cognitive Services UserVoice Forum](<https:"">)

This project has adopted the [Microsoft Open Source Code of Conduct]( For more information see the [Code of Conduct FAQ]( or contact []( with any additional questions or comments.

## Updates
* 8/2016: Sample updated for [July 2016 Face API changes](

## License
All Microsoft Cognitive Services SDKs and samples are licensed with the MIT License. For more details, see

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 [](

File Type Py Version Uploaded on Size
cognitive_face_latest-1.2.1-py2-none-any.whl (md5, pgp) Python Wheel py2 2017-02-06 19KB
cognitive_face_latest-1.2.1.tar.gz (md5, pgp) Source 2017-02-06 14KB