{"id":23152734,"url":"https://github.com/fahadpathan7/aqi-prediction-web","last_synced_at":"2025-07-06T00:05:37.774Z","repository":{"id":268207492,"uuid":"896894553","full_name":"fahadPathan7/AQI-Prediction-Web","owner":"fahadPathan7","description":"This is a website that uses our custom model that we have developed for our thesis. It predicts Air Quality Indexing (AQI) for an uploaded image in real-time. It also shows lime explanation that shows the regions of image that is important to the model (mostly sky areas).","archived":false,"fork":false,"pushed_at":"2024-12-15T06:56:31.000Z","size":90894,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-04T15:50:55.937Z","etag":null,"topics":["flask"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fahadPathan7.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-01T15:11:39.000Z","updated_at":"2025-02-24T09:09:13.000Z","dependencies_parsed_at":null,"dependency_job_id":"0688cdbe-9441-4979-9071-f9ee38c607ea","html_url":"https://github.com/fahadPathan7/AQI-Prediction-Web","commit_stats":null,"previous_names":["fahadpathan7/aqi-prediction-web"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fahadPathan7/AQI-Prediction-Web","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fahadPathan7%2FAQI-Prediction-Web","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fahadPathan7%2FAQI-Prediction-Web/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fahadPathan7%2FAQI-Prediction-Web/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fahadPathan7%2FAQI-Prediction-Web/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fahadPathan7","download_url":"https://codeload.github.com/fahadPathan7/AQI-Prediction-Web/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fahadPathan7%2FAQI-Prediction-Web/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263827448,"owners_count":23516789,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["flask"],"created_at":"2024-12-17T19:18:35.990Z","updated_at":"2025-07-06T00:05:37.751Z","avatar_url":"https://github.com/fahadPathan7.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cdiv align='center'\u003e🌍 AQI Prediction 🌤️\u003c/div\u003e\n\nThis is the application of our undergrad thesis. The thesis is about predicting the **Air Quality Index (AQI)** of a city using **Machine Learning**. We have used the data of the city of Dhaka, Bangladesh (open-source) to train our model. The model we have used here is our proposed custom model **(DeepAQNet)** which outperforms the other pre-trained models and the models worked on the same dataset. Just by capturing the image of the surrounding environment, the user can get the **real-time AQI** of that place.\n\n---\n\n## 📋 Table of Contents\n- [🌍 AQI Prediction 🌤️](#-aqi-prediction-️)\n  - [📋 Table of Contents](#-table-of-contents)\n  - [📖 Introduction](#-introduction)\n    - [🌬️ What is AQI?](#️-what-is-aqi)\n    - [🤔 Why is AQI important?](#-why-is-aqi-important)\n    - [🇧🇩 Why is AQI prediction important for Bangladesh?](#-why-is-aqi-prediction-important-for-bangladesh)\n  - [🚀 Result of our Proposed Model](#-result-of-our-proposed-model)\n  - [🛠️ How to use the application?](#️-how-to-use-the-application)\n  - [📸 Web Screenshots](#-web-screenshots)\n\n---\n\n## 📖 Introduction\n### 🌬️ What is AQI?\nThe **Air Quality Index (AQI)** indicates air pollution levels and their potential health effects. It measures pollutants such as particulate matter, ozone, carbon monoxide, sulfur dioxide, and nitrogen dioxide.\n\n### 🤔 Why is AQI important?\nThe AQI communicates daily air quality and guides precautions for public health. Categories:\n\n- **0-50**:    🟢 Good\n- **51-100**:  🟡 Moderate\n- **101-150**: 🟠 Unhealthy for Sensitive Groups\n- **151-200**: 🔴 Unhealthy\n- **201-300**: 🟣 Very Unhealthy\n- **301-500**: ⚫ Hazardous\n\n### 🇧🇩 Why is AQI prediction important for Bangladesh?\nBangladesh faces severe air pollution due to urbanization, industrialization, and vehicular emissions. Dhaka often ranks among the world's most polluted cities. Real-time AQI predictions can help people take precautions against harmful air quality.\n\n---\n\n\n## 🚀 Result of our Proposed Model\nWe have trained our proposed model **(DeepAQNet)** on the dataset of Dhaka, Bangladesh. The model has achieved the following performance metrics on the test dataset:\n\n| 🧪 Metric | ⚙️ Value |\n| --- | ---- |\n| **MSE** | 1685.03 |\n| **RMSE** | 41.05 |\n| **MAE** | 30.55 |\n| **R2 Score** | 0.4229 |\n\n---\n\n## 🛠️ How to use the application?\n**Note:** 🐍 Python must be installed on your system.\n\n1. Clone the repository. 🌀\n   ```bash\n   git clone https://github.com/fahadPathan7/AQI-Prediction-Web.git\n   ```\n2. Change the directory. 📂\n   ```bash\n   cd AQI-Prediction-Web\n   ```\n3. Install the required libraries. 📦\n   ```bash\n   pip install flask tensorflow numpy pillow matplotlib lime scikit-image\n   ```\n4. Run the application. 🚀\n   ```bash\n   python app.py\n   ```\n5. Open the browser and go to the following URL. 🌐\n   ```bash\n   http://localhost:5000/\n   ```\n6. Capture the image of the surrounding environment. 📸\n7. Click on the **Predict** button to get the real-time AQI of that place. ✅\n8. Get the AQI and take necessary precautions to protect yourself from the harmful effects of air pollution. 🌬️\n\n---\n\n## 📸 Web Screenshots\n\u003cdiv align='center'\u003e\n    \u003cb\u003e🖼️ Before Uploading the Image\u003c/b\u003e \u003cbr\u003e\n    \u003cimg src='./images/aqi_before.png' width='800' height='400'\u003e \u003cbr\u003e\n\u003c/div\u003e\n\n\u003cp align='center' style=\"font-size: 25px; text-align: center;\"\u003e⬇️\u003c/p\u003e\n\n\u003cdiv align='center'\u003e\n    \u003cb\u003e📷 After Uploading \u0026 Predicting the Image\u003c/b\u003e \u003cbr\u003e\n    \u003cimg src='./images/aqi_after.png' width='800' height='400'\u003e \u003cbr\u003e\n\u003c/div\u003e\n\n---","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffahadpathan7%2Faqi-prediction-web","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffahadpathan7%2Faqi-prediction-web","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffahadpathan7%2Faqi-prediction-web/lists"}