Travel-Guide / READM.md
karthi311's picture
Upload 5 files
ab5233c verified
|
raw
history blame
1.81 kB
# 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
```sh
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:
```sh
pip install -r requirements.txt
```
### 4️⃣ Run the Streamlit App
Start the app using:
```sh
streamlit run main.py
```
## πŸ“œ License
This project is open-source. Feel free to modify and improve it!