🌿 Green-Sense - AI Plant Health Analyzer

Professional plant identification with AI-powered health assessment - 100% Free APIs, Production-Ready, Fully Deployable

✨ Features

🔬 Multi-AI Plant Identification - Plant.id, Google Gemini 2.5, PlantNet APIs
🛡️ Smart Image Validation - Detects if uploaded image contains a plant
🦠 Disease Detection - Identifies plant diseases and health issues
💚 Health Assessment - AI-powered condition analysis
🌱 Species Recognition - Common & scientific names, plant families
📋 Tailored Care Guides - Species-specific recommendations
📅 Seasonal Calendar - Year-round care schedule
🔧 Troubleshooting - Common problems and solutions
📄 PDF Reports - Professional reports with plant images
💰 100% FREE - No credit card required, 2,000+ free IDs/day
🚀 Production-Ready - Fully deployable on Vercel, Render, Railway

🏗️ Architecture

User Upload Image
    ↓
Image Validation (Gemini 2.5) - Ensures it's a plant
    ↓
Plant Identification:
  1. Plant.id API (Primary) - 100/day FREE
  2. Google Gemini 2.5 Flash (Backup) - 1,500/day FREE
  3. PlantNet API (Backup) - 500/day FREE
  4. Knowledge Base (Always works) - Unlimited
    ↓
Care Recommendations (Knowledge Base)
    ↓
PDF Report Generation

Four-Tier Fallback System:

Never fails completely
Automatic fallback to next API if one fails
Knowledge base provides general care if all APIs unavailable

🚀 Quick Start

1. Clone & Install

git clone https://github.com/YOUR_USERNAME/Green-Sense.git
cd Green-Sense
npm install

2. Get FREE API Keys

Google Gemini (Required) - 1,500/day FREE

Visit: https://aistudio.google.com/app/apikey
Sign in with Google account
Click "Create API Key"
Copy the key (starts with AIza...)

Plant.id (Optional) - 100/day FREE

Visit: https://web.plant.id/
Sign up (free, no credit card)
Get API key from dashboard

PlantNet (Optional) - 500/day FREE

Visit: https://my.plantnet.org/
Create account
Get API key

3. Configure Environment

cp .env.example .env

Edit .env file:

# Required - For plant identification and image validation
GEMINI_API_KEY=your_gemini_api_key_here

# Optional - For enhanced plant identification
PLANTID_API_KEY=your_plantid_api_key_here

# Optional - Additional fallback
PLANTNET_API_KEY=your_plantnet_api_key_here

4. Start Server

npm start

5. Open in Browser

http://localhost:5000

📊 What You Get

Upload a Plant Image:

Step 0/3: Validating image contains a plant...
✅ Plant image validated (confidence: high)
Detected: Monstera plant

Step 1/3: Analyzing YOUR plant with Plant.id AI...
🌿 Plant.id identified: Monstera (Monstera deliciosa)
📊 Confidence: 87.3%
🏷️  Family: Araceae
💚 Health: healthy

Step 2/3: Generating tailored care guide...
✅ Care recommendations generated!

🌿 PLANT ANALYSIS REPORT

📋 IDENTIFICATION
• Common Name: Monstera
• Scientific Name: Monstera deliciosa
• Family: Araceae
• Confidence: 87.3%

💚 HEALTH ASSESSMENT
• Status: healthy
• No diseases detected

💚 CARE REQUIREMENTS
• Watering: Water when top 1-2 inches dry
• Light: Bright, indirect light
• Humidity: 50-60%, mist regularly
• Temperature: 65-80°F (18-27°C)
• Soil: Well-draining with peat moss
• Fertilizer: Monthly during growing season

📅 SEASONAL CARE GUIDE
[Spring, Summer, Fall, Winter tasks]

🔧 TROUBLESHOOTING GUIDE
[Yellow leaves, brown tips, wilting, etc.]

Upload a Non-Plant Image:

Step 0/3: Validating image contains a plant...
❌ Not a plant detected: cat
Reason: Image shows an animal, not a plant

Error: This appears to be cat, not a plant. 
Please upload an image of a plant.

💰 Cost Breakdown

Service	Daily Limit	Features	Cost
Google Gemini 2.5	1,500	Vision + ID + Validation	FREE
Plant.id	100	ID + Health + Disease	FREE
PlantNet	500	ID + Scientific names	FREE
Knowledge Base	Unlimited	Care + Tips + Troubleshooting	FREE
Total	2,100+	Everything	$0/month

🌐 Deploy to Vercel

One-Click Deploy

Manual Deploy

# Install Vercel CLI
npm i -g vercel

# Deploy
vercel

# Add environment variables in Vercel dashboard:
# - GEMINI_API_KEY
# - PLANTID_API_KEY (optional)
# - PLANTNET_API_KEY (optional)

