Skip to content

samy1406/WanderGenie

Repository files navigation

WanderGenie ✨

WanderGenie is your smart travel assistant, designed to make planning your next adventure seamless and enjoyable. Generate personalized itineraries, discover hidden gems, and manage your travel plans all in one place.


What is WanderGenie?

WanderGenie is an intelligent travel planning application that helps users create customized travel itineraries based on their interests, budget, and schedule. Whether you're planning a weekend getaway or a month-long expedition, WanderGenie takes the stress out of planning so you can focus on making memories.


Key Features

  • ✈️ AI-Powered Itinerary Generation: Automatically create detailed day-by-day plans based on your travel preferences.
  • 📍 Interactive Map View: Visualize your trip, discover points of interest, and plan your routes effectively.
  • 💰 Budget Tracking: Keep an eye on your expenses to stay within your budget.
  • ☁️ Weather Forecasts: Get up-to-date weather information for your destination.
  • 📝 Collaborative Planning: Share your trip with friends and family to plan together.
  • 🚀 Smart Suggestions: Get real-time suggestions to adapt your plans based on changing conditions.

Showcase

1. Plan Your Trip with a Simple Form

Provide your origin, destination, duration, and interests to get started.

image

2. Get a Detailed, AI-Generated Itinerary

WanderGenie creates a complete day-by-day plan which you can explore.

image

3. Dive Into Daily Activities

Expand each day to see a checklist of activities, including tips and suggestions.

image

4. All Your Trip Details in One Place

Get estimates for your trip cost, a list of must-do activities, and a checklist of things to carry.

image

5. Convenient Travel & Booking Options

The app suggests various travel options, including train, bus, and flight details with cost and duration estimates.

image

6. Smart Suggestion on the GO!

The app can quickly suggest you alternative if you are not happy or interested on the current option. If you like that you can update the current day itinerary with new option.

image image

Getting Started

Follow these instructions to get a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

Make sure you have the following installed on your system:

  • Node.js (v18.x or later recommended)
  • npm (or Yarn)

Installation

  1. Clone the repository:

    git clone [https://github.com/samy1406/WanderGenie.git](https://github.com/samy1406/WanderGenie.git)
  2. Navigate to the project directory:

    cd WanderGenie
  3. Install dependencies:

    npm install
  4. Set up environment variables: Create a .env file in the root of the project and add the necessary API keys and configuration variables. You can use .env.example as a template.

    # Example
    API_KEY_NAME=your_api_key_here
  5. Run the application:

    npm start

    The application should now be running on http://localhost:3000.


Where to Get Help

If you have a question, find a bug, or want to suggest a new feature, please feel free to open an issue. We are more than happy to help!


Contributing

We love contributions from the community! If you're interested in helping improve WanderGenie, please take a look at our Contributing Guidelines to get started.

This project adheres to our Code of Conduct. By participating, you are expected to uphold this code.


Maintainers

WanderGenie is built and maintained by:

  • vatsal21770 - Project Owner
  • aki1608 - Project Owner
  • samy1406 - Project Owner

License

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

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages