README.md

---
title: Garbage Classifier Ui
emoji: 👁
colorFrom: blue
colorTo: blue
sdk: gradio
sdk_version: 5.34.2
app_file: app.py
pinned: false
license: mit
short_description: Garbage Classifier UI
---

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

# 🧠 Garbage Classifier UI

A real-world deep learning application that classifies garbage images into categories like **plastic**, **metal**, **cardboard**, etc.

This app uses a **custom-trained CNN model** to demonstrate computer vision for sustainability-related use cases. Powered by **TensorFlow** and deployed with **Streamlit** on Hugging Face Spaces.

🔗 **Live App**: [Click to open 🚀](https://huggingface.co/spaces/sykamraju/garbage-classifier-ui)

🔗 **GitHub Repo**: [SykamRaju/Garbage-Classifier](https://github.com/SykamRaju/Garbage-Classifier)

---

## 🖼️ How it works

1. Upload an image of waste material (e.g. bottle, paper, can).
2. The backend model predicts the category.
3. The prediction and confidence score are displayed instantly.

---

## 📦 Tech Stack

- **Model**: TensorFlow (CNN trained on Garbage Classification dataset)
- **Frontend**: Streamlit
- **Deployment**: Hugging Face Spaces
- **Language**: Python

---

## 📁 Project Structure

.
├── model/ # Saved Keras model
├── src/
│ └── app.py # Streamlit frontend app
├── utils.py # Helper functions
├── requirements.txt # Python dependencies
└── README.md # You're reading this 🙂

yaml
Copy
Edit

---

## 🧪 Example Predictions

| Image                                                                                           | Predicted Class |
| ----------------------------------------------------------------------------------------------- | --------------- |
| ![Plastic](https://github.com/SykamRaju/Garbage-Classifier/raw/main/samples/plastic_sample.jpg) | `Plastic`       |
| ![Metal](https://github.com/SykamRaju/Garbage-Classifier/raw/main/samples/metal_sample.jpg)     | `Metal`         |

---

## 🙋‍♂️ About Me

Hi, I'm **Raju Sykam** — a full-stack developer and AI enthusiast with 20+ years of software experience.  
I'm currently building a suite of AI projects in Python to showcase my skills.  
🔭 I also run [FreeAstrologyAPI.com](https://freeastrologyapi.com) and love math, astronomy, and stargazing!

---

## 📜 License

This project is licensed under the MIT License.

---