🎯 Tech Stack

Backend: Node.js, Express
AI APIs:
- Google Gemini 2.5 Flash (vision + text)
- Plant.id API (plant identification)
- PlantNet API (botanical database)
Image Processing: Sharp
PDF Generation: PDFKit
Knowledge Base: JSON databases
Deployment: Vercel serverless functions

📁 Project Structure

Green-Sense/
├── app.js                 # Main Express server
├── public/
│   └── index.html        # Frontend UI
├── utils/
│   ├── gemini-vision.js  # Gemini 2.5 integration
│   ├── plantid-api.js    # Plant.id integration
│   ├── care-engine.js    # Care recommendations
│   └── image-validator.js # Plant image validation
├── knowledge/
│   ├── plant-care.json   # Care database
│   └── plant-diseases.json # Disease database
├── .env                  # Environment variables
└── package.json          # Dependencies

🔒 Privacy & Security

✅ Images processed in memory, deleted after analysis
✅ No data stored on server
✅ No user tracking or analytics
✅ API keys stored securely in environment variables
✅ CORS enabled for secure cross-origin requests

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Google Gemini - For powerful vision AI capabilities
Plant.id - For specialized plant identification
PlantNet - For botanical database access
Open-source community - For amazing tools and libraries

📧 Contact

For questions or support, please open an issue on GitHub.

Built with 🌿 for plant lovers everywhere

Upload your plant image and get instant analysis! 🎉

🎯 What You Get

When you upload a plant image, the AI provides:

🌿 PLANT ANALYSIS REPORT

1. PLANT IDENTIFICATION

Specific species or genus
Common and scientific names
Key identifying features
Plant family

2. HEALTH ASSESSMENT

Overall health status
Leaf condition analysis
Disease/pest detection
Stress indicators

3. SPECIFIC OBSERVATIONS

Detailed description of YOUR plant
Leaf characteristics
Growth pattern
Visible issues

4. CARE RECOMMENDATIONS

Watering schedule (for this species)
Light requirements
Soil preferences
Fertilization guide
Pruning tips
Temperature/humidity needs

5. IMMEDIATE ACTIONS

Urgent issues to address
Specific treatments
Preventive measures

6. LONG-TERM CARE

Seasonal care tips
Common problems
Growth expectations
Repotting guidance

💰 Cost

$0/month - Gemini API Free Tier:

15 requests per minute
1,500 requests per day
1 million requests per month

Perfect for personal use and portfolio projects!

🛠️ Tech Stack

Component	Technology
AI Vision	Google Gemini 1.5 Pro
Backend	Node.js + Express
Image Processing	Sharp
PDF Generation	PDFKit
Frontend	Vanilla JS + TailwindCSS

📁 Project Structure

green-sense/
├── app.js                 # Main server with Gemini integration
├── package.json           # Dependencies
├── .env                   # API key (not in git)
├── .env.example           # Configuration template
├── public/
│   └── index.html         # Frontend interface
├── upload/                # Temporary image storage
└── reports/               # Generated PDF reports

🔧 API Endpoints

`POST /analyze`

Input: Multipart form data with image file
Process: Analyzes image with Gemini Vision AI
Output: JSON with analysis and base64 image

`POST /download`

Input: JSON with analysis text and image
Process: Generates PDF report
Output: Downloadable PDF file

🎓 For Your Resume

Green-Sense - AI-Powered Plant Health Analysis Platform

• Developed full-stack web application for plant identification and health assessment
• Integrated Google Gemini 1.5 Vision API for accurate image analysis and species identification
• Implemented multipart file upload with Sharp for image optimization
• Built PDF report generation system with embedded images using PDFKit
• Designed RESTful API with Express.js for seamless frontend-backend communication
• Optimized for zero-cost deployment using free tier APIs ($0/month operational cost)
• Demonstrated problem-solving by migrating from unstable APIs to reliable Gemini platform

Tech Stack: Node.js, Express.js, Google Gemini AI, Sharp, PDFKit, TailwindCSS

🎤 Interview Talking Points

Q: Tell me about this project

"Green-Sense is an AI-powered plant health analyzer that uses Google's Gemini Vision API to identify plant species and assess their health from photos. Users upload images and receive detailed, species-specific care recommendations. The challenge was integrating vision AI reliably while maintaining zero operational costs."

Q: What was the biggest technical challenge?

"Initially, I tried using Hugging Face's free vision models, but they had reliability issues with the new Inference Providers API. I pivoted to Google's Gemini 1.5 Flash, which offers excellent vision capabilities with a generous free tier. This taught me the importance of API evaluation and having backup plans."

Q: How does it work technically?

