NYRA – Virtual AI Makeup Assistant

Version : 1.0

Author : Kshitij K Sawant

🔍 Overview

NYRA is an advanced virtual AI-powered makeup assistant designed to revolutionize the way users explore beauty and cosmetics. Using real-time facial recognition, advanced makeup simulation, and AI-driven color analysis, NYRA allows users to try different makeup styles virtually. This tool is ideal for beauty enthusiasts, makeup artists, and professionals who want to experiment with various looks without applying real products.

⭐ Support

If you like this project, give it a star ⭐ on GitHub!

✨ Features

🎥 Real-Time Webcam Makeup Application: Instantly apply virtual makeup using your webcam.
💄 Customizable Makeup Controls: Choose blush, lipstick, and eyeshadow shades with adjustable intensity levels.
🎨 AI-Driven Color Analysis: Get personalized beauty suggestions based on your skin tone, eye color, and lip color.
🔍 Facial Landmark Detection: Uses MediaPipe’s face mesh to precisely detect facial features for accurate makeup application.
📸 Image Capture & Save: Save images after applying virtual makeup with just one click.
🔧 User-Friendly Interface: An intuitive design for effortless navigation and interaction.
📊 Detailed Color Palette Suggestions: Get fashion and beauty insights based on seasonal color theory.

🚀 Introduction

💻 1. Using the Webcam Controls

Start Webcam: Click the "🎥 Start Webcam" button on the sidebar to activate your webcam feed.
Stop Webcam: Click "🛑 Stop Webcam" to stop the live feed.
Capture Image: Click "📸 Capture & Save Image" to save your current frame with applied makeup.

💄 2. Apply Virtual Makeup

Blush Settings:
- Enable or disable blush.
- Select the color from predefined shades, match your skin tone, or use a custom color picker.
- Adjust the intensity using the slider.
Lip Color Settings:
- Enable or disable lipstick.
- Choose from predefined colors or set a custom color.
- Adjust opacity for a subtle or bold look.
Eyeshadow Settings:
- Enable or disable eyeshadow.
- Pick colors from the palette or choose custom shades.
- Adjust intensity for desired effect.

🌈 3. AI-Driven Color Analysis

Enter your Google AI Studio API Key in the sidebar.
Click "Generate Color Analysis" to get personalized makeup and fashion suggestions based on your skin tone, eye color, and lip shade.

📸 4. Saving Your Looks

Once you’re satisfied with your virtual makeover, click "📸 Capture & Save Image" to save your look.
All images will be saved in the Captured_Images/ folder automatically with timestamps.

📖 How to Use

Follow these steps to make the most of NYRA and experiment with virtual makeup effortlessly.

1. Start the Webcam

Go to the Webcam Controls panel on the sidebar.
Click on 🎥 Start Webcam.
The live webcam feed will appear on the main screen.

📸 Webcam Interface

2. AI Color Analysis

Enter your Google AI Studio API Key in the AI Color Analysis section.
Click on Generate Color Analysis to let NYRA analyze your skin, iris, and lip tones.
The analysis provides:
- 🎨 Skin Color
- 👁️ Iris Color
- 💋 Lip Color
It also suggests suitable makeup, clothing colors, and hair shades based on the analysis.

🎨 AI Suggested Color Swatches

3. Apply Makeup Virtually

💄 Blush Settings

Enable the blush feature using the Enable Blush button.
Adjust Blush Intensity with the slider.
Select a blush color:
- Match skin tone
- Predefined colors
- Custom color using the color picker

Blush Settings Panel

4. Lipstick Settings

Enable lipstick using the Enable Lipstick button.
Choose from predefined lipstick shades or select a custom color.
Adjust Lipstick Intensity using the slider.

Lipstick Settings Panel

✨ Eyeshadow & Face Enhancements

Enable eyeshadow and pick colors.
Adjust the intensity for a natural or bold look.
Enhance your face using smoothing and brightness sliders for better virtual effects.

✨ Eyeshadow and Face Enhancements

🌈 5. AI-Driven Color Analysis

Google AI Studio: A Powerful AI Development Platform 🚀

Google AI Studio is an online platform designed for developers, researchers, and businesses to access, experiment with, and deploy Google's Gemini AI models easily. It provides a user-friendly interface for working with Google's large language models (LLMs) and multimodal AI capabilities, allowing you to create AI-driven applications with minimal effort.

NYRA leverages Google AI Studio’s Gemini AI for advanced color analysis and fashion recommendations. Using real-time facial landmark detection and AI-driven insights, NYRA can generate:

🎨 Personalized color palettes based on your skin tone, iris color, and lip shade.
🏷️ Makeup, fashion, and hair color recommendations aligned with seasonal color theory.
🎭 HEX Color Codes for seamless integration into makeup and styling choices.

How It Works:

Enter your Gemini AI API Key in the sidebar.
Click "Generate AI Color Analysis" to process real-time color analysis.
AI will detect and suggest ideal makeup, clothing, and hair color choices.
View HEX color swatches extracted from the AI recommendations.

🎨 AI Color Analysis Result

📸 6. Saving Your Looks

Once you’re satisfied with your virtual makeover, click "📸 Capture & Save Image" to save your look.
All images will be saved in the Captured_Images/ folder automatically with timestamps.

🚀 Installation Instructions

Follow these steps to set up NYRA - Virtual AI Makeup Assistant on your local machine:

1. Prerequisites

Ensure you have the following installed on your machine:

✅ Python 3.8+
✅ pip (Python package manager)
✅ A webcam for capturing real-time video
✅ Google AI Studio API Key for AI-powered color analysis

