{"id":16802118,"url":"https://github.com/simonzhaoms/facematch","last_synced_at":"2025-03-17T06:15:31.752Z","repository":{"id":83508944,"uuid":"166968096","full_name":"simonzhaoms/facematch","owner":"simonzhaoms","description":"Simple face recognition","archived":false,"fork":false,"pushed_at":"2019-03-25T09:00:05.000Z","size":1541,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-23T15:45:31.775Z","etag":null,"topics":["computer-vision","face-recognition","mlhub"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/simonzhaoms.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-01-22T09:43:08.000Z","updated_at":"2019-08-08T01:40:23.000Z","dependencies_parsed_at":null,"dependency_job_id":"a2bcd9d5-2763-46f7-96cc-8a2d97e60170","html_url":"https://github.com/simonzhaoms/facematch","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonzhaoms%2Ffacematch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonzhaoms%2Ffacematch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonzhaoms%2Ffacematch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonzhaoms%2Ffacematch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simonzhaoms","download_url":"https://codeload.github.com/simonzhaoms/facematch/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243982292,"owners_count":20378606,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["computer-vision","face-recognition","mlhub"],"created_at":"2024-10-13T09:38:43.376Z","updated_at":"2025-03-17T06:15:31.721Z","avatar_url":"https://github.com/simonzhaoms.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Simple Face Recognition #\n\nThis is a simple face recognition example of using deep learning to\nrecognise faces within a picture.  It originates from Adrian\nRosebrock's article --\n[Face recognition with OpenCV, Python, and deep learning](https://www.pyimagesearch.com/2018/06/18/face-recognition-with-opencv-python-and-deep-learning/).\n\nSee the GitHub repository for examples of its usage:\nhttps://github.com/simonzhaoms/facematch\n\n\n## Usage ##\n\n* To install and demonstrate the algorithm:\n\n  ```console\n  $ pip3 install mlhub\n  $ ml install   facematch\n  $ ml configure facematch\n  $ ml demo      facematch\n  ```\n\n* To recognise an arbitrary person who can be found in the Internet,\n  you can just type:\n  \n  ```console\n  $ ml score facematch\n  ```\n\n  It will use Microsoft Bing image search API to search a person's\n  photo you want to recognise.  In order to use the API, you must have\n  a subcription key.  A 7-days free account can be created at\n  https://azure.microsoft.com/en-us/try/cognitive-services/?api=search-api-v7\n\n* To match you in camera:\n\n  ```console\n  $ ml score facematch --capture --camera\n  ```\n\n  It will open your camera to capture 5 photos of you to generate your\n  face database, then recognise you in a live camera video.\n\n\n* You can also provide the path or URL of a person's photos via option\n  `--data`, and let facematch to recognise him/her in a photo via the\n  option `--match`:\n\n  ```console\n  $ ml score facematch --data \u003cphoto-of-the-person\u003e --match \u003cphoto-for-recognition\u003e\n  ```\n\n   or video via the option `--video`:\n\n  ```console\n  $ ml score facematch --data \u003cphoto-of-the-person\u003e --video \u003cvideo-for-recognition\u003e\n  ```\n\n\n## More details ##\n\n### About collecting photos ###\n\nThe photos used for recognition here are collected by using\n[Bing image search API](https://azure.microsoft.com/en-us/services/cognitive-services/bing-image-search-api/).  The code for collecting photos is adapted from\n[How to (quickly) build a deep learning image dataset](https://www.pyimagesearch.com/2018/04/09/how-to-quickly-build-a-deep-learning-image-dataset/).\n\nIn the interactive mode of `ml score facematch`, a subscription key of\nBing image search API is required.  You can get 7-days free account\ntogether with a subscription key at [Try Microsoft Azure Cognitive\nServices](https://azure.microsoft.com/en-us/try/cognitive-services/?api=search-api-v7).\n\nMore details about how to use Bing image search API can be found at\n* [Bing Image Search API Documentation](https://docs.microsoft.com/en-us/azure/cognitive-services/bing-image-search/)\n* [Quickstart: Search for images using the Bing Image Search REST API and Python](https://docs.microsoft.com/en-us/azure/cognitive-services/bing-image-search/quickstarts/python)\n* [Image Search API v7 reference](https://docs.microsoft.com/en-sg/rest/api/cognitiveservices/bing-images-api-v7-reference)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimonzhaoms%2Ffacematch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimonzhaoms%2Ffacematch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimonzhaoms%2Ffacematch/lists"}