{"id":14977945,"url":"https://github.com/bmalbusca/facialrecognition_rmsf","last_synced_at":"2025-10-28T07:31:18.279Z","repository":{"id":37628601,"uuid":"245291001","full_name":"bmalbusca/FacialRecognition_RMSF","owner":"bmalbusca","description":"Python + OpenCV + Flutter project: Smart Door Lock with Facial Recognition, Event Detection and Remote Control over mobile App (Flutter)","archived":false,"fork":false,"pushed_at":"2024-05-06T21:05:49.000Z","size":19156,"stargazers_count":18,"open_issues_count":9,"forks_count":6,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-01T12:44:11.392Z","etag":null,"topics":["facial-recognition","flask","flutter","opencv","opencv-python","raspberry-pi-3","raspberry-pi-camera","rest-api","smart-door"],"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/bmalbusca.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":"CODE_OF_CONDUCT.md","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":"2020-03-05T23:46:49.000Z","updated_at":"2024-09-26T10:05:01.000Z","dependencies_parsed_at":"2024-09-23T23:30:44.148Z","dependency_job_id":"a0a479ec-e542-42d1-9600-193f18f0d291","html_url":"https://github.com/bmalbusca/FacialRecognition_RMSF","commit_stats":{"total_commits":53,"total_committers":5,"mean_commits":10.6,"dds":0.5660377358490566,"last_synced_commit":"3e34e6cfd3529601ed9c900c922a02d45699916b"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmalbusca%2FFacialRecognition_RMSF","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmalbusca%2FFacialRecognition_RMSF/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmalbusca%2FFacialRecognition_RMSF/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmalbusca%2FFacialRecognition_RMSF/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bmalbusca","download_url":"https://codeload.github.com/bmalbusca/FacialRecognition_RMSF/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238614420,"owners_count":19501455,"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":["facial-recognition","flask","flutter","opencv","opencv-python","raspberry-pi-3","raspberry-pi-camera","rest-api","smart-door"],"created_at":"2024-09-24T13:56:35.242Z","updated_at":"2025-10-28T07:31:15.150Z","avatar_url":"https://github.com/bmalbusca.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"#   Smart Door Lock \n\n##  Architecture\n\n-   Micro-service (Flask): REST End-points; Handles the interaction between the User and the Smart Door; Also, Verifies and validates the service registration\n\n-   SmartLock (Raspberry Pi 3, PiCam, OpenCV): API Requests to send (status and camera's images data) and receive (remote operations) ; Facial Recognition with OpenCV; Circuit Lock control\n\n-  User Client App (Flutter): Remote control; Streaming viewer  service; Event notification\n\n```bash\n.\n├── App\n│   ├── README.md\n│   ├── android\n│   │   ├── app\n├── PyOpenCV\n│   ├── FacialRecognition\n│   │   ├── camDetect.py\n│   │   ├── dataset\n│   │   ├── faceRecog.py\n│   │   ├── haarcascade_frontalface_default.xml\n│   │   └── trainer\n│   │       └── trainer.yml\n│   └── environment.yml\n├── README.md\n└── uservice\n    ├── app.yaml\n    ├── database.log\n    ├── main.py\n    ├── requirements.txt\n    └── templates\n        └── index.html\n\n```\n## How to run this in your local machine?\n\n-   Microservice (Local computer or cloud service):\n        \n     1.   install requirements (using `requirements.txt` and python) or just install manually the required packages\n        \n     2. run the application: `python3 main.py`\n    \n-   Facial Recogn App (Raspberry Pi 3 B+):\n        \n     1. install requirements (`requirements.yml`)\n      \n     2. run `python3 camDetect.py` to collect images (dataset). The default user is \"Bruno\".You can import the `Detection object` from `camDetect.py` and run it in your python console.\n        \n        ```\n            ''' example ''' \n            \n            a=Detection()                       \n            a.parse_data()                      #if dataset folder exists will collect info \n\n            a.capture(\"Bruno\",5, nclips=60)     #name is \"Bruno\", ID=5 and number of captures is 60 \n        \n        ```\n       \n        \n     3. run `python3 faceRecog.py` to train and for image classification  \n     \n     If you notice, the `faceRecog.py` is responsable to classify the capture, sending resquests to the microservice and opening the door. In this version,  the door is simulated with a [LED circuit connected to GPIO 17](https://github.com/bmalbusca/FacialRecognition_RMSF/blob/5458f2e687a75e4a3331f75037c7bec8538f5523/PyOpenCV/FacialRecognition/faceRecog.py#L11) (Uncomment and try it). The service should the registered at the microservice,this means if the `service_id` does not exists in your microservice, the raspberry pi will not receive/send requests. \n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbmalbusca%2Ffacialrecognition_rmsf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbmalbusca%2Ffacialrecognition_rmsf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbmalbusca%2Ffacialrecognition_rmsf/lists"}