# lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction architecture

> Architecture diagram of the GitHub repository lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction
- Repository: https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction

## Overview

Crop AI Assistant is a Flask web application for identifying crop-leaf diseases and recommending fertilizers. A user uploads a leaf image through the web frontend; Flask calls the disease classifier, uses the detected disease and crop in disease-aware recommendation, then returns disease details and a fertilizer recommendation. A separate soil-and-crop input flow supports fertilizer-only recommendations. The repository also includes model-training code and reference data. Some frontend routes and configuration loading are not shown in the excerpts, so those links rely on README descriptions where noted.

Main entry points: [`src/app/app.py`](https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/src/app/app.py) (Flask application), [`src/app/disease_predictor.py`](https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/src/app/disease_predictor.py) (Disease classifier), [`src/app/disease_fertilizer_recommender.py`](https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/src/app/disease_fertilizer_recommender.py) (Disease-aware ranking), [`src/app/fertilizer_predictor.py`](https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/src/app/fertilizer_predictor.py) (Fertilizer predictor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_frontend["Upload interface<br/>[app.js]"]
  node_web_templates["Page template<br/>[index.html]"]
  node_flask["Flask application<br/>[app.py]"]
end

subgraph group_inference["Prediction and guidance"]
  node_disease_predictor["Disease classifier"]
  node_recommendation["Disease-aware ranking"]
  node_fertilizer_predictor["Fertilizer predictor"]
  node_fertilizer_utils["Fertilizer features"]
end

subgraph group_knowledge["Models and reference data"]
  node_settings["Model settings<br/>[settings.py]"]
  node_disease_model[("Disease model")]
  node_disease_classes["Disease classes"]
  node_fertilizer_model[("Fertilizer model")]
  node_disease_info["Disease information"]
  node_nutrient_guidance["Disease nutrient guidance"]
  node_fertilizer_info["Fertilizer information"]
end

subgraph group_training["Model training"]
  node_disease_training["Disease model training<br/>[train_disease.py]"]
  node_fertilizer_training["Fertilizer model training"]
end

node_user(("Crop grower"))

node_user -->|"uploads image"| node_frontend
node_frontend -.->|"uses page"| node_web_templates
node_frontend -.->|"submits prediction"| node_flask
node_flask -->|"classifies image"| node_disease_predictor
node_flask -->|"requests ranking"| node_recommendation
node_flask -->|"looks up details"| node_disease_info
node_flask -.->|"looks up details"| node_fertilizer_info
node_disease_predictor -->|"loads paths"| node_settings
node_disease_predictor -->|"loads model"| node_disease_model
node_disease_predictor -->|"loads labels"| node_disease_classes
node_recommendation -->|"scores candidates"| node_fertilizer_predictor
node_recommendation -->|"uses input helpers"| node_fertilizer_utils
node_recommendation -.->|"loads guidance"| node_nutrient_guidance
node_fertilizer_predictor -->|"loads model path"| node_settings
node_fertilizer_predictor -->|"loads model"| node_fertilizer_model
node_fertilizer_predictor -->|"formats inputs"| node_fertilizer_utils
node_disease_training -->|"uses paths"| node_settings
node_disease_training -->|"saves model"| node_disease_model
node_disease_training -->|"saves labels"| node_disease_classes
node_fertilizer_training -->|"uses paths"| node_settings
node_fertilizer_training -->|"engineers features"| node_fertilizer_utils
node_fertilizer_training -->|"saves pipeline"| node_fertilizer_model

click node_frontend "https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/frontend/static/js/app.js"
click node_web_templates "https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/frontend/templates/index.html"
click node_flask "https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/src/app/app.py"
click node_disease_predictor "https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/src/app/disease_predictor.py"
click node_recommendation "https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/src/app/disease_fertilizer_recommender.py"
click node_fertilizer_predictor "https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/src/app/fertilizer_predictor.py"
click node_fertilizer_utils "https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/src/utils/fertilizer_utils.py"
click node_settings "https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/src/config/settings.py"
click node_disease_model "https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/code/models/disease_model.keras"
click node_disease_classes "https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/code/models/disease_classes.txt"
click node_fertilizer_model "https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/code/models/fertilizer_model.pkl"
click node_disease_info "https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/tree/main/src/config/disease_info"
click node_nutrient_guidance "https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/tree/main/src/config/disease_fertilizer"
click node_fertilizer_info "https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/tree/main/src/config/fertilizer_info"
click node_disease_training "https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/src/training/train_disease.py"
click node_fertilizer_training "https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/src/training/train_fertilizer.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_frontend,node_web_templates,node_flask toneBlue
class node_disease_predictor,node_recommendation,node_fertilizer_predictor,node_fertilizer_utils toneAmber
class node_settings,node_disease_model,node_disease_classes,node_fertilizer_model,node_disease_info,node_nutrient_guidance,node_fertilizer_info toneMint
class node_disease_training,node_fertilizer_training toneRose
class node_user toneIndigo
```

## Components

### Web experience

- [Upload interface](https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/frontend/static/js/app.js): `frontend/static/js/app.js`
- [Page template](https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/frontend/templates/index.html): `frontend/templates/index.html`
- [Flask application](https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/src/app/app.py): `src/app/app.py`

### Prediction and guidance

- [Disease classifier](https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/src/app/disease_predictor.py): `src/app/disease_predictor.py`
- [Disease-aware ranking](https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/src/app/disease_fertilizer_recommender.py): `src/app/disease_fertilizer_recommender.py`
- [Fertilizer predictor](https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/src/app/fertilizer_predictor.py): `src/app/fertilizer_predictor.py`
- [Fertilizer features](https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/src/utils/fertilizer_utils.py): `src/utils/fertilizer_utils.py`

### Models and reference data

- [Model settings](https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/src/config/settings.py): `src/config/settings.py`
- [Disease model](https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/code/models/disease_model.keras): `code/models/disease_model.keras`
- [Disease classes](https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/code/models/disease_classes.txt): `code/models/disease_classes.txt`
- [Fertilizer model](https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/code/models/fertilizer_model.pkl): `code/models/fertilizer_model.pkl`
- [Disease information](https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/tree/main/src/config/disease_info): `src/config/disease_info`
- [Disease nutrient guidance](https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/tree/main/src/config/disease_fertilizer): `src/config/disease_fertilizer`
- [Fertilizer information](https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/tree/main/src/config/fertilizer_info): `src/config/fertilizer_info`

### Model training

- [Disease model training](https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/src/training/train_disease.py): `src/training/train_disease.py`
- [Fertilizer model training](https://github.com/lalithtejakarnati/crop-disease-identification-and-fertilizer-prediction/blob/main/src/training/train_fertilizer.py): `src/training/train_fertilizer.py`

### Other components

- **Crop grower**

## Connections

- Crop grower → Upload interface: uploads image (evidence: `README.md`)
- Upload interface → Page template: uses page
- Upload interface → Flask application: submits prediction
- Flask application → Disease classifier: classifies image (evidence: `src/app/app.py`)
- Flask application → Disease-aware ranking: requests ranking (evidence: `src/app/app.py`)
- Flask application → Disease information: looks up details (evidence: `README.md`)
- Flask application → Fertilizer information: looks up details
- Disease classifier → Model settings: loads paths (evidence: `src/app/disease_predictor.py`)
- Disease classifier → Disease model: loads model (evidence: `src/app/disease_predictor.py`)
- Disease classifier → Disease classes: loads labels (evidence: `src/app/disease_predictor.py`)
- Disease-aware ranking → Fertilizer predictor: scores candidates (evidence: `src/app/disease_fertilizer_recommender.py`)
- Disease-aware ranking → Fertilizer features: uses input helpers (evidence: `src/app/disease_fertilizer_recommender.py`)
- Disease-aware ranking → Disease nutrient guidance: loads guidance
- Fertilizer predictor → Model settings: loads model path (evidence: `src/app/fertilizer_predictor.py`)
- Fertilizer predictor → Fertilizer model: loads model (evidence: `src/app/fertilizer_predictor.py`)
- Fertilizer predictor → Fertilizer features: formats inputs (evidence: `src/app/fertilizer_predictor.py`)
- Disease model training → Model settings: uses paths (evidence: `src/training/train_disease.py`)
- Disease model training → Disease model: saves model (evidence: `src/training/train_disease.py`)
- Disease model training → Disease classes: saves labels (evidence: `src/training/train_disease.py`)
- Fertilizer model training → Model settings: uses paths (evidence: `src/training/train_fertilizer.py`)
- Fertilizer model training → Fertilizer features: engineers features (evidence: `src/training/train_fertilizer.py`)
- Fertilizer model training → Fertilizer model: saves pipeline (evidence: `src/training/train_fertilizer.py`)
