Spaces:
Sleeping
Sleeping
Update README.md
Browse files
README.md
CHANGED
@@ -29,11 +29,6 @@ CropGuard/
|
|
29 |
βββ app.py # Gradio app
|
30 |
βββ Dockerfile # Docker container definition
|
31 |
βββ requirements.txt # Python dependencies
|
32 |
-
βββ notebooks/ # Step-by-step project development
|
33 |
-
β βββ 01_data_preprocessing.ipynb
|
34 |
-
β βββ 02_model_training.ipynb
|
35 |
-
β βββ 03_model_validation.ipynb
|
36 |
-
β βββ 04_gradcam_visualization.ipynb
|
37 |
βββ src/ # Source code (organized into modules)
|
38 |
β βββ app/
|
39 |
β βββ data/
|
@@ -44,76 +39,6 @@ CropGuard/
|
|
44 |
βββ README.md # (this file)
|
45 |
```
|
46 |
|
47 |
-
---
|
48 |
-
|
49 |
-
## Notebooks Overview
|
50 |
-
|
51 |
-
| Notebook | Purpose |
|
52 |
-
|:-|:-|
|
53 |
-
| `01_data_preprocessing.ipynb` | Download PlantVillage dataset, clean and split into train/val/test sets |
|
54 |
-
| `02_model_training.ipynb` | Set up data augmentation, train MobileNetV2 model, monitor training curves |
|
55 |
-
| `03_model_validation.ipynb` | Evaluate model performance, generate metrics, confusion matrix |
|
56 |
-
| `04_gradcam_visualization.ipynb` | Generate GradCAM++ heatmaps to visualize model focus |
|
57 |
-
|
58 |
-
---
|
59 |
-
|
60 |
-
## How to Run Locally
|
61 |
-
|
62 |
-
1. **Clone the repo:**
|
63 |
-
|
64 |
-
```bash
|
65 |
-
git clone https://github.com/YOUR_USERNAME/CropGuard.git
|
66 |
-
cd CropGuard
|
67 |
-
```
|
68 |
-
|
69 |
-
2. **Create a virtual environment:**
|
70 |
-
|
71 |
-
```bash
|
72 |
-
python3 -m venv .venv
|
73 |
-
source .venv/bin/activate
|
74 |
-
```
|
75 |
-
|
76 |
-
3. **Install dependencies:**
|
77 |
-
|
78 |
-
```bash
|
79 |
-
pip install --upgrade pip
|
80 |
-
pip install -r requirements.txt
|
81 |
-
```
|
82 |
-
|
83 |
-
4. **Launch the app:**
|
84 |
-
|
85 |
-
```bash
|
86 |
-
python app.py
|
87 |
-
```
|
88 |
-
|
89 |
-
It will be available at [http://localhost:7860](http://localhost:7860).
|
90 |
-
|
91 |
-
---
|
92 |
-
|
93 |
-
## How to Build and Run with Docker
|
94 |
-
|
95 |
-
```bash
|
96 |
-
docker build -t cropguard-app .
|
97 |
-
docker run -p 7860:7860 cropguard-app
|
98 |
-
```
|
99 |
-
|
100 |
-
---
|
101 |
-
|
102 |
-
## Web Deployment
|
103 |
-
|
104 |
-
Easily deployable on:
|
105 |
-
|
106 |
-
- Hugging Face Spaces
|
107 |
-
- DockerHub
|
108 |
-
|
109 |
-
---
|
110 |
-
|
111 |
-
## Sample Images
|
112 |
-
|
113 |
-
We provide a few **sample leaf images** in the `sample_images/` directory so users can test the model even without their own images.
|
114 |
-
|
115 |
-
---
|
116 |
-
|
117 |
## License
|
118 |
|
119 |
MIT License.
|
|
|
29 |
βββ app.py # Gradio app
|
30 |
βββ Dockerfile # Docker container definition
|
31 |
βββ requirements.txt # Python dependencies
|
|
|
|
|
|
|
|
|
|
|
32 |
βββ src/ # Source code (organized into modules)
|
33 |
β βββ app/
|
34 |
β βββ data/
|
|
|
39 |
βββ README.md # (this file)
|
40 |
```
|
41 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
42 |
## License
|
43 |
|
44 |
MIT License.
|