"The backend uses Express with Multer for file uploads. Images are processed with Sharp for optimization, then sent to Gemini's vision model with a detailed botanical analysis prompt. The AI identifies the species, assesses health, and provides tailored care advice. Results are displayed in the browser and can be downloaded as PDF reports with PDFKit."

Q: How would you scale this?

"Current architecture handles 1,500 requests/day on free tier. For scaling, I'd implement Redis caching for repeated plant species, add user accounts with history tracking, implement rate limiting per user, and potentially add a CDN for static assets. Could also batch similar requests or use webhooks for async processing."

🚀 Deployment

Option 1: Render (Recommended)

Push code to GitHub
Connect Render to repository
Add GEMINI_API_KEY environment variable
Deploy!

Option 2: Railway

Connect Railway to GitHub
Set environment variable
Auto-deploy on push

Option 3: Vercel (Serverless)

Install Vercel CLI: npm i -g vercel
Run: vercel
Add environment variable in dashboard

🔒 Security Best Practices

✅ Never commit .env file - Already in .gitignore ✅ Use environment variables - API keys not in code ✅ Validate file uploads - Multer configuration ✅ Clean up temp files - Automatic deletion after processing ✅ Rate limiting - Built into Gemini API ✅ CORS configured - Secure cross-origin requests

🐛 Troubleshooting

"Error: GEMINI_API_KEY not found"

Check .env file exists
Verify API key is correct
Restart server after changing .env

"API quota exceeded"

Free tier: 1,500 requests/day
Wait 24 hours or upgrade plan
Check usage: https://aistudio.google.com/

"Image upload fails"

Max file size: 10MB
Supported formats: JPG, PNG, WEBP
Check upload/ directory permissions

"PDF download not working"

Ensure reports/ directory exists
Check disk space
Verify PDFKit installation

📚 Documentation

Gemini API: https://ai.google.dev/docs
Express.js: https://expressjs.com/
Sharp: https://sharp.pixelplumbing.com/
PDFKit: https://pdfkit.org/

🎯 Future Enhancements

User accounts and plant history
Plant health tracking over time
Community features (share plants)
Mobile app (React Native)
Multiple language support
Plant disease database
Care reminders and notifications
Integration with plant care APIs

📄 License

MIT License - Feel free to use for your portfolio!

🙏 Acknowledgments

Google Gemini AI for vision capabilities
TailwindCSS for beautiful UI
The open-source community

📞 Support

Having issues? Check:

.env file is configured correctly
Gemini API key is valid
Dependencies are installed: npm install
Server is running: npm start
Port 5000 is not in use

Made with 💚 for plant lovers and AI enthusiasts

Perfect for: Portfolio projects, job applications, learning AI integration

Status: ✅ Production Ready | 💰 $0/month | 🚀 Deploy Anywhere

Name		Name	Last commit message	Last commit date
Latest commit History 25 Commits
api		api
knowledge		knowledge
netlify/functions		netlify/functions
public		public
reports		reports
upload		upload
utils		utils
.env.example		.env.example
.gitignore		.gitignore
.npmrc		.npmrc
README.md		README.md
app.js		app.js
netlify.toml		netlify.toml
package-lock.json		package-lock.json
package.json		package.json
vercel.json		vercel.json

Om7035/Green-Sense

Folders and files

Latest commit

History

Repository files navigation

🌿 Green-Sense - AI Plant Health Analyzer

✨ Features

🏗️ Architecture

Four-Tier Fallback System:

🚀 Quick Start

1. Clone & Install

2. Get FREE API Keys

Google Gemini (Required) - 1,500/day FREE

Plant.id (Optional) - 100/day FREE

PlantNet (Optional) - 500/day FREE

3. Configure Environment

4. Start Server

5. Open in Browser

📊 What You Get

Upload a Plant Image:

Upload a Non-Plant Image:

💰 Cost Breakdown

🌐 Deploy to Vercel

One-Click Deploy

Manual Deploy

🎯 Tech Stack

📁 Project Structure

🔒 Privacy & Security

🤝 Contributing

📝 License

🙏 Acknowledgments

📧 Contact

🎯 What You Get

🌿 PLANT ANALYSIS REPORT

💰 Cost

🛠️ Tech Stack

📁 Project Structure

🔧 API Endpoints

POST /analyze

POST /download

🎓 For Your Resume

🎤 Interview Talking Points

🚀 Deployment

Option 1: Render (Recommended)

Option 2: Railway

Option 3: Vercel (Serverless)

🔒 Security Best Practices

🐛 Troubleshooting

"Error: GEMINI_API_KEY not found"

"API quota exceeded"

"Image upload fails"

"PDF download not working"

📚 Documentation

🎯 Future Enhancements

📄 License

🙏 Acknowledgments

📞 Support

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Languages

`POST /analyze`

`POST /download`

Packages