Hotel Explorer Agent

A voice-powered AI assistant that helps you search and compare hotel bookings across multiple platforms (like Booking.com, MakeMyTrip, ClearTrip, and Oyo).

Features

• Real-time Voice Conversation: Uses the Web Speech API to listen and talk back naturally.
• Intelligent Extraction: Uses OpenAI function calling to extract location, dates, and guest numbers from free-form speech.
• Extensible Architecture: The search filters and scraper engines are decoupled. Adding new filters is as easy as adding a field to a Pydantic model.
• Beautiful UI: A glassmorphism-inspired dark mode UI with smooth micro-animations.
• Sorting Options: Sort results by Price, Rating, or Distance.

Setup

1. Create a virtual environment:

   python -m venv venv
   source venv/bin/activate

2. Install dependencies:

   pip install -r requirements.txt

3. Set your OpenAI API key (Optional, but required for true LLM extraction. Without it, it falls back to a dummy keyword-based extraction for testing):

   export OPENAI_API_KEY="your-key-here"

Running

Start the backend server:

python -m backend.main

Then, open your browser and navigate to http://127.0.0.1:8000. Ensure you grant microphone permissions when prompted.