PlantZ - AI-Powered Plant Healthcare Platform

Helping people grow healthier plants with AI, multilingual guidance, and smart care workflows.

---

Index

• Demo
• Screenshots
• Why PlantZ
• Core Features
• Tech Stack
• Performance Metrics
• Architecture
• Quick Start
• API Highlights
• Team
• Acknowledgments
• Support

---

Demo

Homepage visual and project demo

---

Screenshots

Home Dashboard Multilingual dashboard designed for accessible plant care.	Authentication Secure sign-in and verification with Cloudflare Turnstile.
My Plants Dashboard Track all plants, routines, and progress in one place.	AI Chat Assistant Conversational plant guidance powered by Gemini API.
Plant Avatar System Emotional avatars represent real-time plant health.	Avatar Gallery Discover playful and meaningful plant personalities.
Avatar Animations Rich animations improve engagement and retention.	Plant Health Monitor Health trends, alerts, and actionable diagnostics.
Community Hub Knowledge sharing, discussion, and community support.	Notifications Center Smart reminders for watering, treatment, and upkeep.
User Profile Personalized progress, settings, and activity history.	Settings Fine-grained preferences for a tailored experience.

---

Why PlantZ

PlantZ makes plant care practical, intelligent, and accessible. It combines conversational AI, computer vision, multilingual UX, and community features to support beginners and experienced growers alike.

---

Core Features

AI-Powered Plant Assistant

• Gemini API integration for natural, contextual conversations
• Instant responses to plant care questions
• Conversation memory for personalized assistance
• Multilingual support for broader accessibility

Interactive Plant Management

• Avatar-based plant status visualization
• Unified dashboard for monitoring all plants
• Reminder-driven care scheduling
• Progress and wellness tracking over time

Disease Detection and Diagnosis

• CNN-powered image analysis with high accuracy
• Fast symptom-based diagnosis workflow
• Actionable treatment recommendations
• Preventive care guidance

Voucher-Sponsor Ecosystem

• Resource support for users through sponsor partnerships
• Community-oriented model for affordability and reach
• Sustainable value loop for users, mentors, and sponsors

---

Tech Stack

Frontend

• React 18+
• Tailwind CSS
• Framer Motion
• Cloudinary

Backend

• Node.js 18+
• Express.js
• MongoDB 6+
• JWT Authentication
• Cloudflare Turnstile

AI and ML

• Google Gemini API
• TensorFlow
• Scikit-learn
• OpenCV

---

Performance Metrics

Component	Accuracy	Precision	Recall	F1-Score
Disease Detection	98%	98%	98%	98%
Plant Identification	95%	94%	96%	95%

Dataset size: 70,029 training images and 17,572 testing images.

---

Architecture

React Client <-> Express API <-> MongoDB
      |              |
      |              +-> Gemini API (Assistant)
      +-> TensorFlow CNN (Disease Detection)

---

Quick Start

Prerequisites

• Node.js 18+
• MongoDB 6+
• npm or yarn

Installation

git clone https://github.com/Divanshu0212/HackByte_3.0.git
cd HackByte_3.0

# root dependencies
npm install

# frontend dependencies
cd frontend
npm install
cd ..

# backend dependencies
cd backend
npm install
cd ..

Environment Setup

Create .env files in both frontend and backend directories.

Backend .env:

PORT=5000
MONGODB_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret
GEMINI_API_KEY=your_gemini_api_key
CLOUDINARY_CLOUD_NAME=your_cloudinary_name
CLOUDINARY_API_KEY=your_cloudinary_key
CLOUDINARY_API_SECRET=your_cloudinary_secret

Frontend .env:

REACT_APP_API_URL=http://localhost:5000
REACT_APP_TURNSTILE_SITE_KEY=your_turnstile_site_key

Run

# Run full project in dev mode
npm run dev

# Or run separately
cd backend
npm start

cd ../frontend
npm start

Open http://localhost:3000 in your browser.

---

API Highlights

Authentication:

POST /api/auth/register
POST /api/auth/login
POST /api/auth/verify

Plant Management:

GET    /api/plants
POST   /api/plants
PUT    /api/plants/:id
DELETE /api/plants/:id

AI Assistant:

POST /api/chat/message
GET  /api/chat/history

Disease Detection:

POST /api/diagnosis/analyze
GET  /api/diagnosis/history

---

Team

Name	Role
Aryan Kesarwani	Backend Developer
Salugu Harshita Bhanu	Frontend and Security
Prakriti Das	AI and ML Specialist
Divanshu Bhargava	AI and ML Specialist

---

Acknowledgments

• Google Gemini AI for conversational intelligence
• TensorFlow for machine learning foundations
• Plant Disease Dataset contributors
• Open-source contributors whose tools power this platform

---

Support

• Issues: GitHub Issues
• Email: shiki2hustle@gmail.com

---

If PlantZ inspired you, a star on GitHub helps us grow.
Built with care by Team PlantZ.