Skip to content

abdurehman760/travel-buddy

Repository files navigation

Travel Buddy

Travel Buddy is a comprehensive travel planning application designed to help users organize their trips efficiently. This README provides an overview of the project, installation instructions, usage guidelines, and contribution information.

Table of Contents


Demo

Watch the demo video to see Travel Buddy in action: Demo Video

Documentation

See Travel Buddy Documentation:
Documentation

Features

Trip Planning

  • Create and manage travel itineraries.
  • Find popular destinations and attractions.
  • Get real-time weather information for your destinations.
  • Access a collection of travel tips and advice.

Form Autocomplete and Auto-suggestion

The frontend of Travel Buddy includes advanced form features such as autocomplete and auto-suggestion to enhance user experience. These features help users quickly fill out forms by suggesting relevant options as they type, making the process faster and more efficient.

  • Autocomplete: Automatically completes user input based on previously entered data or predefined options.
  • Auto-suggestion: Provides a list of suggestions as the user types, allowing them to select the most appropriate option.

LangChain Integration

LangChain is utilized in Travel Buddy to generate detailed travel itineraries based on user preferences. Here's how it works:

  1. User Input: The user provides their travel destination, dates, and interests through the frontend form.
  2. Backend Processing: The backend receives the user input and processes it using the LangChain service.
  3. Weather Data: The WeatherService fetches real-time weather data for the specified destination and dates.
  4. OpenAI Integration: The LangChain service uses the OpenAI API to generate a detailed itinerary. The prompt includes weather information and user preferences to create a customized travel plan.
  5. Real-time Updates: The backend sends real-time updates to the frontend using Server-Sent Events (SSE) to keep the user engaged while the itinerary is being generated.

Installation

To install Travel Buddy, follow these steps:

  1. Clone the repository:
git clone https://github.com/abdurehman760/travel-buddy.git
  1. Navigate to the project directory:
cd travel-buddy
  1. Install the dependencies:
npm install

Usage

To start using Travel Buddy, run the following command:

npm start

Open your browser and navigate to http://localhost:3000 to access the application.


Contributing

We welcome contributions to Travel Buddy! To contribute, follow these steps:

  1. Fork the repository.
  2. Create a new branch:
git checkout -b feature-branch
  1. Make your changes and commit them:
git commit -m "Description of changes"
  1. Push to the branch:
git push origin feature-branch
  1. Create a pull request.

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

No packages published