# π₯ Algerian Forest Fire Prediction System π²
An end-to-end, **π± phone-friendly** and responsive Machine Learning web application to predict the occurrence of forest fires in two regions of Algeria (**Bejaia** and **Sidi Bel-abbes**) based on meteorological variables.
---
## π Project Structure
```text
algerian-forest-fire-prediction/
βββ data/
β βββ raw/ # π Original dataset
β βββ processed/ # π§Ή Cleaned & scaled features
βββ notebooks/ # π Jupyter notebooks for EDA & prototyping
βββ models/ # πΎ Pickled models, scalers, and evaluation metrics
βββ src/ # βοΈ Source code (preprocessing, training pipelines)
βββ app.py # π Streamlit web application dashboard
βββ requirements.txt # π¦ Python dependencies
βββ Procfile # βοΈ Deployment config for Render/Heroku
βββ README.md # π Project documentation
```
---
## βοΈ Setup & Local Installation
1οΈβ£ **Clone the repository**:
```bash
git clone
cd algerian-forest-fire-prediction
```
2οΈβ£ **Install dependencies**:
```bash
pip install -r requirements.txt
```
3οΈβ£ **Data Processing**:
Fetch the dataset and run the automated preprocessing pipeline:
```bash
python src/preprocess.py
```
4οΈβ£ **Model Training**:
Train multiple machine learning algorithms and automatically select and serialize the best performing model:
```bash
python src/train.py
```
5οΈβ£ **Run the Web Application**:
Launch the responsive Streamlit dashboard locally:
```bash
streamlit run app.py
```
---
## β¨ Key Features
- π± **Phone-friendly & Responsive UI**: Premium *"Dark Fire"* forest aesthetic with custom Streamlit styling, structured card layouts, and complete phone friendliness (optimized touch targets, scaling typography, and responsive margins across phones, tablets, and desktop displays).
- π **Interactive Plotly Visualizations**: Features zoomable, interactive, and phone-friendly charts (stacked vertically with horizo β¦