Skip to content

pparthiv/ViatorAI

Repository files navigation

ViatorAI - Your Intelligent Travel Companion

ViatorAI Banner

Overview

ViatorAI is an advanced travel companion application that combines real-time weather data, intelligent location suggestions, and comprehensive travel planning features. Built with modern web technologies, it offers a seamless experience for travelers seeking weather-smart journey planning.

✨ Key Features

  • Real-time Weather Tracking: Get accurate weather forecasts and air quality data worldwide
  • Smart Location Planning: Discover nearby attractions based on weather conditions
  • Travel Insights: Access local news, events, and personalized travel recommendations
  • Interactive Map: Visualize your travel plans with an intuitive mapping interface
  • Air Quality Monitoring: Make informed decisions with detailed air quality data
  • Dynamic Weather Visualization: Multiple weather map layers for comprehensive analysis

🚀 Technologies

  • Frontend: React 18, Next.js 14
  • Styling: Tailwind CSS, Framer Motion
  • Maps: Leaflet with OpenStreetMap
  • Weather Data: OpenWeatherMap API
  • News Integration: NewsAPI
  • AI Integration: Google Gemini AI
  • State Management: React Hooks
  • Type Safety: TypeScript

🛠️ Getting Started

  1. Clone the repository:
git clone https://github.com/pparthiv/ViatorAI.git
  1. Install dependencies:
cd ViatorAI
npm install
  1. Create a .env file in the root directory with your API keys:
NEXT_PUBLIC_GEMINI_API_KEY=your_gemini_api_key
NEXT_PUBLIC_OPENWEATHERMAP_API_KEY=your_openweathermap_api_key
NEXT_PUBLIC_NEWS_API_KEY=your_news_api_key
NEXT_PUBLIC_DAILY_NEWS_LIMIT=5
NEXT_PUBLIC_OPENWEATHER_SPIRAL_API_KEY=your_another_openweather_api_key
  1. Start the development server:
npm run dev

🌟 Features in Detail

Weather Intelligence

  • Real-time weather data and forecasts
  • Air quality monitoring
  • Weather pattern analysis
  • Custom weather alerts

Location Services

  • Interactive mapping
  • Points of interest discovery
  • Route planning
  • Location-based recommendations

Travel Planning

  • Smart itinerary suggestions
  • Weather-based activity recommendations
  • Local news and events integration
  • Customizable travel preferences

User Experience

  • Responsive design
  • Intuitive interface
  • Real-time updates
  • Seamless navigation

🤝 Contributing

We welcome contributions! Please feel free to submit a Pull Request.

📝 License

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

🙏 Acknowledgments

  • OpenWeatherMap for weather data
  • NewsAPI for news integration
  • OpenStreetMap for mapping services
  • Google for Gemini AI capabilities

📧 Contact

For any queries or suggestions, please open an issue in the repository.


Made with ❤️ by Parthiv Purkayastha

About

Resources

License

Stars

1 star

Watchers

1 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors