RAKSHA - Real-time AI Crop Health Shield 🛡️

Your Harvest's Guardian Angel

RAKSHA is an AI-powered crop disease detection system that helps farmers identify pests and diseases in real-time by simply uploading a photo. Get instant diagnosis, severity assessment, and treatment recommendations.

🏗️ Project Structure

raksha/
  frontend/      # Next.js web application (TypeScript + TailwindCSS)
  backend/       # Node.js/Express API server
  docs/          # API documentation
  README.md      # This file
  DEV_NOTES.md   # Development notes and next steps

🚀 Quick Start

Prerequisites

• Node.js 18+ with npm 11
• Modern web browser

Backend Setup

1. Navigate to backend directory:

   cd backend

2. Install dependencies:

   npm install

3. Create environment file:

   copy .env.example .env

4. Start development server:

   npm run dev

   Backend will run on http://localhost:3001

Frontend Setup

1. Navigate to frontend directory (in a new terminal):

   cd frontend

2. Install dependencies:

   npm install

3. Create environment file:

   copy .env.local.example .env.local

4. Start development server:

   npm run dev

   Frontend will run on http://localhost:3000

🎯 Usage

1. Ensure both backend and frontend are running
2. Open http://localhost:3000 in your browser
3. Upload a crop image (leaf, fruit, or plant area)
4. Wait for RAKSHA to analyze the image (~2-5 seconds)
5. Review the diagnosis, severity, and treatment recommendations

📡 API Endpoints

Health Check

GET http://localhost:3001/health

Analyze Crop Image

POST http://localhost:3001/api/guardian/protect
Content-Type: multipart/form-data

Field: image (file)

See docs/api.md for complete API documentation.

🛠️ Tech Stack

Frontend:

• Next.js 15 with App Router
• TypeScript
• TailwindCSS
• React

Backend:

• Node.js with Express
• TypeScript
• Multer (file uploads)
• CORS enabled

📝 Development Notes

See DEV_NOTES.md for:

• Implementation tradeoffs
• Next steps for production
• AI integration roadmap

📄 License

MIT License - Built for farmers, by developers who care.