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.
Watch the demo video to see Travel Buddy in action: Demo Video
See Travel Buddy Documentation:
Documentation
- 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.
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 is utilized in Travel Buddy to generate detailed travel itineraries based on user preferences. Here's how it works:
- User Input: The user provides their travel destination, dates, and interests through the frontend form.
- Backend Processing: The backend receives the user input and processes it using the LangChain service.
- Weather Data: The WeatherService fetches real-time weather data for the specified destination and dates.
- 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.
- 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.
To install Travel Buddy, follow these steps:
- Clone the repository:
git clone https://github.com/abdurehman760/travel-buddy.git
- Navigate to the project directory:
cd travel-buddy
- Install the dependencies:
npm install
To start using Travel Buddy, run the following command:
npm start
Open your browser and navigate to http://localhost:3000
to access the application.
We welcome contributions to Travel Buddy! To contribute, follow these steps:
- Fork the repository.
- Create a new branch:
git checkout -b feature-branch
- Make your changes and commit them:
git commit -m "Description of changes"
- Push to the branch:
git push origin feature-branch
- Create a pull request.
This project is licensed under the MIT License. See the LICENSE file for details.