Travel-Seek

# Travel-Seek

Travel-Seek is an AI-powered travel planning assistant that helps you create personalized travel itineraries and answer travel-related questions. The application leverages a coordinated multi-agent team (powered by Agno + Groq) and optionally enriches results with real Google Places & Directions data via a custom MCP server plus verified OpenWeather forecasts.

## Features

- **Multi-Agent Travel Planning**: Four specialized AI agents (Research, Itinerary, Budget, Local Expert) coordinate to produce comprehensive travel plans.
- **Google Places Integration**: Real ratings, reviews, hours, and directions via a custom MCP server backed by the Google Maps API.
- **OpenWeather Integration**: Verified current conditions and 5-day forecasts, with explicit long-range limitations instead of fabricated weather detail.
- **Conversational Planning**: Chat naturally to build and refine your plan with session memory.
- **Graceful Fallback**: Works without a Google Maps key — falls back to DuckDuckGo search with a visible warning.
- **Standalone MCP Server**: The Places MCP server works independently with Claude Desktop or any MCP-compatible client.

## Installation

### 1. Clone the Repository
```sh
git clone https://github.com/Mukku27/Travel-Seek.git
cd Travel-Seek
```

### 2. Create and Activate a Virtual Environment
```sh
python3 -m venv .venv
source .venv/bin/activate  # On Windows use `.venv\Scripts\activate`
```

### 3. Install Dependencies
```sh
pip install -r requirements.txt
```

### 4. Set Up Environment Variables
Create a `.env` file in the root directory:
```sh
GROQ_API_KEY='your_groq_api_key'
GOOGLE_MAPS_API_KEY='your_google_maps_api_key'   # Optional — enables Places & Directions
OPENWEATHERMAP_API_KEY='your_openweather_api_key' # Optional — enables verified weather tools
SERPI_API_KEY='your_serpi_api_key'

# Optional: enable Tavily search alongside SerpAPI/DuckDuckGo
USE_TAVILY='true'
TAVILY_API_KEY='your_tavily_api_key'
```

The `GOOGLE_MAPS_API_KE