Travelio 🌍✈️

An intelligent AI-powered travel planner that creates personalized itineraries based on your interests, destination, and travel dates.

Overview

Travelio is a smart travel planning application that leverages artificial intelligence to generate customized travel plans tailored to your preferences. Simply provide your destination, travel dates, and interests, and let Travelio craft the perfect itinerary for your trip.

Features

• AI-Powered Itinerary Generation - Creates personalized travel plans using Google Gemini AI
• Real-Time Weather Information - Integrates Weatherbit API for accurate weather forecasts
• Stunning Destination Images - Displays beautiful location photos via Unsplash API
• Interactive Maps - Visualizes your travel route and destinations with Mapbox
• Interest-Based Planning - Customizes recommendations based on your preferences (adventure, culture, food, relaxation, etc.)
• Date-Flexible Planning - Generates itineraries for any travel duration

Technologies Used

• Google Gemini API - AI-powered travel planning and recommendations
• Weatherbit API - Real-time weather data and forecasts
• Unsplash API - High-quality destination photography
• Mapbox API - Interactive mapping and location visualization

Getting Started

Prerequisites

• Node.js (v14 or higher)
• npm or yarn package manager
• API keys for:
  • Google Gemini
  • Weatherbit
  • Unsplash
  • Mapbox

Installation

1. Clone the repository

git clone https://github.com/yourusername/travelio.git
cd travelio

2. Install dependencies

npm install

3. Create a .env file in the root directory and add your API keys

GEMINI_API_KEY=your_gemini_api_key
WEATHERBIT_API_KEY=your_weatherbit_api_key
UNSPLASH_API_KEY=your_unsplash_api_key
MAPBOX_API_KEY=your_mapbox_api_key
Mongoose="connection_string"

4. Start the application

npm start

Usage

1. Enter your desired destination
2. Select your travel start and end dates
3. Choose your interests (adventure, culture, food, nature, etc.)
4. Click "Generate Plan" to receive your personalized itinerary
5. View weather forecasts, destination images, and interactive maps
6. Export or save your travel plan

API Documentation

Google Gemini API

Used for generating intelligent travel recommendations and creating detailed itineraries based on user preferences.

Weatherbit API

Provides accurate weather forecasts for your destination during your travel dates to help you pack appropriately.

Unsplash API

Fetches high-quality images of your destination to inspire your journey and provide visual context.

Mapbox API

Creates interactive maps showing your travel route, points of interest, and location visualization.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the project
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Google Gemini for powerful AI capabilities
• Weatherbit for reliable weather data
• Unsplash for beautiful imagery
• Mapbox for excellent mapping solutions

Contact

Your Name - @jayddeeppp

Project Link: https://github.com/jaydxxp/travelio