Making cities cleaner, one click at a time!
CleanIt is an AI-powered waste reporting platform that enables citizens to capture and report garbage hotspots using photos and location data.
An AI classifier verifies if the image shows waste and automatically adds verified points to a Google Maps interface.
Municipal authorities can view, manage, and clean reported spots while tracking detailed analytics through an admin dashboard.
CleanIt is not just an app — it’s a step toward sustainable urban living, where every citizen becomes a stakeholder in environmental well-being.
The About page displays app objectives, logo, and a button to start reporting.
Users can upload photos of garbage dumps along with their real-time location using the Geolocation API and Google Maps.
Location, image with the shortest route to nearest garbage collector will be highlighted on Map.
Highlight: Intuitive interface powered by Google Maps API.
User can view thier profile, reward points, totals reports submitted, and their city Rank.
Displays aggregated waste points on a live Google Map to identify waste regions in the city. Admin can mark as clean and the location is removed from the logs and map.
Insight: Helps municipal authorities target high-impact areas.
Admin can view summaries, reports over time, top reporters, and leaderboard at a glance.
Data Visuals: Interactive charts powered by Recharts.
CleanIt provides secure login and role-based access (User/Admin) with session-based navigation.
- Citizen (Reporter):
- Uploads photo of waste site.
- Provides auto-detected or manual location.
- Earns reward points for valid submissions.
- Views all active (uncleaned) hotspots on map.
- Admin (Municipal Authority):
- Views all reports in a dashboard.
- Marks waste sites as “Cleaned”.
- Monitors statistics (total reports, resolved %).
- Can issue rewards to users.
| Layer | Technology |
|---|---|
| Frontend | React.js + Recharts |
| Backend | FastAPI |
| AI Model | TensorFlow / CNN model for dirty vs clean classification |
| Database | PostgreSQL |
| Maps Integration | Google Maps API |
| Auth | Basic Authentication |
Note
Ensure you have Python and npm installed on your system. Create an .env file in frontend and backend folder. Put the following in both files respectively
In backend:
DATABASE_URL=<neon_db_connection_string>
In frontend:
REACT_APP_GOOGLE_MAPS_API_KEY=<google_maps_api>- Clone the repo
git clone https://github.com/g14ayushi/CleanIt.git
cd cleanit- Setup Backend Inside a new virtual environment
pip install -r requirements.txt
uvicorn main:app --reload- Setup frontend
npm i
npm start
- Multi-language Support for inclusivity.
- AI Severity Scoring → how bad the waste site is (light/moderate/severe).
- Duplicate Detection → prevent repeated reports for same location.
- Notification System → email/SMS when site cleaned.
- Heatmap Mode → visualize waste concentration areas across the city.
- Data API for researchers/NGOs to analyze trends.