2. Clone the Repository

Use git to clone the NYRA project repository:

git clone https://github.com/your-username/nyra-virtual-ai-makeup-assistant.git
cd nyra-virtual-ai-makeup-assistant

3. Install Dependencies

Install all necessary packages using:

pip install -r requirements.txt

If you face issues with specific packages, install them manually:

pip install streamlit opencv-python mediapipe Google AI Studio numpy

4. Run NYRA Locally

Execute the following command to launch the app:

streamlit run app.py

The application will open in your default browser at:

http://localhost:8501

5. Folder Structure

Here's what your project directory should look like:

NYRA/
│
├── Assets/                    # Logos, icons, and additional assets
├── Face Marking/              # Face landmark detection modules
├── Mesh Coding/               # Mesh generation and processing code
├── Rasengan/                  # Custom effects (if applicable)
├── Sharingan/                 # Additional effects/features
│
├── Streamlit_App/             # Main Streamlit application code
├── Virtual Makeup/            # Core virtual makeup application files
│
├── Extras/                    # 🔥 New folder for additional files and resources
│   ├── Documentation/         # Additional notes, references, or guides
│   ├── Testing/               # Test scripts and debugging tools
│   ├── Backups/               # Backup files or old versions
│   └── Experiments/           # Experimental code/features
├── apt.txt                    # Additional system dependencies
├── packages.txt               # List of installed packages
├── Readme.md                  # Main project documentation
├── render.yaml                # Render deployment configuration
├── requirements.txt           # Required Python packages

📂 Extra Features and Modules

The NYRA - Virtual AI Makeup Assistant comes with several extra modules and creative features that go beyond standard virtual makeup applications. These additional tools are designed to enhance the user experience and allow for advanced experimentation with visual effects.

🔍 1. Face Marking

The Face Marking folder contains scripts that handle facial feature detection using landmarks, which are essential for accurate virtual makeup application. Each script focuses on different facial areas:

All Marks.py – Detects and marks all significant facial landmarks.
Blush Mark.py – Specifically marks cheek areas for accurate blush application.
Eye Landmark.py – Detects and marks eye contours for applying makeup around the eyes.
Eyelids Marks.py – Targets eyelids for precise eyeshadow application.
Lipstick.py – Detects and outlines the lips for applying virtual lipstick.
Nose Contour.py – Helps with contouring effects around the nose.

🎨 2. Mesh Coding

The Mesh Coding folder provides advanced geometrical tracking and mesh manipulation, enabling more detailed makeup applications and custom effects:

Geometric Mesh Selector.py – Selects specific mesh areas for targeted effects.
Geometric Mesh.py – Generates a geometric mesh overlay for custom visual effects.
Hand Tracking.py – Detects hand gestures to enable gesture-based makeup control.
Landmark Selector.py – Allows users to manually select landmarks for custom makeup adjustments.

🌪️ 3. Rasengan (Naruto Effect)

A fun and creative feature inspired by anime visual effects:

Naruto Effect.py – Applies the iconic Rasengan energy effect around the user’s hand or face.
Rasengan GIF.mp4 – A looping animation that showcases the effect dynamically.

👁️ 4. Sharingan Eye Effect

Another anime-inspired visual feature designed for eye transformations:

Sharingan Eye.py – Applies the Sharingan eye effect from Naruto to the user’s eyes.
image.png / image2.png – Custom images used to replicate the visual appearance of the Sharingan.

😎 5. Virtual Makeup Add-ons

The Virtual Makeup folder offers additional elements to enhance user style:

camera.py – Handles real-time webcam feed and captures frames for makeup application.
eye_landmark.py & eyelids.py – Detects eye landmarks and eyelids for applying eye-based effects.
eyewear.py – Adds virtual glasses to the user's face.
Eyewear_Collection.png / glasses.png – Contains different virtual glasses styles.
hat.py – Applies virtual hats for an augmented reality experience.
hat.png – Custom hat graphics.
lipstick.py – Applies customizable lipstick shades.
main.py – Central script that integrates all features for running the application.
image.py – Manages image overlays for custom graphics.
utils.py – Contains utility functions used across multiple modules.

🛠️ Supporting Files

requirements.txt – Lists all required Python libraries to run NYRA smoothly.
apikey.txt – Stores API keys (e.g., for Google AI Studio integration).
License – Specifies the GNU General Public License (GPL-3.0) for open-source distribution.

🎉 Contributing

We welcome contributions! If you'd like to improve NYRA:

Fork the repository.
Create a new branch (git checkout -b feature-branch).
Commit your changes (git commit -m 'Add some feature').
Push to the branch (git push origin feature-branch).
Create a Pull Request.

🙌 Acknowledgments

🤖 Google AI Studio for powering color analysis.
💻 Streamlit for the interactive user interface.
📸 MediaPipe for real-time face mesh detection.

Name		Name	Last commit message	Last commit date
Latest commit History 14 Commits
Face Marking		Face Marking
Mesh Coding		Mesh Coding
Rasengan		Rasengan
Sharingan		Sharingan
Streamlit_App		Streamlit_App
Virtual Makeup		Virtual Makeup
assets		assets
.DS_Store		.DS_Store
.gitignore		.gitignore
License		License
Readme.md		Readme.md
apt.txt		apt.txt
packages.txt		packages.txt
render.yaml		render.yaml
requirements.txt		requirements.txt

License

KshitijSawant1/NYRA---Virtual-AI-Makeup-Assistant

Folders and files

Latest commit

History

Repository files navigation