---
title: Twitter (X) Engagement Drivers
emoji: 📈
colorFrom: purple
colorTo: green
sdk: gradio
sdk_version: 5.49.1
app_file: ui/app.py
pinned: false
---

# Twitter (X) Engagement Drivers - University Marketing
Analyze tweet-level engagement for Aotearoa New Zealand tertiary institutions. Ships with a Python pipeline that writes grouped CSVs and a Gradio app suitable for Hugging Face Spaces.

## Setup

```
python -m venv .venv
# Windows: .venv\Scripts\activate
# macOS/Linux:
source .venv/bin/activate
pip install -r requirements.txt
```

## Data Inputs (minimum)

* Authors CSV: `user_id`, `screen_name`, `description`, `followers_count`, `location` (others optional)
* Tweets CSV: `tweet_id`, `user_id`, `created_at`, `text`, `lang`, `retweet_count`, `like_count`, `reply_count`, `quote_count`, `hashtags`, `mentions`, `media_type`

Place these files in `data/raw/` or pass explicit paths to the script.

## Run: Gradio App 

```
python ui/app.py
```

The app reads tables from `data/processed/` when available.