https://github.com/imhardik1606/tripmate
AI Travel Planner 🌍✈️ An AI-powered travel assistant that suggests hotels and daily itineraries based on your destination, budget, and travel details using Google Gemini. Plan smarter, travel better! 🚀
https://github.com/imhardik1606/tripmate
firebase firebase-auth gemini-ai gemini-api oauth react-icons reactjs shacdn tailwindcss
Last synced: 3 months ago
JSON representation
AI Travel Planner 🌍✈️ An AI-powered travel assistant that suggests hotels and daily itineraries based on your destination, budget, and travel details using Google Gemini. Plan smarter, travel better! 🚀
- Host: GitHub
- URL: https://github.com/imhardik1606/tripmate
- Owner: imHardik1606
- Created: 2025-02-23T14:17:20.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-09T13:37:27.000Z (over 1 year ago)
- Last Synced: 2025-03-09T14:27:04.151Z (over 1 year ago)
- Topics: firebase, firebase-auth, gemini-ai, gemini-api, oauth, react-icons, reactjs, shacdn, tailwindcss
- Language: JavaScript
- Homepage:
- Size: 2.53 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AI Travel Planner
## 📌 Project Overview
Gemini Travel Planner is an AI-powered travel assistant that helps users plan their trips efficiently. By leveraging Google Gemini, the project generates a curated list of hotels and daily itineraries based on user input.
## 🚀 Features
- 📍 **Destination-Based Recommendations**: Suggests the best hotels and places to visit based on the chosen destination.
- 💰 **Budget-Friendly Suggestions**: Offers recommendations within the user's specified budget.
- 📅 **Custom Itineraries**: Plans daily activities based on the number of travel days.
- 👥 **Group Travel Support**: Adjusts recommendations based on the number of travelers.
- 🤖 **AI-Powered Assistance**: Uses Google Gemini to generate optimized travel plans.
## 🔧 Tech Stack
- **Frontend**: Reactjs, TailwindCSS, Shadcn-ui, React Icons Library
- **Authentication**: Google's OAuth
- **APIs**: Google's Places API, Gemini API, Photos API, Google Maps API
- **Database**: Firebase
- **AI Model**: Google Gemini API
## 📂 Project Structure
```
📦 frontend
┣ 📂 public # public Components
┣ 📂 src # API keys and configuration
┣ 📜 package.json # Project dependencies
┣ 📜 README.md # Documentation
```
## 🚀 Installation & Setup
### 1️⃣ Clone the Repository
```sh
git clone https://github.com/yourusername/gemini-travel-planner.git
cd gemini-travel-planner
```
### 2️⃣ Install Dependencies
```sh
npm install
```
### 3️⃣ Configure Environment Variables
Create a `.env` file in the frontend directory and add the required API keys:
```sh
GEMINI_API_KEY=your_api_key_here
```
### 4️⃣ Run the Application
```sh
npm run dev
```
## 🎯 Usage
1. Enter your **destination, budget, number of days, and travelers**.
2. Click **Generate Plan** to receive AI-generated recommendations.
3. Browse **hotel suggestions** and **daily itineraries**.
4. Modify and refine your travel plan as needed.
## 📌 Future Enhancements
- ✈️ Flight recommendations
- 🏕️ Adventure-based travel plans
- 📍 Map integration for better navigation
## 🤝 Contributing
Contributions are welcome! Feel free to open issues and pull requests.
## 📜 License
This project is licensed under the MIT License.
---
💡 *Plan your trips smarter with Gemini Travel Planner!*