ReadMe.md

# LuxeRate AI: Booking Risk & Service Perception Dashboard

## 🏨 Project Overview
**LuxeRate AI** is an advanced analytics dashboard designed for the hospitality industry. It addresses the critical business challenge: 
> *“How can a hotel optimize pricing while reducing cancellation risk and monitoring service quality perception?”*

This project was developed for the **AI for Big Data Management** course to demonstrate the integration of machine learning, natural language processing (NLP), and workflow automation.

## ✨ Key Features
- **Booking Risk Predictor**: Uses a Random Forest Classifier to predict the likelihood of a booking being canceled based on lead time, customer history, and seasonality.
- **Review Sentiment Analyzer**: Leverages NLTK VADER to provide real-time sentiment analysis and keyword-based aspect detection (Cleanliness, Service, Value, etc.).
- **n8n Automation**: Features a built-in webhook connector to send analysis results to n8n, enabling automated business workflows like Slack notifications or dynamic CRM updates.

## 📁 Required Files
To run this Space, ensure the following files are in the root directory:
1. `app.py`: The main application logic.
2. `requirements.txt`: Python dependencies.
3. `hotel_bookings_cleaned_enriched.csv`: Pre-processed booking data.
4. `reviews_with_sentiment_output.csv`: Historical review data for benchmarking.
5. `feature_importance_output.csv`: Pre-calculated model insights.

## 🚀 How to Run Locally
1. Clone the repository.
2. Install dependencies: `pip install -r requirements.txt`
3. Run the app: `python app.py`
4. Open `http://localhost:7860` in your browser.

## 🔗 n8n Integration
1. In n8n, create a **Webhook Node** (HTTP POST).
2. Copy the Webhook URL.
3. Paste the URL into the "n8n Automation" tab in LuxeRate AI.
4. Perform an analysis in Tab 1 or Tab 2, then click "Send Latest Analysis".

---
*Developed for AI for Big Data Management Course Project.*