{ "info": { "author": "Microsoft", "author_email": "", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Topic :: Scientific/Engineering :: Image Recognition" ], "description": "# Microsoft Face API: Python SDK & Sample\n\n[![PyPi Version](https://img.shields.io/pypi/v/cognitive_face.svg)](https://pypi.org/project/cognitive_face/)\n[![License](https://img.shields.io/pypi/l/cognitive_face.svg)](https://github.com/Microsoft/Cognitive-Face-Python/blob/master/LICENSE)\n\nThis SDK has been deprecated and been replaced by\u00a0[Microsoft.Azure.CognitiveServices.Vision.Face](https://github.com/Azure/azure-sdk-for-python/tree/master/azure-cognitiveservices-vision-face)\u00a0which is a part of Azure SDK.\n\nThis repo contains the Python SDK for the Microsoft Face API, an offering within [Microsoft Cognitive Services](https://azure.microsoft.com/en-us/services/cognitive-services/), formerly known as Project Oxford.\n\n* [Learn about the Face API](https://azure.microsoft.com/en-us/services/cognitive-services/face/)\n* [Documentation & API Reference & SDKs](https://docs.microsoft.com/en-us/azure/cognitive-services/face/)\n\n## Getting started\n\nInstall the module using [pip](https://pypi.python.org/pypi/pip/):\n\n```bash\npip install cognitive_face\n```\n\nUse it:\n\n```python\nimport cognitive_face as CF\n\nKEY = 'subscription key' # Replace with a valid Subscription Key here.\nCF.Key.set(KEY)\n\nBASE_URL = 'https://westus.api.cognitive.microsoft.com/face/v1.0/' # Replace with your regional Base URL\nCF.BaseUrl.set(BASE_URL)\n\nimg_url = 'https://raw.githubusercontent.com/Microsoft/Cognitive-Face-Windows/master/Data/detection1.jpg'\nresult = CF.face.detect(img_url)\nprint result\n```\n\n### Installing from the source code\n\n```bash\npython setup.py install\n```\n\n### Running the unit tests\n\nTo run the tests you will need a valid subscription. You can get one [here](https://azure.microsoft.com/en-us/try/cognitive-services/?api=face-api).\n\n1. Copy `cognitive_face/tests/config.sample.py` into `cognitive_face/tests/config.py`.\n1. Change the `KEY` and `BASE_URL` parameters to your own subscription's API key and endpoint.\n1. Run the following:\n\n```bash\npython setup.py test\n```\n\n## Running the sample\n\nA sample desktop application is also provided.\n\nCurrently it support the following combination of prerequisites:\n\n1. [Python 3](https://www.python.org/downloads/) + [wxPython 4](https://pypi.python.org/pypi/wxPython) **[Recommended]**\n1. [Python 2](https://www.python.org/downloads/) + [wxPython 4](https://pypi.python.org/pypi/wxPython)\n1. [Python 2](https://www.python.org/downloads/) + [wxPython 3](https://sourceforge.net/projects/wxpython/files/wxPython/3.0.2.0/)\n\nP.S. WxPython 3 does not support Python 3 by design.\n\nThen run the following:\n\n```bash\ngit clone https://github.com/Microsoft/Cognitive-Face-Python.git\ncd Cognitive-Face-Python\npip install -r requirements.txt\npython sample\n```\n\n![Sample app](./Assets/sample_screenshot.png)\n\n\n## Contributing\n\nWe 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).\n\nYou can reach out to us anytime with questions and suggestions using our communities below:\n - **Support questions:** [StackOverflow](https://stackoverflow.com/questions/tagged/microsoft-cognitive)\n - **Feedback & feature requests:** [Cognitive Services UserVoice Forum](https://cognitive.uservoice.com)\n\nThis 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.\n\n## Updates\n* [Face API Release Notes](https://docs.microsoft.com/en-us/azure/cognitive-services/face/releasenotes)\n\n## License\nAll Microsoft Cognitive Services SDKs and samples are licensed with the MIT License. For more details, see\n[LICENSE](/LICENSE.md).\n\nSample images are licensed separately, please refer to [LICENSE-IMAGE](/LICENSE-IMAGE.md).\n\n## Developer Code of Conduct\nDevelopers using Cognitive Services, including this sample, are expected to follow the \u201cDeveloper Code of Conduct for Microsoft Cognitive Services\u201d, found at [http://go.microsoft.com/fwlink/?LinkId=698895](http://go.microsoft.com/fwlink/?LinkId=698895).\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/Microsoft/Cognitive-Face-Python", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "cognitive-face", "package_url": "https://pypi.org/project/cognitive-face/", "platform": "", "project_url": "https://pypi.org/project/cognitive-face/", "project_urls": { "Homepage": "https://github.com/Microsoft/Cognitive-Face-Python" }, "release_url": "https://pypi.org/project/cognitive-face/1.5.0/", "requires_dist": [ "requests" ], "requires_python": "", "summary": "Python SDK for the Cognitive Face API", "version": "1.5.0" }, "last_serial": 5236457, "releases": { "0.1": [], "1.2.0": [], "1.2.1": [ { "comment_text": "", "digests": { "md5": "8bba73308815d447f67ae74e39205995", "sha256": "3c0473b25482cea602ade56db2fc7d554c7994958c2b746c65d054ae7525dd44" }, "downloads": -1, "filename": "cognitive_face-1.2.1.tar.gz", "has_sig": false, "md5_digest": "8bba73308815d447f67ae74e39205995", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14976, "upload_time": "2016-09-12T06:53:57", "url": "https://files.pythonhosted.org/packages/bc/71/d39364b9bef2534a8cdcc612cc32644a20f6a499e835bf8fd57ba13e821d/cognitive_face-1.2.1.tar.gz" } ], "1.2.5": [ { "comment_text": "", "digests": { "md5": "44ce67cfab6c92b4a219e94eae81071e", "sha256": "5cdc90e125ab3081050b4f441086624ff9827fb91de19f5b698393204dd4b9ea" }, "downloads": -1, "filename": "cognitive_face-1.2.5.tar.gz", "has_sig": false, "md5_digest": "44ce67cfab6c92b4a219e94eae81071e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14936, "upload_time": "2017-03-18T09:57:16", "url": "https://files.pythonhosted.org/packages/05/bb/27fd2c943aaf28c583aa1608be6126bfe6c4b4a63f9f6d3bea9a0bb1554e/cognitive_face-1.2.5.tar.gz" } ], "1.3.0": [ { "comment_text": "", "digests": { "md5": "f8c38d2ff67697bb43085cbc010bdca0", "sha256": "4fb7f2b6e275dff90344ad74c7eb9d0ac4af1288ea5e911d0678dc62381d6e88" }, "downloads": -1, "filename": "cognitive_face-1.3.0.tar.gz", "has_sig": false, "md5_digest": "f8c38d2ff67697bb43085cbc010bdca0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 15045, "upload_time": "2017-05-06T09:50:15", "url": "https://files.pythonhosted.org/packages/a5/7d/9981939cf1eb839510d44cd2c05b5a0f53957c74c7cac2f3a2f0d4566daf/cognitive_face-1.3.0.tar.gz" } ], "1.3.1": [ { "comment_text": "", "digests": { "md5": "ea137e0eb71e03b799814ea7b1ada887", "sha256": "26c14dcdecc700a502549ffb57cbd25489e114f25f832b788c0f512fbdf2f2c1" }, "downloads": -1, "filename": "cognitive_face-1.3.1.tar.gz", "has_sig": false, "md5_digest": "ea137e0eb71e03b799814ea7b1ada887", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 15211, "upload_time": "2017-05-17T11:35:54", "url": "https://files.pythonhosted.org/packages/f6/ba/c8e87c3c96322a3f6715137c630c44d2a1c0c1e53e79955cd5ce70a05a89/cognitive_face-1.3.1.tar.gz" } ], "1.4.0": [ { "comment_text": "", "digests": { "md5": "ea410f9e6fbc8c19dcd1f81133404166", "sha256": "d1683201873535dd17719aeee0e4cd932d23e3e66f773a94ba1b52b37b5c7cc5" }, "downloads": -1, "filename": "cognitive_face-1.4.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "ea410f9e6fbc8c19dcd1f81133404166", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 31509, "upload_time": "2018-02-28T05:02:37", "url": "https://files.pythonhosted.org/packages/ee/e1/78c5f991d3d9f742f49e79b03f7d5b5c5a93c8b0caa163094584f12698c2/cognitive_face-1.4.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ecabf530cd3ff10b496b1ab3623bc84d", "sha256": "4c58b83a2c969ce2fa91c9957a2c39be0a42bf4af3941869a5850dc4835d9607" }, "downloads": -1, "filename": "cognitive_face-1.4.0.tar.gz", "has_sig": false, "md5_digest": "ecabf530cd3ff10b496b1ab3623bc84d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18934, "upload_time": "2018-02-28T05:02:39", "url": "https://files.pythonhosted.org/packages/97/03/dca1ad7080ff9aaa4c8354ea64ef16a4dc8f9cadc1c43c66d7fe093ed674/cognitive_face-1.4.0.tar.gz" } ], "1.4.1": [ { "comment_text": "", "digests": { "md5": "ed74aaab66b9924e6babb46c7255ff40", "sha256": "8a1e533132795533785af71e793030ffd3e69c69c31c5e8c3e6a44b4053fad7c" }, "downloads": -1, "filename": "cognitive_face-1.4.1-py3-none-any.whl", "has_sig": false, "md5_digest": "ed74aaab66b9924e6babb46c7255ff40", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 31283, "upload_time": "2018-03-07T07:48:19", "url": "https://files.pythonhosted.org/packages/6b/ac/97914d727556d92f4377214811332b3bf2608fc6f9c75c5ae0442090e7df/cognitive_face-1.4.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "bc0c548f4fa346ec49a8415886bdbd0b", "sha256": "be37590a3701125e04351aa09a93b6f43c113ef24fab4b7fa61511f4e900fda8" }, "downloads": -1, "filename": "cognitive_face-1.4.1.tar.gz", "has_sig": false, "md5_digest": "bc0c548f4fa346ec49a8415886bdbd0b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18473, "upload_time": "2018-03-07T07:48:21", "url": "https://files.pythonhosted.org/packages/6d/20/0ad1933a7209e71bd5b398af6f9b25c86cbc9d0a10f78e1ed5d839f054ce/cognitive_face-1.4.1.tar.gz" } ], "1.4.2": [ { "comment_text": "", "digests": { "md5": "9a1c244c8de8b219a6ef285c64cb073f", "sha256": "84209d1cf6a28c4676e734569254c1b3924df008483f3b376befd1c5939f4bf2" }, "downloads": -1, "filename": "cognitive_face-1.4.2-py3-none-any.whl", "has_sig": false, "md5_digest": "9a1c244c8de8b219a6ef285c64cb073f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 29039, "upload_time": "2018-07-24T02:47:46", "url": "https://files.pythonhosted.org/packages/36/e6/7866600bf9155c593dff642de8e940ed544727582a6d4f62f06c90089c90/cognitive_face-1.4.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "c3782d171e279a755bb7e3fa424dcb72", "sha256": "408cca9fc551cbfc632b38c2af2804486a1d581cd67956b61504d41ebe070f72" }, "downloads": -1, "filename": "cognitive_face-1.4.2.tar.gz", "has_sig": false, "md5_digest": "c3782d171e279a755bb7e3fa424dcb72", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18909, "upload_time": "2018-07-24T02:47:47", "url": "https://files.pythonhosted.org/packages/57/33/2120dc2e0d0b80dc835ecd70d5065221c321031ed3216bb6cdb5c4643b77/cognitive_face-1.4.2.tar.gz" } ], "1.5.0": [ { "comment_text": "", "digests": { "md5": "8275125937cf89fc418382bba222a36e", "sha256": "e486e78000288fbb00c2ccd42e0d1e09ba1a63fe9c78497d7b1d88b49d41828a" }, "downloads": -1, "filename": "cognitive_face-1.5.0-py3-none-any.whl", "has_sig": false, "md5_digest": "8275125937cf89fc418382bba222a36e", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 30927, "upload_time": "2019-05-07T07:17:55", "url": "https://files.pythonhosted.org/packages/59/16/d332bf7de96d651e9f83dfe15c2b7e2bf47beea73b72f9aa1d35884e3fcb/cognitive_face-1.5.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "af62affc257a4f2e51d361e5d6ce221c", "sha256": "ef4fd24cdfa21ba24320a80dedfa8bbe283350b51db36aa9fbb924d69595bb73" }, "downloads": -1, "filename": "cognitive_face-1.5.0.tar.gz", "has_sig": false, "md5_digest": "af62affc257a4f2e51d361e5d6ce221c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18781, "upload_time": "2019-05-07T07:17:56", "url": "https://files.pythonhosted.org/packages/84/42/24f0f6a3a93095911fd1444370ce66dc7cc76e4737a9e2bf51d092b8bea9/cognitive_face-1.5.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "8275125937cf89fc418382bba222a36e", "sha256": "e486e78000288fbb00c2ccd42e0d1e09ba1a63fe9c78497d7b1d88b49d41828a" }, "downloads": -1, "filename": "cognitive_face-1.5.0-py3-none-any.whl", "has_sig": false, "md5_digest": "8275125937cf89fc418382bba222a36e", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 30927, "upload_time": "2019-05-07T07:17:55", "url": "https://files.pythonhosted.org/packages/59/16/d332bf7de96d651e9f83dfe15c2b7e2bf47beea73b72f9aa1d35884e3fcb/cognitive_face-1.5.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "af62affc257a4f2e51d361e5d6ce221c", "sha256": "ef4fd24cdfa21ba24320a80dedfa8bbe283350b51db36aa9fbb924d69595bb73" }, "downloads": -1, "filename": "cognitive_face-1.5.0.tar.gz", "has_sig": false, "md5_digest": "af62affc257a4f2e51d361e5d6ce221c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18781, "upload_time": "2019-05-07T07:17:56", "url": "https://files.pythonhosted.org/packages/84/42/24f0f6a3a93095911fd1444370ce66dc7cc76e4737a9e2bf51d092b8bea9/cognitive_face-1.5.0.tar.gz" } ] }