# nirsen117/agriai architecture

> Architecture diagram of the GitHub repository nirsen117/agriai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nirsen117/agriai
- Repository: https://github.com/nirsen117/agriai

## Overview

Agro AI is a mobile-first agricultural decision-support app. A farmer signs in, enters farm and location details, then views farm conditions and recommendations or requests crop-image triage and farm chat; the frontend sends requests to FastAPI, which combines normalized provider data with advisory logic. The product also offers diagnosis history, field mapping, multilingual UI, and an interoperability data feed. The graph follows documented capabilities and sampled imports/calls; some route-level wiring and unsampled implementations are represented only where the README supports them.

Main entry points: [`backend/app/main.py`](https://github.com/nirsen117/agriai/blob/main/backend/app/main.py) (FastAPI routes), [`frontend/src/App.tsx`](https://github.com/nirsen117/agriai/blob/main/frontend/src/App.tsx) (Farm workspace), [`frontend/src/api.ts`](https://github.com/nirsen117/agriai/blob/main/frontend/src/api.ts) (API client), [`frontend/src/firebaseAuth.ts`](https://github.com/nirsen117/agriai/blob/main/frontend/src/firebaseAuth.ts) (Firebase auth client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Farmer experience"]
  node_app["Farm workspace<br/>[App.tsx]"]
  node_authui["Sign-in dialog<br/>[AuthModal.tsx]"]
  node_translations["UI translations<br/>[i18n.ts]"]
  node_api_client["API client<br/>[api.ts]"]
  node_farm_store["Farm profile sync<br/>[farmStore.ts]"]
  node_diagnosis_history["Diagnosis history"]
end

subgraph group_api["Application API"]
  node_fastapi["FastAPI routes<br/>[main.py]"]
  node_models["Request and response models<br/>[schemas.py]"]
  node_profile_store[("Farm profile storage<br/>[main.py]")]
end

subgraph group_domain["Farm decision support"]
  node_advisory["Advisory rules<br/>[advisory.py]"]
  node_interop["Interoperability feed"]
end

subgraph group_integrations["Providers and integrations"]
  node_auth["Firebase auth client<br/>[firebaseAuth.ts]"]
  node_firebase[("Firebase services")]
  node_weather["Weather provider<br/>[providers.py]"]
  node_soil["Soil provider<br/>[providers.py]"]
  node_satellite["Satellite provider<br/>[providers.py]"]
  node_ai_disease["AI and disease adapters<br/>[providers.py]"]
end

node_farmer(("Farmer"))
node_openmeteo["Open-Meteo"]
node_bhuvan["Bhuvan LULC"]
node_gemini["Gemini"]
node_osm["OpenStreetMap"]

node_farmer -->|"uses"| node_app
node_app -->|"requests data"| node_api_client
node_app -->|"opens sign-in"| node_authui
node_authui -->|"authenticates"| node_auth
node_api_client -->|"gets token"| node_auth
node_auth -->|"signs in"| node_firebase
node_api_client -->|"syncs profile"| node_farm_store
node_farm_store -.->|"loads and saves"| node_firebase
node_app -->|"localizes UI"| node_translations
node_app -->|"saves diagnosis"| node_diagnosis_history
node_diagnosis_history -->|"reads and writes"| node_firebase
node_api_client -->|"calls routes"| node_fastapi
node_fastapi -->|"validates data"| node_models
node_fastapi -.->|"reads and writes"| node_profile_store
node_fastapi -->|"requests weather"| node_weather
node_fastapi -->|"requests soil"| node_soil
node_fastapi -->|"requests land cover"| node_satellite
node_fastapi -->|"requests AI triage"| node_ai_disease
node_fastapi -->|"builds advice"| node_advisory
node_fastapi -->|"normalizes farm data"| node_interop
node_weather -->|"fetches forecast"| node_openmeteo
node_soil -->|"fetches soil moisture"| node_openmeteo
node_satellite -->|"fetches LULC stats"| node_bhuvan
node_ai_disease -->|"requests AI"| node_gemini
node_app -.->|"displays map layer"| node_bhuvan
node_app -.->|"displays street map"| node_osm

click node_app "https://github.com/nirsen117/agriai/blob/main/frontend/src/App.tsx"
click node_authui "https://github.com/nirsen117/agriai/blob/main/frontend/src/AuthModal.tsx"
click node_auth "https://github.com/nirsen117/agriai/blob/main/frontend/src/firebaseAuth.ts"
click node_translations "https://github.com/nirsen117/agriai/blob/main/frontend/src/i18n.ts"
click node_api_client "https://github.com/nirsen117/agriai/blob/main/frontend/src/api.ts"
click node_farm_store "https://github.com/nirsen117/agriai/blob/main/frontend/src/farmStore.ts"
click node_diagnosis_history "https://github.com/nirsen117/agriai/blob/main/frontend/src/diagnosisHistory.ts"
click node_fastapi "https://github.com/nirsen117/agriai/blob/main/backend/app/main.py"
click node_models "https://github.com/nirsen117/agriai/blob/main/backend/app/schemas.py"
click node_profile_store "https://github.com/nirsen117/agriai/blob/main/backend/app/main.py"
click node_weather "https://github.com/nirsen117/agriai/blob/main/backend/app/providers.py"
click node_soil "https://github.com/nirsen117/agriai/blob/main/backend/app/providers.py"
click node_satellite "https://github.com/nirsen117/agriai/blob/main/backend/app/providers.py"
click node_ai_disease "https://github.com/nirsen117/agriai/blob/main/backend/app/providers.py"
click node_advisory "https://github.com/nirsen117/agriai/blob/main/backend/app/advisory.py"
click node_interop "https://github.com/nirsen117/agriai/blob/main/backend/app/interoperability.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_app,node_authui,node_translations,node_api_client,node_farm_store,node_diagnosis_history toneBlue
class node_fastapi,node_models,node_profile_store toneAmber
class node_advisory,node_interop toneMint
class node_auth,node_firebase,node_weather,node_soil,node_satellite,node_ai_disease toneRose
class node_farmer,node_openmeteo,node_bhuvan,node_gemini,node_osm toneIndigo
```

## Components

### Farmer experience

- [Farm workspace](https://github.com/nirsen117/agriai/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Sign-in dialog](https://github.com/nirsen117/agriai/blob/main/frontend/src/AuthModal.tsx): `frontend/src/AuthModal.tsx`
- [UI translations](https://github.com/nirsen117/agriai/blob/main/frontend/src/i18n.ts): `frontend/src/i18n.ts`
- [API client](https://github.com/nirsen117/agriai/blob/main/frontend/src/api.ts): `frontend/src/api.ts`
- [Farm profile sync](https://github.com/nirsen117/agriai/blob/main/frontend/src/farmStore.ts): `frontend/src/farmStore.ts`
- [Diagnosis history](https://github.com/nirsen117/agriai/blob/main/frontend/src/diagnosisHistory.ts): `frontend/src/diagnosisHistory.ts`

### Application API

- [FastAPI routes](https://github.com/nirsen117/agriai/blob/main/backend/app/main.py): `backend/app/main.py`
- [Request and response models](https://github.com/nirsen117/agriai/blob/main/backend/app/schemas.py): `backend/app/schemas.py`
- [Farm profile storage](https://github.com/nirsen117/agriai/blob/main/backend/app/main.py): `backend/app/main.py`

### Farm decision support

- [Advisory rules](https://github.com/nirsen117/agriai/blob/main/backend/app/advisory.py): `backend/app/advisory.py`
- [Interoperability feed](https://github.com/nirsen117/agriai/blob/main/backend/app/interoperability.py): `backend/app/interoperability.py`

### Providers and integrations

- [Firebase auth client](https://github.com/nirsen117/agriai/blob/main/frontend/src/firebaseAuth.ts): `frontend/src/firebaseAuth.ts`
- **Firebase services**
- [Weather provider](https://github.com/nirsen117/agriai/blob/main/backend/app/providers.py): `backend/app/providers.py`
- [Soil provider](https://github.com/nirsen117/agriai/blob/main/backend/app/providers.py): `backend/app/providers.py`
- [Satellite provider](https://github.com/nirsen117/agriai/blob/main/backend/app/providers.py): `backend/app/providers.py`
- [AI and disease adapters](https://github.com/nirsen117/agriai/blob/main/backend/app/providers.py): `backend/app/providers.py`

### Other components

- **Farmer**
- **Open-Meteo**
- **Bhuvan LULC**
- **Gemini**
- **OpenStreetMap**

## Connections

- Farmer → Farm workspace: uses (evidence: `README.md`)
- Farm workspace → API client: requests data (evidence: `frontend/src/App.tsx`)
- Farm workspace → Sign-in dialog: opens sign-in (evidence: `frontend/src/App.tsx`)
- Sign-in dialog → Firebase auth client: authenticates (evidence: `frontend/src/AuthModal.tsx`)
- API client → Firebase auth client: gets token (evidence: `frontend/src/api.ts`)
- Firebase auth client → Firebase services: signs in (evidence: `frontend/src/firebaseAuth.ts`)
- API client → Farm profile sync: syncs profile (evidence: `frontend/src/api.ts`)
- Farm profile sync → Firebase services: loads and saves
- Farm workspace → UI translations: localizes UI (evidence: `frontend/src/App.tsx`)
- Farm workspace → Diagnosis history: saves diagnosis (evidence: `frontend/src/App.tsx`)
- Diagnosis history → Firebase services: reads and writes (evidence: `frontend/src/diagnosisHistory.ts`)
- API client → FastAPI routes: calls routes (evidence: `README.md`)
- FastAPI routes → Request and response models: validates data (evidence: `backend/app/main.py`)
- FastAPI routes → Farm profile storage: reads and writes (evidence: `backend/app/main.py`)
- FastAPI routes → Weather provider: requests weather (evidence: `README.md`)
- FastAPI routes → Soil provider: requests soil (evidence: `README.md`)
- FastAPI routes → Satellite provider: requests land cover (evidence: `README.md`)
- FastAPI routes → AI and disease adapters: requests AI triage (evidence: `README.md`)
- FastAPI routes → Advisory rules: builds advice (evidence: `backend/app/main.py`)
- FastAPI routes → Interoperability feed: normalizes farm data (evidence: `backend/app/main.py`)
- Weather provider → Open-Meteo: fetches forecast (evidence: `README.md`)
- Soil provider → Open-Meteo: fetches soil moisture (evidence: `README.md`)
- Satellite provider → Bhuvan LULC: fetches LULC stats (evidence: `README.md`)
- AI and disease adapters → Gemini: requests AI (evidence: `README.md`)
- Farm workspace → Bhuvan LULC: displays map layer (evidence: `README.md`)
- Farm workspace → OpenStreetMap: displays street map (evidence: `README.md`)
