title	StyleSavvy
emoji	🏆
colorFrom	gray
colorTo	purple
sdk	gradio
sdk_version	5.29.0
app_file	app.py
pinned	false
short_description	Style Savvy - AI Style Fashion Consultant

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

👗 StyleSavvy — Your AI Fashion Consultant

StyleSavvy is an AI-powered virtual stylist that analyzes clothing in photos and generates personalized fashion advice based on your body type, face shape, gender, and occasion.

---

✨ Features

• 📸 Upload outfit photos for style analysis
• 🧠 YOLOS-Fashionpedia for clothing detection
• 🪄 Optional background removal (remove.bg API)
• 💬 Tailored tips using google/flan-t5-large language model
• 🧍‍♀️ Personalized for body type, face shape, gender, and events
• ⚡ Gradio interface for instant styling suggestions

---

🧰 Tech Stack

• Gradio — User interface
• YOLOS — Object detection (Fashionpedia dataset)
• FLAN-T5 — Text generation for fashion tips
• remove.bg API — Optional background removal
• Hugging Face Spaces for hosting

---

🚀 Live Demo

👉 Try it here: StyleSavvy on Hugging Face

---

🛠️ How to Run Locally

1. Clone the repo

git clone https://github.com/Munazzah-Rakhangi/StyleSavvy.git
cd StyleSavvy

2. Create and activate virtual environment

Create a virtual environment:

python -m venv venv

Activate the environment:

• On Windows:

  venv\Scripts\activate

• On macOS/Linux:

  source venv/bin/activate

3. Install dependencies

pip install -r requirements.txt

4. Add your API key (optional for background removal)

Create a .env file:

REMOVE_BG_API_KEY=your_api_key_here

Or add it as a Hugging Face secret if running on Spaces.

5. Run the app

python app.py

6. For Testing use command

python3 test_llm.py

Then open the local Gradio link in your browser.

---

🧪 How to Test the App

1. Upload an outfit photo that you want to analyze.
2. Select styling parameters from the dropdown menus:
   • Body Type: Slim, Athletic, Curvy, Plus-size
   • Face Shape: Oval, Round, Square, Heart
   • Gender: Male, Female
   • Occasion: (e.g., Wedding, Casual, Business, etc.)
3. Click Generate Style Tips.
4. Review the personalized style tips and clothing analysis generated by the app.

---

🧠 Example Use Case

“A curvy woman with a round face going to a summer wedding”
→ StyleSavvy suggests breathable floral fabrics, statement earrings, and pastel tones that match the event ambiance.

---

🤝 Contributing

Feel free to open issues or pull requests!

---