Upload README.md with huggingface_hub

README.md

@@ -1,12 +1,31 @@
 ---
-title: Visual Chronometer Nexaapi Demo
-emoji: 🚀
-colorFrom: indigo
-colorTo: indigo
+title: Visual Chronometer via NexaAPI
+emoji: 🎬
+colorFrom: blue
+colorTo: purple
 sdk: gradio
-sdk_version: 6.10.0
+sdk_version: 4.0.0
 app_file: app.py
 pinned: false
+license: mit
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Visual Chronometer + NexaAPI: AI Video Generation Demo
+
+Based on the research paper: **"The Pulse of Motion: Measuring Physical Frame Rate from Visual Dynamics"** ([arXiv:2603.14375](https://huggingface.co/papers/2603.14375))
+
+## What This Demo Does
+
+1. **Generate AI videos** via NexaAPI (Veo 3, Kling v3, and 50+ models)
+2. **Analyze temporal quality** — inspired by Visual Chronometer's PhyFPS measurement
+
+The paper reveals that AI video generators suffer from "Chronometric Hallucination" — physically incorrect motion speeds. This demo lets you generate videos and visually inspect their temporal consistency.
+
+## Links
+
+- 🌐 **NexaAPI**: [nexa-api.com](https://nexa-api.com)
+- 🚀 **RapidAPI**: [rapidapi.com/user/nexaquency](https://rapidapi.com/user/nexaquency)
+- 🐍 **Python SDK**: `pip install nexaapi` | [PyPI](https://pypi.org/project/nexaapi)
+- 📦 **Node.js SDK**: `npm install nexaapi` | [npm](https://npmjs.com/package/nexaapi)
+- 📄 **Paper**: [huggingface.co/papers/2603.14375](https://huggingface.co/papers/2603.14375)
+- 💻 **Visual Chronometer**: [github.com/taco-group/Visual_Chronometer](https://github.com/taco-group/Visual_Chronometer)