Travel-Guide / READM.md
karthi311's picture
Upload 5 files
ab5233c verified

A newer version of the Streamlit SDK is available: 1.44.1

Upgrade

Travel-Itinerary-Project

AI-Powered Travel Planner 🏝️✈️

An AI-driven travel itinerary generator that creates customized travel plans based on user preferences, budget, and duration. This app uses Streamlit, Hugging face, and Wikipedia API to provide detailed travel recommendations.

πŸš€ Features

  • Generates multi-day travel itineraries based on user input.
  • Suggests famous attractions, hidden gems, food spots, and accommodations.
  • Includes transportation options, cultural experiences, and local events.
  • Fetches relevant travel information from Wikipedia.
  • Simple Streamlit UI for easy interaction.

πŸ› οΈ Technologies & Libraries Used

  • Python: Core programming language
  • Streamlit: Web-based UI framework
  • Hugging face: LLaMA 3.2:1B model for itinerary generation
  • Requests: API calls to fetch travel information
  • Wikipedia API: Fetches destination details

🎯 How It Works

  1. User enters starting location, destination, budget, trip duration, purpose, and preferences.
  2. The app fetches information from Wikipedia about the destination.
  3. A detailed itinerary is generated using Ollama (LLaMA 3.2:1B).
  4. The AI-generated travel plan is displayed in the Streamlit UI.

πŸ“Œ Installation Guide

1️⃣ Clone the Repository

git clone https://github.com/karthi311/Traven-Itinerary-Project.git
cd Traven-Itinerary-Project

2️⃣ Install Dependencies

Make sure you have Python 3.8+ installed. Then, run:

pip install -r requirements.txt

4️⃣ Run the Streamlit App

Start the app using:

streamlit run main.py

πŸ“œ License

This project is open-source. Feel free to modify and improve it!