recycloBot / README.md
tejasashinde's picture
Add application files
2b506bf
---
title: RecycloBot
emoji: ♻️
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 6.12.0
app_file: app.py
pinned: true
short_description: AI-Powered Recycling Adviser
---
# ♻️ RecycloBot – AI-Powered Recycling Advisor
RecycloBot helps users determine whether an item is recyclable using AI. It analyzes a description, an image, or both, and provides personalized, region-specific recycling guidance.
---
## 🚀 Purpose
Empower users to make eco-friendly choices by identifying if everyday waste items are recyclable, how to dispose of them correctly, and why it matters — all with help from AI and power of LLM.
---
## ✨ Key Features
* 📷 Image + text-based item recognition
* 🌍 Region-aware recycling guidance
* 🧠 Smart Item Classification (material type, category, disposal method, risk level)
* 🌱 Environmental Impact Scoring (CO₂ impact, pollution risk, environmental consequence)
* 🤖 Powered by a multimodal LLM (vision + language) via API.
---
## 🧠 APIs Support
* **1.** [Nebius Studio API](https://nebius.ai/)
* **2.** [Google Gemini](https://gemini.google.com/app)
---
## 🛠️ Functionality Overview
Users can:
* Upload an image of item which needs to be recycled and optionally describe it (or both).
* Specify your location to receive recycling advice tailored to your area.
* Get AI-generated recycling advice for the item.
---
## 📦 Dependencies
### 🧪 Install dependencies after clonning with:
```bash
pip install -r requirements.txt
```
---
## ▶️ How to Run
```bash
python app.py
```
Then open your browser at `http://localhost:7860/`
---
Made with ❤️ using Gradio in India
Created by [tejasashinde](https://huggingface.co/tejasashinde)
---