Flora-Guide

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 37 Open GitHub ↗

No description available.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🌿 Flora: Your AI-Powered Green Companion

Flora is a next-generation plant identification and care application designed for the modern gardener. Leveraging advanced AI vision and the Gemini API, Flora transforms your smartphone into a professional botanist, providing instant identification and cinematic care guides for your green world.

## ✨ Features

- **Instant AI Identification**: Upload or take a photo of any plant to get immediate, accurate identification.
- **Cinematic Care Guides**: Detailed instructions on watering, sunlight, soil, and temperature tailored to each species.
- **AI Botanist Expert**: A dedicated chat interface to ask specific questions about propagation, troubleshooting, and seasonal care.
- **Immersive UI**: A dark, atmospheric design featuring glass-morphism, fluid animations, and a premium aesthetic.
- **Fun Facts**: Learn interesting botanical trivia about every plant you discover.

## 🚀 Tech Stack

- **Frontend**: React 18 with Vite
- **Styling**: Tailwind CSS (v4)
- **Animations**: Framer Motion (motion/react)
- **AI Engine**: Google Gemini API

## 🛠️ Getting Started

### Prerequisites

- Node.js (v18 or higher)
- A Gemini API Key (set as `GEMINI_API_KEY` in your environment)

### Installation

1. Clone the repository:
   ```bash
   git clone <repository-url>
   ```

2. Install dependencies:
   ```bash
   npm install
   ```

3. Set up your environment variables:
   Create a `.env` file in the root directory and add:
   ```env
   GEMINI_API_KEY=your_api_key_here
   ```

4. Start the development server:
   ```bash
   npm run dev
   ```

## 🎨 Design Philosophy

Flora follows the **Immersive UI** design recipe:
- **Atmospheric Depth**: Deep green radial gradients and fixed backgrounds.
- **Glass-morphism**: Translucent panels with backdrop blur for a lightweight, modern feel.
- **Typography**: Minimalist use of Inter for UI and Playfair Display for editorial accents.
- **Micro-interactions**: Purposeful animations using Framer Motion to guide user attention.

## 📄 License

This project is licensed under the MIT License.

---

*Built with Sanjarbek ❤️ for plant lovers everywhere.*

Flora-Guide

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README