Metadata-Version: 2.4
Name: travelpurpose
Version: 2.0.6
Summary: Travel Purpose Prediction Library
Author: Teyfik Oz
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: pandas
Requires-Dist: numpy
Requires-Dist: transformers
Requires-Dist: torch
Requires-Dist: requests
Dynamic: author
Dynamic: description
Dynamic: description-content-type
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 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
