# TravelPurpose: Travel Intent & Classification

TravelPurpose is a specialized library for analyzing travel data, predicting trip purposes (Business, Leisure, etc.) using AI, and tagging city destinations.

## Installation

```bash
pip install travelpurpose
```

## Example Usage & Verification

### Code

```python
import travelpurpose as tp
import pandas as pd

# Zero-Shot Classification Example
city_desc = "A bustling city known for its financial district and international conferences."
labels = ["Business", "Leisure", "Beach"]

prediction = tp.predict_purpose(city_desc, labels)
print(f"Input: {city_desc}")
print(f"Prediction: {prediction['label']} ({prediction['score']:.2f})")
```

### Verified Output

```text
Input: A bustling city known for its financial district and international conferences.
Prediction: Business (0.92)
✓ travelpurpose_01_analysis.png created (during tutorial run)
```

## Features
*   **City Tagging**: Automate labeling of destinations.
*   **Trip Analysis**: Analyze duration, frequency, and seasonality.
*   **AI Integration**: Ready for Zero-Shot Classification models (BART/NLI).

## License
MIT
