{"id":15931043,"url":"https://github.com/araa47/facerec_api","last_synced_at":"2025-04-03T14:21:15.406Z","repository":{"id":130309567,"uuid":"96757496","full_name":"araa47/facerec_api","owner":"araa47","description":"Simple Python Similarity Engine, over a RESTFUL API ","archived":false,"fork":false,"pushed_at":"2018-07-26T07:54:40.000Z","size":367,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-09T03:15:31.947Z","etag":null,"topics":["face-detection","facerecognition","opencv3","similarity"],"latest_commit_sha":null,"homepage":"","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/araa47.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":"2017-07-10T09:01:58.000Z","updated_at":"2019-02-18T15:41:59.000Z","dependencies_parsed_at":"2023-03-24T01:32:28.497Z","dependency_job_id":null,"html_url":"https://github.com/araa47/facerec_api","commit_stats":{"total_commits":12,"total_committers":2,"mean_commits":6.0,"dds":"0.16666666666666663","last_synced_commit":"1fa268d38b011a9efcda9aa9d7804ae69172f74b"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/araa47%2Ffacerec_api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/araa47%2Ffacerec_api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/araa47%2Ffacerec_api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/araa47%2Ffacerec_api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/araa47","download_url":"https://codeload.github.com/araa47/facerec_api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247014514,"owners_count":20869376,"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":["face-detection","facerecognition","opencv3","similarity"],"created_at":"2024-10-07T01:03:30.530Z","updated_at":"2025-04-03T14:21:15.385Z","avatar_url":"https://github.com/araa47.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"### Updates have been made and the API is currently not compatible with the previous specs, please read throught this readme again to use the latest version of the API\n\n# Face Similiraty Engine (REST API)\n\n##### This project is a simple face similarity api coded in python. The project uses an sqlite3 database to store the images. \n\n\n## Instructions to Use the API \n\n\n##### This API currently only supports 2 different Post Requests. Both requests are described in detail below OR check out the POSTMAN doucmentaton over here for a more detialed explanation + sample code: https://documenter.getpostman.com/view/2317617/facerec/6fU36xE\n\n### Register Face\n\nThis is the post request to be used in order to register a new face with the corresponding filename.\nYou will need to direct your request to the following url:\n```\nhttp://127.0.0.1:5000/register_face/\u003cfilename\u003e\n```\nfilename should be replaced with the name of the file you have uploaded. An example could be the following, please remember to also add the extension of the file:\n```\nhttp://127.0.0.1:5000/register_face/obama.jpg\n```\n\nThe post request also needs to contain the image itself. This can be done using the form-data format where the key is the following string \"image\", and the Value is the image file itself. \n\n#### Example Postman Request and Response\n![Alt text](Facrec_register.png?raw=true \"Example Postman Request and Response:\")\n\n\n### Find Match:\n\nThis is the post request to be used in order to find matches. You will need to use the following url:\n```\nhttp://127.0.0.1:5000/scan_for_match/\u003cfilename\u003e/\u003cpage\u003e\n\n```\nfilename should be replaced with the name of the file you want to find matches from. Page should be replaced by an integer value. 1 is for page 1 results. 2 is for page 2 results and so on. \n\n\n```\nhttp://127.0.0.1:5000/scan_for_match/obama.png/1\n```\n\nThe post request also needs to contain the image itself. This can be done using the form-data format where the key is the following string \"image\", and the Value is the image file itself.\n\n#### Example Postman Request and Response (OUTDATED , (tolerance has been changed to page number), will be updated soon)\n![Alt text](Facerec_match.png?raw=true \"Example Postman Request and Response:\")\n\n\n## Instructions to Host the API \n\n##### Please follow this only if you want to create your own database and host the api on your own server , if you want to use my API. You will need to make sure you have opencv installed on your computer \n\n1) git clone https://github.com/araa47/facerec_api\n\n2) Make sure you have python installed, and also install virtualenv by typing in \n\n```\nsudo pip install virtualenv\n```\n3) Create a new virutalenv \n```\nvirtualenv facerec_api\n```\n4) Activate the virutalenv\n```\nsource facrec_api/bin/activate \n```\n5) cd into the project\n```\ncd facerec_api\n```\n6) Install requirements to virtualenv \n```\npip install -r requirements.txt\n```\n7) Now You need to set up the database. The simplest way would be to comment the lines \n\n```\nif __name__ == '__main__':\n\tapp.run(debug=True)\n```\n\nand run the function initialize(). \n\n8) Now that you have the table created, you are ready to host the API. Simply undo the previous step and remove the call to the initialize function. In order to run the flask API, simply type:\n```\npython face_api.py\n```\n\n9) This should automatically host the API on localhost and you can continue to the next part to start testing ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faraa47%2Ffacerec_api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faraa47%2Ffacerec_api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faraa47%2Ffacerec_api/lists"}