🌿 Florisha

Your intelligent plant companion — identify, learn, and care for plants with the power of AI.

---

Home

Dashboard

Plant Identification

Result

Favourite

Journal

Calendar

---

✨ Features

• 🔍 Plant Identification — Upload a photo and identify any plant instantly using the PlantNet API
• 📓 Plant Journal — Save and revisit your identified plants with personal notes
• 📅 Care Calendar — Track watering and care schedules with a visual calendar
• 🔐 Secure Auth — Email verification, bcrypt password hashing, and session management
• 🌱 Personalised Dashboard — View your plant collection, favourites, and journal entries in one place

---

🛠️ Tech Stack

Layer	Technology
Backend	Python 3.14, Flask 3.0
Database	PostgreSQL (via SQLAlchemy + psycopg2)
ORM & Migrations	Flask-SQLAlchemy, Flask-Migrate (Alembic)
AI — Plant Profiles	Google Gemini 2.0 Flash (google-genai)
Plant Identification	PlantNet API
Email	Brevo (Sendinblue) Transactional API
Auth	Flask-Login, Flask-Bcrypt
ML	scikit-learn (model.pkl)
Frontend	Jinja2 Templates, HTML/CSS/JS
Server	Gunicorn
Deployment	Render

---

📁 Project Structure

Florisha/
│
├── app.py                         # App entry point
├── config.py                      # Configuration & environment variables
├── extensions.py                  # Flask extensions (db, bcrypt, mail)
├── planet_knowledge.py            # Plant domain knowledge base & facts
├── plant_service.py               # Core plant service layer (business logic)
├── requirements.txt               # Python dependencies
├── runtime.txt                    # Python version for Render
├── .python-version                # Local Python version
├── .env                           # Environment variables (not committed)
├── .gitignore
│
├── models/                        # SQLAlchemy database models
│   ├── __init__.py
│   ├── user.py
│   ├── plant.py
│   ├── journal_entry.py
│   └── calendar_preferences.py
│
├── routes/                        # Flask Blueprints
│   ├── __init__.py
│   ├── auth_routes.py             # Register, login, logout, email verification
│   ├── ai_routes.py               # Plant identification & AI profile generation
│   ├── dashboard.py               # User dashboard
│   ├── main_routes.py             # Home & static pages
│   ├── journal_routes.py          # Plant journal CRUD
│   └── calendar_routes.py         # Care calendar
│
├── services/                      # External API integrations
│   ├── gemini_service.py          # Google Gemini AI plant profiles
│   └── plant_processor.py         # PlantNet identification processing
│
├── modules/                       # AI & recommendation logic
│   ├── ai_engine.py
│   ├── prompt_engine.py
│   ├── recommendation.py
│   └── user_profile.py
│
├── ml/
│   └── model.pkl                  # Trained ML model
│
├── utils/
│   ├── image_handler.py           # Image upload & processing
│   └── cloudinary_helper.py       # Cloudinary cloud image storage helper
│
├── static/                        # CSS, JS, Images
│   ├── css/style.css
│   ├── js/app.js
│   └── images/
│
├── templates/                     # Jinja2 HTML templates
│   ├── index.html
│   ├── dashboard.html
│   ├── identify.html
│   ├── result.html
│   ├── chat.html
│   ├── login.html
│   ├── register.html
│   ├── verify_email.html
│   ├── forgot_password.html
│   ├── reset_password.html
│   └── upload.html
│
├── migrations/                    # Alembic database migrations
│   ├── versions/
│   ├── alembic.ini
│   ├── env.py
│   ├── README.md
│   └── script.py.mako
│
├── data/                          # JSON data files
│   ├── users.json
│   └── history.json
│
└── uploads/                       # User uploaded plant images

---

🚀 Getting Started

Prerequisites

• Python 3.11+
• PostgreSQL database
• Google Gemini API key
• PlantNet API key
• Brevo (Sendinblue) API key

Local Setup

1. Clone the repository

git clone https://github.com/asvibes/Florisha.git
cd Florisha

2. Create a virtual environment

python -m venv venv
source venv/bin/activate      # Mac/Linux
venv\Scripts\activate         # Windows

3. Install dependencies

pip install -r requirements.txt

4. Create a .env file in the root directory:

SECRET_KEY=your-secret-key-here
DATABASE_URL=postgresql://user:password@host:5432/dbname
GEMINI_API_KEY=your-gemini-api-key
PLANTNET_API_KEY=your-plantnet-api-key
BREVO_API_KEY=your-brevo-api-key
MAIL_USERNAME=your-email@gmail.com

5. Run database migrations

flask db upgrade

6. Start the development server

flask run

Visit http://localhost:5000 in your browser.

---

☁️ Deployment (Render)

Florisha is deployed on Render.

Environment Variables (set in Render dashboard)

Variable	Description
DATABASE_URL	PostgreSQL connection string (auto-set by Render)
SECRET_KEY	Flask secret key for sessions
GEMINI_API_KEY	Google AI Studio API key
PLANTNET_API_KEY	PlantNet identification API key
BREVO_API_KEY	Brevo transactional email API key

Start Command

gunicorn app:app

---

🔑 API Keys

Service	Where to get it
Google Gemini	aistudio.google.com
PlantNet	my-api.plantnet.org
Brevo Email	brevo.com

---

🌱 How It Works

1. User uploads a photo of a plant on the dashboard
2. PlantNet API identifies the plant species with confidence scores
3. Results are saved to the user's journal and plant collection
4. Users can chat with the AI about their plants, set care reminders, and track watering schedules

---

📄 License

This project is for educational and personal use.

---

👩‍💻 Author

Built with 💚 by Shreya — @asvibes

---

Florisha — because every plant deserves to be known. 🌿