Upload README.md

README.md

@@ -1,12 +1,32 @@
 ---
-title: StyleID Face Identity Check
-emoji: 😻
-colorFrom: green
-colorTo: green
+title: "StyleID — Does AI Preserve Your Face?"
+emoji: 🎭
+colorFrom: purple
+colorTo: indigo
 sdk: gradio
-sdk_version: 6.13.0
+sdk_version: 5.33.0
 app_file: app.py
 pinned: false
+suggested_hardware: zero-a10g
+tags:
+  - face-identity
+  - stylization
+  - clip
+  - face-recognition
+  - art-style
+short_description: "Face identity check across AI art styles"
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🎭 StyleID — Does AI Preserve Your Face?
+
+Upload a **real photo** and a **stylized portrait** (anime, cartoon, painting, sketch, etc.) — StyleID tells you if the identity is preserved.
+
+## How it works
+
+StyleID uses a fine-tuned CLIP ViT-L/14 encoder calibrated against human psychometric experiments. Unlike standard face recognition (ArcFace, AdaFace), it's specifically designed for **cross-style** identity matching.
+
+## Paper & Model
+
+- **Paper:** [StyleID (arXiv 2604.21689)](https://arxiv.org/abs/2604.21689)
+- **Model:** [kwanY/styleid](https://huggingface.co/kwanY/styleid)
+- **License:** Research use only