Metadata-Version: 1.1
Name: cognitive_face
Version: 1.2.1
Summary: Python SDK for the Cognitive Face API
Home-page: https://github.com/Microsoft/Cognitive-Face-Python
Author: Microsoft
Author-email: UNKNOWN
License: MIT
Description: # Microsoft Face API: Python SDK
        This repo contains the Python SDK for the Microsoft Face API, an offering within [Microsoft Cognitive Services](https://www.microsoft.com/cognitive-services), formerly known as Project Oxford.
        
        * [Learn about the Face API](https://www.microsoft.com/cognitive-services/en-us/face-api)
        * [Read the documentation](https://www.microsoft.com/cognitive-services/en-us/face-api/documentation/overview)
        * [Find more SDKs & Samples](https://www.microsoft.com/cognitive-services/en-us/SDK-Sample?api=face)
        
        ## Installation
        
        ```bash
        pip install cognitive_face
        ```
        
        ## Installation from Source Code
        
        ```bash
        python setup.py install
        ```
        
        ## Unittests
        
        Before running unittests, please refer to the [/cognitive_face/tests/config.sample.py](/cognitive_face/tests/config.sample.py) and set proper configuration with valid [Subscription Key](https://www.microsoft.com/cognitive-services/en-us/sign-up) to make the unittests work.
        
        ```bash
        python setup.py test
        ```
        
        ## Minimal Usage
        
        ```python
        import cognitive_face as CF
        
        KEY = 'subscription key'  # Replace with a valid Subscription Key here.
        CF.Key.set(KEY)
        
        img_url = 'https://raw.githubusercontent.com/Microsoft/Cognitive-Face-Windows/master/Data/detection1.jpg'
        result = cf.face.detect(url)
        print result
        ```
        
        ## TODO
        
        - More robust unittests (Only test the most basic functionality currently).
        - Add native support for json response by adding some models like `Face`, `FaceList`, `Person` and `PersonGroup`.
        
        # Microsoft Face API: Jupyter Notebook
         This [Jupyter Notebook](<http://jupyter.org/>) demonstrates how to use Python with the Microsoft Face API, an offering within [Microsoft Cognitive Services](https://www.microsoft.com/cognitive-services), formerly known as Project Oxford.
         * [Learn about the Face API](https://www.microsoft.com/cognitive-services/en-us/face-api)
         * [Read the documentation](https://www.microsoft.com/cognitive-services/en-us/face-api/documentation/overview)
         * [Find more SDKs & Samples](https://www.microsoft.com/cognitive-services/en-us/SDK-Sample?api=face)
        
        
        
        ## 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](</CONTRIBUTING.md>). 
        
        You can reach out to us anytime with questions and suggestions using our communities below:
         - **Support questions:** [StackOverflow](<https://stackoverflow.com/questions/tagged/microsoft-cognitive>)
         - **Feedback & feature requests:** [Cognitive Services UserVoice Forum](<https://cognitive.uservoice.com>)
        
        This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
        
        ## Updates
        * 8/2016: Sample updated for [July 2016 Face API changes](https://www.microsoft.com/cognitive-services/en-us/face-api/documentation/overview#changes)
        
        ## License
        All Microsoft Cognitive Services SDKs and samples are licensed with the MIT License. For more details, see
        [LICENSE](</LICENSE.md>).
        
        Sample images are licensed separately, please refer to [LICENSE-IMAGE](</LICENSE-IMAGE.md>)
        
        
        ## 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](http://go.microsoft.com/fwlink/?LinkId=698895).
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Image Recognition
