|
1 | | -# 🌾 NuKropAI — Autonomous Agriculture AI Operating System |
| 1 | +# 🌾 NuKropAI - The Ultimate AI Operating System for Agriculture |
2 | 2 |
|
3 | | -[](https://github.com/JACK-AI7/NuKropAI) |
4 | | -[](https://github.com/JACK-AI7/NuKropAI) |
5 | | -[](https://kotlinlang.org/) |
6 | | -[](https://developer.android.com/studio) |
7 | | -[](https://nodejs.org/) |
8 | | -[](https://supabase.com/) |
9 | | -[](https://groq.com/) |
| 3 | +NuKropAI is an advanced, fully-functional, real-time Agriculture OS built specifically for farmers. It leverages the latest AI technology, live government APIs, and hyperlocal weather data to provide an unmatched, 100% functional full-stack solution directly on mobile devices. |
10 | 4 |
|
11 | | -**NuKropAI** is an enterprise-grade, full-stack smart agriculture operating system designed to empower farmers, agronomists, and agricultural enterprises with AI-driven vision diagnostics, real-time market data, telemetry, and automated crop management tools. |
| 5 | +Designed and Developed by **B. JASWANTH REDDY**. |
12 | 6 |
|
13 | 7 | --- |
14 | 8 |
|
15 | | -## 🚀 Key Modules & Features |
| 9 | +## 🚀 Core Features (100% Real-World Functional) |
16 | 10 |
|
17 | | -### 🌿 1. AI Crop Disease Scanner & Soil Health Analysis |
18 | | -* **Groq Vision LLM Integration**: Multi-model fallback (`llama-3.2-11b-vision-preview`, `llama-3.2-90b-vision-preview`) for instant visual disease diagnosis on crop leaves and stems. |
19 | | -* **Treatment & Product Matching**: Returns exact disease names, severity levels, confidence scores, and real brand-name Indian agricultural products (pesticides, fungicides) with precise dosages and purchase links. |
20 | | -* **Soil Composition & NPK Estimator**: Evaluates soil texture, pH range, organic matter content, and NPK deficiency recommendations. |
| 11 | +- **AI Crop Doctor & Disease Scanner**: Uses Gemini Vision AI to analyze photos of crops/soil and instantly provides diagnosis, remedies, and treatment plans in your local language (Voice Text-to-Speech included). |
| 12 | +- **Live Mandi Prices & Autopilot**: Connects directly to government `api.data.gov.in` to fetch the absolute latest Mandi prices based on your GPS location. Includes AI trend analysis and price crash predictions. |
| 13 | +- **Background Market & Weather Alerts**: Utilizes Android WorkManager to monitor target prices in the background. If a price hike or rain is detected, a high-priority system notification is instantly sent. |
| 14 | +- **Hyperlocal Open-Meteo Weather**: No mock data. Gives you exact temperature, rain, wind, and humidity forecasts based on your exact latitude and longitude. |
| 15 | +- **AI Subsidy & Scheme Matcher**: Uses LLM intelligence to match your farm profile (State, Size, Crop) to the latest 2024 active PM-KISAN, PMFBY, and state-specific agricultural schemes. |
| 16 | +- **Cloud & Local Memory**: Powered by Supabase for authentication and Room Database for seamless, offline-first local memory saving. |
| 17 | +- **True Multilingual Support**: Change the language on the fly. The entire OS instantly translates to Hindi, Telugu, Tamil, Marathi, and English. |
21 | 18 |
|
22 | | -### 🔐 2. Enterprise Authentication & User Management |
23 | | -* **Supabase Integration**: Auth engine backed by Supabase Kotlin SDK (`auth-kt`). Supports email/password authentication, persistent user sessions, metadata synchronization, and guest modes. |
24 | | -* **Secure Profile & Data Security**: Full user profile customization with fallback metadata extraction. |
| 19 | +## 🛠 Tech Stack |
25 | 20 |
|
26 | | -### 📊 3. Live Mandi Market Intelligence & Price Ticker |
27 | | -* **Real-time Government API Ingestion**: Direct integration with `data.gov.in` Mandi APIs featuring key rotation and failover mechanisms. |
28 | | -* **Multi-language Support**: Instant translation support (English, Hindi, Telugu, Tamil, Marathi). |
29 | | -* **Price Drop & Surge Alerts**: Automated background notifications via Android `WorkManager` for critical price spikes and severe localized weather events. |
| 21 | +- **Frontend**: Kotlin, Jetpack Compose (100% Declarative UI) |
| 22 | +- **Backend / Auth**: Supabase Auth (Magic Links, OAuth) |
| 23 | +- **Local Database**: Android Room DB (SQLite) |
| 24 | +- **AI Vision / Intelligence**: OpenRouter / Google Gemini Vision APIs |
| 25 | +- **Background Processing**: Android WorkManager & Coroutines |
| 26 | +- **Real-Time Data**: Open-Meteo API, Indian Government Open Data (Agmarknet) |
30 | 27 |
|
31 | | -### 🚜 4. Smart Tractor Autopilot & Telemetry Controls |
32 | | -* **Autonomous Guidance Controls**: A-B line navigation mode, speed throttling, compass heading calculations, and coverage tracking. |
33 | | -* **Edge Watchdog & Circuit Breaker**: Resilience layer for IoT telemetry streaming across Wi-Fi, GSM, and LoRa networks. |
| 28 | +## 🎨 UI/UX Philosophy |
| 29 | +NuKropAI embraces modern, premium aesthetics: |
| 30 | +- Glassmorphism & Soft Gradients |
| 31 | +- Dark-mode first design |
| 32 | +- Vibrant color coding for clear user guidance |
| 33 | +- Haptic micro-animations |
34 | 34 |
|
35 | | -### 💰 5. Agricultural Loan & Financial Planner |
36 | | -* **Kisan Credit Card (KCC) Eligibility Calculator**: Computes scale of finance based on land acreage, crop type, and subsidized interest rates. |
37 | | -* **PM-KISAN Scheme Tracker**: Financial breakdown for agricultural subsidies and crop insurance (PMFBY). |
38 | | - |
39 | | ---- |
40 | | - |
41 | | -## 🏗 System Architecture |
42 | | - |
43 | | -```mermaid |
44 | | -graph TD |
45 | | - A[Mobile Farmer App - Android Jetpack Compose] -->|Auth & User Sync| B[Supabase Backend Service] |
46 | | - A -->|Vision Analysis & LLM Queries| C[Groq AI Inference Cloud] |
47 | | - A -->|Live Rates & Failover| D[Gov Mandi API / Local Node.js Gateway] |
48 | | - E[Web Management Portal - React + Vite] -->|Enterprise Dashboard| B |
49 | | - F[Edge IoT Gateway / Telemetry] -->|Mqtt / GSM| D |
50 | | -``` |
51 | | - |
52 | | ---- |
53 | | - |
54 | | -## 🛠 Tech Stack & Versions |
55 | | - |
56 | | -| Layer | Component | Technologies & Versions | |
57 | | -| :--- | :--- | :--- | |
58 | | -| **Mobile App** | UI Framework | Android Jetpack Compose, Material 3, Kotlin 2.0.21 | |
59 | | -| **Mobile App** | Architecture | MVVM, Coroutines, StateFlow, Room DB v2.6.1, KSP | |
60 | | -| **Mobile App** | Vision & Camera | CameraX (v1.4.1), TensorFlow Lite (v2.16.1), Coil | |
61 | | -| **Network & Auth**| Authentication | Supabase Kotlin Auth (`io.github.jan-tennert.supabase:auth-kt:3.1.4`) | |
62 | | -| **Network & Auth**| REST & Async | OkHttp 4.12.0, Ktor Client Android, Serialization | |
63 | | -| **Backend API** | Server & Middleware | Node.js v20, TypeScript, Fastify / Express, Redis | |
64 | | -| **Web Dashboard** | Frontend | React 18, Vite, TypeScript, TailwindCSS | |
65 | | - |
66 | | ---- |
67 | | - |
68 | | -## 📦 Project Directory Structure |
69 | | - |
70 | | -``` |
71 | | -agriculture-ai-os/ |
72 | | -├── app/ # Android Native Jetpack Compose Application |
73 | | -│ ├── src/main/java/com/example/ |
74 | | -│ │ ├── AuthViewModel.kt # Supabase Session & Auth Management |
75 | | -│ │ ├── GeminiVisionService.kt # Groq Vision LLM API Pipeline |
76 | | -│ │ ├── DiseaseScannerScreen.kt # CameraX AI Scanning UI |
77 | | -│ │ ├── HomeScreen.kt # Primary Farmer Operating Dashboard |
78 | | -│ │ ├── MandiApiService.kt # Live Market Rates & Key Rotation |
79 | | -│ │ ├── SupabaseClient.kt # Supabase Client Initializer |
80 | | -│ │ └── ... |
81 | | -│ └── build.gradle.kts |
82 | | -├── backend/ # Node.js TypeScript API Gateway & Telemetry Service |
83 | | -│ ├── src/ |
84 | | -│ ├── docker-compose.yml |
85 | | -│ └── package.json |
86 | | -├── web/ # React + Vite Enterprise Web Portal |
87 | | -│ ├── src/ |
88 | | -│ └── package.json |
89 | | -├── build.gradle.kts # Root Project Gradle Configuration |
90 | | -├── settings.gradle.kts |
91 | | -└── README.md |
92 | | -``` |
93 | | - |
94 | | ---- |
95 | | - |
96 | | -## ⚙️ Setup & Building Instructions |
97 | | - |
98 | | -### 📱 Android Application (Mobile) |
99 | | - |
100 | | -#### Prerequisites: |
101 | | -* **JDK**: OpenJDK 17 or Android Studio Bundled JBR |
102 | | -* **Android Studio**: Ladybug / Koala or newer (SDK 34+) |
103 | | - |
104 | | -#### Steps: |
105 | | -1. **Clone the repository**: |
106 | | - ```bash |
107 | | - git clone https://github.com/JACK-AI7/NuKropAI.git |
108 | | - cd NuKropAI |
109 | | - ``` |
110 | | -2. **Build Release APK**: |
111 | | - ```bash |
112 | | - ./gradlew assembleRelease --no-daemon |
113 | | - ``` |
114 | | -3. The generated release APK will be located at: |
115 | | - `app/build/outputs/apk/release/app-release.apk` |
116 | | - |
117 | | ---- |
118 | | - |
119 | | -### 🖥️ Backend Service (Node.js) |
120 | | - |
121 | | -1. **Navigate to the backend directory**: |
122 | | - ```bash |
123 | | - cd backend |
124 | | - ``` |
125 | | -2. **Install dependencies**: |
126 | | - ```bash |
127 | | - npm install |
128 | | - ``` |
129 | | -3. **Start Development Server**: |
130 | | - ```bash |
131 | | - npm run dev |
132 | | - ``` |
133 | | - |
134 | | ---- |
135 | | - |
136 | | -### 🌐 Web Dashboard (React + Vite) |
137 | | - |
138 | | -1. **Navigate to the web directory**: |
139 | | - ```bash |
140 | | - cd web |
141 | | - ``` |
142 | | -2. **Install dependencies**: |
143 | | - ```bash |
144 | | - npm install |
145 | | - ``` |
146 | | -3. **Launch Dev Server**: |
147 | | - ```bash |
148 | | - npm run dev |
149 | | - ``` |
150 | | - |
151 | | ---- |
152 | | - |
153 | | -## 📄 License & Release Notes |
154 | | - |
155 | | -* **Version**: `1.0.0` |
156 | | -* **Release Date**: August 2026 |
157 | | -* **Maintainer**: NuKropAI Core Engineering Team |
158 | | -* **License**: MIT License |
| 35 | +## 📜 License |
| 36 | +This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details. |
| 37 | +**Copyright (c) 2024 B. JASWANTH REDDY** |
0 commit comments