Skip to content

Devashish-1/herbal

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌿 Herbal Garden – Digital Medicinal Plant Explorer

Herbal Garden is a powerful web application that brings traditional medicinal plant wisdom to a modern audience. Built with cutting-edge 3D and AI technologies, it allows users to explore lifelike plant models, understand their uses, and now, locate nearby plant nurseries and interact with a smart chatbot assistant. Designed for students, plant lovers, and herbal medicine enthusiasts, this platform blends learning and discovery into a single seamless experience.


📌 Features

🔹 Core Functionalities

  • 🎍 Interactive 3D plant visualization using React Three Fiber & Three.js
  • 📚 Educational profiles for each plant: benefits, origin, and uses
  • 🧺 Personalized digital garden where users can collect and manage plants
  • 🔐 Secure user authentication with Firebase

🌟 Latest Additions

  • 📍 Nearby Plant Nurseries Map

  • 🤖 AI Chatbot for Herbal Assistance


🧱 Tech Stack

Layer Technology Stack
Frontend React.js, React-Three-Fiber, Three.js, MUI
Backend Node.js, Express.js, CORS, REST APIs
Chatbot API OpenAI , Gemini ,YOLO
Maps API Google Maps JavaScript SDK + Places API
Hosting Vercel
Auth Oauth

⚙️ How It Works

🔎 3D Plant Exploration

  • Interactive 3D garden environment with detailed plant models
  • Users can explore different medicinal plants in a virtual space
  • Each plant comes with detailed information and usage guidelines

🗺️ Nearby Nurseries Feature

🤖 AI Chatbot


🛠️ Installation and Setup

1. 📥 Clone the repository

```bash git clone https://github.com/Devashish-1/herbal.git cd herbal ```

2. 📦 Install dependencies

```bash npm install ```

3. 🔐 Configure environment variables

Create a `.env` file at the root:

```env REACT_APP_GOOGLE_MAPS_API_KEY=your_google_maps_key REACT_APP_OPENAI_API_KEY=your_openai_api_key REACT_APP_FIREBASE_CONFIG=your_firebase_config ```

4. 🚀 Run the development server

```bash npm start ```

Visit `http://localhost:3000\` to view the app.


💡 Usage

  • Landing Page: Introduction to the Herbal Garden platform
  • Virtual Garden: Explore the 3D garden environment
  • Plant Information: Access detailed medicinal plant data
  • Nursery Locator: Find nearby plant nurseries
  • Chatbot Assistant: Get instant help with plant-related queries

🌐 Live Demo Links


🤝 Contributing

We welcome contributions! To contribute:

  1. Fork this repository
  2. Create your feature branch (`git checkout -b feature/new-feature`)
  3. Commit your changes (`git commit -m 'Add some feature'`)
  4. Push to the branch (`git push origin feature/new-feature`)
  5. Open a Pull Request

📬 Contact

Have questions or suggestions? Feel free to:


Collaborator : Ashika Gupta

Enjoy exploring the world of medicinal plants with Herbal Garden! 🌱

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •