# TRIQA Hugging Face Demo - Quick Start Guide

## 🚀 Create Your Hugging Face Space

### Step 1: Create the Space
1. Go to https://huggingface.co/spaces
2. Click "Create new Space"
3. Fill in:
   - **Space name**: `triqa-image-quality-assessment`
   - **License**: MIT
   - **SDK**: Gradio
   - **Hardware**: CPU (or GPU if available)
   - **Visibility**: Public

### Step 2: Upload Files
Upload these files from this folder to your Hugging Face Space:

#### Core Files (Upload these first):
- `app.py` - Main application
- `README.md` - Space description
- `requirements.txt` - Dependencies
- `package.json` - Node.js config
- `convnext_original.py` - Model architecture
- `convnext_finetune.py` - Model architecture
- `sample_image/` folder - Sample images

#### Model Files (Download from Box first):
1. Go to: https://utexas.box.com/s/8aw6axc2lofouja65uc726lca8b1cduf
2. Download the model files
3. Create these directories in your Space:
   - `feature_models/`
   - `Regression_Models/`
4. Upload the model files to their respective directories

### Step 3: Test the Demo
1. Wait for the build to complete (2-5 minutes)
2. Upload a sample image
3. Click "Assess Quality"
4. Verify you get a quality score (1-5 scale)

## 📁 File Structure in Your Space
```
your-space/
├── app.py
├── README.md
├── requirements.txt
├── package.json
├── convnext_original.py
├── convnext_finetune.py
├── sample_image/
│   ├── 233045618.jpg
│   ├── 25239707.jpg
│   ├── 44009500.jpg
│   ├── 5129172.jpg
│   └── 85119046.jpg
├── feature_models/
│   ├── convnext_tiny_22k_224.pth
│   └── triqa_quality_aware.pth
└── Regression_Models/
    ├── KonIQ_scaler.save
    └── KonIQ_TRIQA.save
```

## 🎯 Expected Demo Features
- **Image Upload**: Drag & drop or click to upload
- **Quality Assessment**: Click button to get score
- **Sample Images**: Pre-loaded examples
- **Paper Links**: arXiv and IEEE links
- **Citation**: BibTeX citation

## 🔧 Troubleshooting
- **Build fails**: Check requirements.txt
- **Models not loading**: Verify model files are uploaded
- **File not found**: Check file paths and names
- **Memory issues**: Use CPU hardware

## 📞 Support
- GitHub: https://github.com/rajeshsureddi/triqa
- Paper: https://arxiv.org/pdf/2507.12687

Your demo will be live at: `https://huggingface.co/spaces/your-username/triqa-image-quality-assessment`