Add model card (citation + usage)

README.md

@@ -2,6 +2,8 @@
 license: mit
 language:
 - en
+base_model:
+- Ultralytics/YOLOv8
 pipeline_tag: object-detection
 tags:
 - girafe
@@ -10,11 +12,38 @@ tags:
 arxiv: 2603.02087
 ---
 
+## Model
+Pre-trained OpenGlottal checkpoint: `og_girafe_yolo.pt`.
+
+This model is part of the OpenGlottal toolkit:
+https://github.com/hari-krishnan/openglottal
+
+## How to use
+
+Download the weight and run OpenGlottal YOLO-gated pipelines.
+
+```python
+from huggingface_hub import hf_hub_download
+yolo_path = hf_hub_download(repo_id="hari-krishnan-u/og_girafe_yolo", filename="og_girafe_yolo.pt")
+```
+
+Run `vft` or `guided-vft`:
+
+```bash
+openglottal run /path/to/video.avi \
+  --pipeline vft \
+  --yolo-weights "$yolo_path" \
+  --output results/
+```
+
 ## Citation
 
+If you use this model, please cite:
+
 ```bibtex
 @misc{unnikrishnan2026openglottal,
-  title         = {A Detection-Gated Pipeline for Robust Glottal Area Waveform Extraction and Clinical Pathology Assessment},
+  title         = {A Detection-Gated Pipeline for Robust Glottal Area
+                   Waveform Extraction and Clinical Pathology Assessment},
   author        = {Unnikrishnan, Harikrishnan},
   year          = {2026},
   eprint        = {2603.02087},