Anshg07 commented 2 weeks ago

Pull Request for ML-Crate 💡

Issue Title: Add Facial Landmark Detection Using Python's MediaPipe Library

Info about the related issue (Aim of the project) : The aim is to integrate facial landmark detection functionality using Python's MediaPipe library into the existing application to enhance feature offerings.
Name: Ansh Gupta
Email ID for further communication: anshgupta072003@gmail.com
GitHub ID: Anshg07
Identify yourself: Contributor

Closes: #550

Describe the add-ons or changes you've made 📃

Added facial landmark detection capability using MediaPipe. This feature allows the application to detect and visualize facial landmarks in real-time using both photos and live video feeds.

Project Documentation:

Overview

This application utilizes MediaPipe and Streamlit to perform real-time facial landmark detection. Users can see their facial landmarks overlaid on their video feed in real-time.

How to Install and Run the Application

Install Required Libraries: You need to have Python installed on your system. Install the required Python libraries using pip: pip install streamlit cv2 numpy Pillow mediapipe streamlit_webrtc

markdown Copy code

Run the Application: Navigate to the directory containing the app.py file and run the following command: streamlit run app.py

less Copy code

Access the Application: Open your web browser and go to http://localhost:8501. The application should be running and ready to use.

How It Works

Video Streaming: Once the application is running, it will access your webcam. Make sure you permit the browser to use your webcam.
Facial Landmark Detection: The application processes each video frame to detect facial landmarks using MediaPipe's FaceMesh model. Detected landmarks are then drawn directly on the video feed, providing a visual representation of the face structure in real-time.

Use Cases

This tool can be used for various purposes, including:

Augmented reality development.
Facial recognition projects.
Studies and applications in human-computer interaction.

Type of change ☑️

[ ] Bug fix (non-breaking change which fixes an issue)
[x] New feature (non-breaking change which adds functionality)
[ ] Code style update (formatting, local variables)
[ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
[ ] This change requires a documentation update

How Has This Been Tested? ⚙️

The functionality was tested by integrating it into the existing app framework and running various tests with different types of facial images and live video to ensure accuracy and robustness under various conditions.

Checklist: ☑️

[x] My code follows the guidelines of this project.
[x] I have performed a self-review of my own code.
[x] I have commented my code, particularly in hard-to-understand areas.
[x] I have made corresponding changes to the documentation.
[x] My changes generate no new warnings.
[x] I have added tests that prove my fix is effective or that my feature works.
[x] Any dependent changes have been merged and published in downstream modules.

github-actions[bot] commented 2 weeks ago

Our team will soon review your PR. Thanks @Anshg07 :)

abhisheks008 commented 2 weeks ago

I understood that dataset is not required. Can you create a sub folder as Web App and put the app.py inside that with a README. Also add a demonstration video of the web app inside the Web App folder.

Follow this README template, https://github.com/abhisheks008/ML-Crate/blob/main/.github/web-app-readme-template.md