This is a Python Flask application that leverages LangChain and Gemini AI to create personalized travel itineraries. Users can input details such as their starting point, specific locations, trip type, number of days, travel companions, and other preferences, and the application generates an AI-driven travel itinerary.
- AI-Powered Itinerary Generation: Uses LangChain's prompt templates and Gemini AI to generate tailored travel plans based on user inputs.
- Customizable Inputs: Accepts user preferences like starting location, travel mode, trip type, budget, and special notes.
- Flask Backend: Simple and scalable API built with Flask.
- Python 3.8+
- Git Bash (for running the installation script on Windows)
To set up the project on a Windows system, follow these steps:
-
Clone the repository:
git clone https://github.com/chiragkumargohil/ai-itinerary-planner.git cd ai-itinerary-planner -
Run the initialization script:
sh init.sh
This script will:
- Create a virtual environment.
- Install all required dependencies (like Flask, LangChain, etc.).
-
Start the Flask server:
python run.py
You can manually set up the project:
-
Clone the repository and navigate to the project directory:
git clone https://github.com/chiragkumargohil/ai-itinerary-planner.git cd ai-itinerary-planner -
Create a virtual environment and activate it:
python -m venv venv source venv/bin/activate # For Linux/Mac venv\Scripts\activate # For Windows (Command Prompt)
-
Install dependencies:
pip install -r requirements.txt
-
Run the Flask application:
python run.py
- Access the application and make an API request to
http://127.0.0.1:8888/api/itinerary. - Provide inputs like:
- Start Location: Your starting city.
- Specific Locations: Places you want to visit.
- Trip Type: Cultural, Adventure, Family, etc.
- Number of Days: Duration of the trip.
- Preferred Modes of Travel: Bus, Train, Flight, etc.
- Budget Range: Low, Moderate, High.
- Travel Companions: Family, Friends, Solo, etc.
- Interests: Food, History, Nature, etc.
- Travel Pace: Easy, Normal, Fast.
- Special Notes: Any additional requirements.
- Submit the form to receive a detailed AI-generated itinerary.
- Flask: Web framework for building the API.
- LangChain: Framework for building chains of prompts.
- Gemini AI: Language model API for itinerary generation.
- Additional libraries listed in
requirements.txt.
Endpoint: POST /api/itinerary
Request Body:
{
"start_location": "Vadodara",
"specific_locations": "Dwarka, Somnath, Gir Forest, Diu",
"number_of_days": 5,
"preferred_modes_of_travel": "Car",
"budget_range": "moderate",
"travel_companions": "Family",
"trip_type": "Cultural",
"interests": "Food",
"travel_pace": "Normal",
"constraints": "None",
"special_notes": "Please include a visit to the local markets."
}Response:
{
"status": "success",
"data": {
"additional_notes": "This itinerary focuses on Dwarka as per your request. Consider travel insurance and book accommodations in advance, especially during peak season. Pack light, comfortable clothing suitable for a temple visit and the coastal climate.",
"additional_recommendations": {
"activities": [
"Visit the Nageshwar Jyotirlinga Temple",
"Explore the Gopi Talav",
"Take a boat trip to Beyt Dwarka"
],
"food": [
"Try the local kesar mango milkshake",
"Sample the various types of farsan available"
]
},
"itinerary": {
"day_1": {
"afternoon": {
"activity": "Lunch at Hotel Highway Treat",
"location": "Near Anand (on the way to Dwarka)",
"notes": "Known for its traditional Gujarati Thali.",
"time": "1:00 PM"
},
"evening": {
"activity": "Check in to hotel and relax",
"location": "Dwarka",
"notes": "Consider hotels like Hotel Dwarkadhish or similar based on your budget.",
"time": "7:00 PM"
},
"morning": {
"activity": "Depart from Vadodara",
"location": "Vadodara",
"notes": "Start early for a comfortable drive.",
"time": "7:00 AM"
}
},
"day_2": {
"afternoon": {
"activity": "Lunch at a local restaurant",
"location": "Dwarka",
"notes": "Try local Gujarati dishes and seafood.",
"time": "1:00 PM"
},
"evening": {
"activity": "Visit Gomti Ghat and witness the evening aarti",
"location": "Dwarka",
"notes": "A serene experience by the Gomti River.",
"time": "5:00 PM"
},
"morning": {
"activity": "Visit Dwarkadhish Temple",
"location": "Dwarka",
"notes": "One of the Char Dhams, a significant pilgrimage site.",
"time": "8:00 AM"
}
},
"day_3": {
"afternoon": {
"activity": "Lunch and explore local markets",
"location": "Dwarka",
"notes": "Shop for souvenirs and local handicrafts.",
"time": "1:00 PM"
},
"evening": {
"activity": "Relax at the beach and enjoy the sunset",
"location": "Dwarka Beach",
"notes": "Enjoy the peaceful atmosphere.",
"time": "6:00 PM"
},
"morning": {
"activity": "Visit Rukmini Devi Temple",
"location": "Dwarka",
"notes": "Dedicated to Rukmini, the wife of Lord Krishna.",
"time": "9:00 AM"
}
},
"day_4": {
"afternoon": {
"activity": "Lunch at a local restaurant",
"location": "Beyt Dwarka",
"notes": "Enjoy fresh seafood.",
"time": "1:00 PM"
},
"evening": {
"activity": "Return to Dwarka and relax",
"location": "Dwarka",
"notes": "Prepare for the return journey.",
"time": "5:00 PM"
},
"morning": {
"activity": "Drive to Beyt Dwarka",
"location": "Beyt Dwarka",
"notes": "An island believed to be the original residence of Lord Krishna.",
"time": "8:00 AM"
}
},
"day_5": {
"afternoon": {
"activity": "Lunch en route",
"location": "On the way to Vadodara",
"notes": "Stop at a restaurant of your choice.",
"time": "1:00 PM"
},
"evening": {
"activity": "Arrive back in Vadodara",
"location": "Vadodara",
"notes": "End of trip.",
"time": "7:00 PM"
},
"morning": {
"activity": "Depart from Dwarka",
"location": "Dwarka",
"notes": "Start early for a comfortable drive back to Vadodara.",
"time": "8:00 AM"
}
}
},
"user_details": {
"budget": "Moderate",
"companions": "Family",
"constraints": "None",
"duration": "5 days",
"interests": "Food",
"origin": "Vadodara",
"special_notes": "",
"travel_mode": "Car",
"travel_pace": "Normal",
"trip_type": "Cultural"
}
},
}- Fork the repository.
- Create a new branch:
git checkout -b feature-branch. - Make your changes and commit them:
git commit -m 'Add some feature'. - Push to the branch:
git push origin feature-branch. - Submit a pull request.
If you have any questions or feedback, feel free to reach out!
Happy Traveling! 🌍