{"id":15904764,"url":"https://github.com/ayulockin/humain_faceless","last_synced_at":"2026-04-16T05:34:07.264Z","repository":{"id":109751036,"uuid":"202986137","full_name":"ayulockin/humAIn_FaceLess","owner":"ayulockin","description":"Detect faces in an image and give prediction about the age, ethnicity and emotion of that face. ","archived":false,"fork":false,"pushed_at":"2019-09-24T06:12:32.000Z","size":92894,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-10-06T12:42:03.567Z","etag":null,"topics":["deeplearning","face-detection","image-processing","keras","mtcnn-face-detection","multiclass-classification","multilabel-classification","opencv","tensorflow"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ayulockin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-08-18T09:54:06.000Z","updated_at":"2019-12-20T21:42:20.000Z","dependencies_parsed_at":"2023-03-24T08:31:10.701Z","dependency_job_id":null,"html_url":"https://github.com/ayulockin/humAIn_FaceLess","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ayulockin/humAIn_FaceLess","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayulockin%2FhumAIn_FaceLess","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayulockin%2FhumAIn_FaceLess/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayulockin%2FhumAIn_FaceLess/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayulockin%2FhumAIn_FaceLess/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ayulockin","download_url":"https://codeload.github.com/ayulockin/humAIn_FaceLess/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayulockin%2FhumAIn_FaceLess/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31872655,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"online","status_checked_at":"2026-04-16T02:00:06.042Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["deeplearning","face-detection","image-processing","keras","mtcnn-face-detection","multiclass-classification","multilabel-classification","opencv","tensorflow"],"created_at":"2024-10-06T12:41:51.303Z","updated_at":"2026-04-16T05:34:07.246Z","avatar_url":"https://github.com/ayulockin.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# humAIn_FaceLess\n\n## Installations\n\nSince git LFS wasn't used huge files weren't provided along with this repository. Thus follow these steps to access all the functionality provided with this repository. \n\n### Download Images\n\n1. Clone this repository to you local system.\n\n2. The dataset provided by the HumAIn team is in `JSON` format. The same can be found in the `datasets` dir. I have added a parent key named `data`so to the provided data. If you have a test dataset in `JSON` and want to use the same for evaluation make sure to add this parent key.\n\n3. To download images open `command prompt` or `terminal`in the root of the cloned repository. \n\n   ```bash\n   python data_download.py -d datasets/Face_Recognition.json\n   ```\n\n4. To create a cleaner `json` file with annotations.\n\n   ```\n   python data_download.py -d datasets/Face_Recognition.json -n True\n   ```\n\n### Download Weights\n\nDownload my trained model `weight files` from [here](https://drive.google.com/drive/folders/15YPWuZU17Tp6oi2i5vdUlxt26HKiKqyp?usp=sharing). The files should be in this relative path: `face_detector\\weights`\n\n### Download Additional Dataset (Optional)\n\n1. In order to train my model for Age, Gender and Ethnicity prediction, I have used [UTKFace](https://susanqq.github.io/UTKFace/) dataset along side the data provided.\n\n2. In order to train my model for Emotion prediction I have used the dataset from [this](https://www.kaggle.com/c/challenges-in-representation-learning-facial-expression-recognition-challenge/data ) Kaggle competition.\n\n   You can run `prepareUTKFaceData.py`(Optional)\n\n   ```bash\n   python prepareUTKFaceData.py -d path_to_downloaded_UTKFace_dataset\n   ```\n\n   This will create a `face_dataset.csv` dataset along with a directory in the root named `UTKFaceimages`. The `face_dataset.csv` contains `image_id, age, gender, ethnicity` as input image name along with class label. The `UTKFaceimages` directory contain images with `image_id`. This renaming of file is done as a part of data preprocessing which makes it easier while preparing data for training. \n\n## USAGE\n\nGo to the root of this repository and open command prompt or in your terminal run `main.py` script. You need to specify the path to the test image. \n\n```bash\npython main.py -i examples/example1.jpeg\n```\n\nIf you want to see the bounding box detected you can run this. \n\n```bash\npython main.py -i examples/example1.jpeg -b True\n```\n\nThis will do the following:\n\n1. Will import all the packages.\n2. Will build the model and load weights. This may take some time in the first time. \n3. With the given input image run the inference through Face Detector. This will output bounding boxes of the detected faces.\n4. It will use this output and crop the faces from the input image which will be the input to three parallel detectors. \n5. The result of the detector will be printed on the terminal.\n\nYou can find few other example images to test with. \n\n# Model\n\n![architecture](examples/humAIn-Faceless.png)\n\n\n\n\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fayulockin%2Fhumain_faceless","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fayulockin%2Fhumain_faceless","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fayulockin%2Fhumain_faceless/lists"}