# Deploy Qwen Captioning UI To HF Space

This deploys the music-captioning app (`qwen_caption_app.py`) as its own Space.

## Prerequisites

- Hugging Face account
- `HF_TOKEN` with write access

## Steps

1. Create a new Hugging Face Space (SDK: `Gradio`).
2. Push this repo content to that Space.
3. In Space `README.md` front matter, set:
   - `sdk: gradio`
   - `app_file: qwen_caption_app.py`
4. Pick GPU hardware (A10G or better recommended for local backend).
5. Optional secrets/env:
   - `HF_TOKEN` (if accessing private datasets or endpoint backend)

## Runtime notes

- `local` backend loads `Qwen/Qwen2-Audio-7B-Instruct` in the Space runtime.
- `hf_endpoint` backend can call a dedicated endpoint URL instead.
- Export defaults to `/data/qwen_annotations` on Spaces when persistent storage is enabled.