Vaiage

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #typescript #go #linux #java #kubernetes #awesome-list #pytorch #ios #openai #open-source

(★ 17)

This is a code repo for Application Track of CS194

Vaiage Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# This is a code repo for Application Track of CS194

![poster](https://raw.githubusercontent.com/Binwen6/Vaiage/main/Vaiage.svg "poster")

## Overview

Vaiage is an AI-powered travel planning application designed to help users create personalized and optimized travel itineraries. It assists with everything from initial preference gathering to detailed daily plans, including attraction recommendations, route optimization, budget estimation, and car rental advice.

## Features

- **Conversational AI Chatbot**: Collects user travel preferences (destination, duration, budget, interests, etc.) through an interactive chat.
- **Personalized Attraction Recommendations**: Leverages AI to suggest points of interest tailored to user preferences, considering factors like weather, ratings, and price levels.
- **Dynamic Itinerary Planning**: Generates optimized daily travel plans, distributing selected attractions efficiently across the trip duration.
- **Route Optimization**: Calculates optimal travel routes between planned attractions to minimize travel time.
- **Weather Integration**: Fetches weather forecasts and incorporates this information into travel planning and recommendations.
- **Car Rental Assistance**: Provides AI-driven advice on whether a car rental is beneficial and can search for car rental options.
- **Budget Estimation**: Estimates the overall trip budget, breaking down costs for accommodation, food, transport, attractions, and potential car rental/fuel expenses.
- **Map Data Generation**: Prepares data for visualizing attractions and routes on a map interface.

## Tech Stack

- **Core Language**: Python
- **AI & LLMs**: Langchain, OpenAI API (GPT-4o, GPT-3.5-turbo)
- **Mapping & Geolocation**: Google Maps Platform APIs (Geocoding, Places, Directions, Distance Matrix)
- **Car Rentals**: RapidAPI (Booking.com API endpoint)
- **Weather**: Open-Meteo API
- **Fuel Prices**: Custom local data source (`data/global_fuel_prices.json`) and OpenAI for country/price estimation.
- **Networking**: `http.client` (for car rental API), `requests` (for weather API)
- **Route Optimization**: `networkx` (for TSP solving)

## Usage

1.  **Get API Keys**: Obtain your own API keys for:
    *   OpenAI
    *   Google Maps Platform
    *   RapidAPI (for Booking.com via car_rental_api.py)
2.  **Clone the Repository**: `git clone <repository_url>`
3.  **Install Dependencies**: `pip install -r requirements.txt`
4.  **Configure API Keys**: You will likely need to set your API keys as environment variables or in a configuration file (details should be checked within the codebase, e.g., `.env` file usage in `agents/information_agent.py`).
5.  **Run the Application**: `python main.py`

Vaiage

Vaiage Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Vaiage

Vaiage Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README