Upload README.md with huggingface_hub

README.md

@@ -1,12 +1,30 @@
 ---
-title: Natural Language Projectile Interface
-emoji: 📉
-colorFrom: blue
-colorTo: gray
+title: Projectile Motion — Deterministic + One-Sentence LLM
+emoji: 🎯
+colorFrom: purple
+colorTo: green
 sdk: gradio
-sdk_version: 5.47.2
+sdk_version: "4.44.0"
 app_file: app.py
 pinned: false
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Projectile Motion — Deterministic Calculator + One-Sentence Explanation
+
+A **first-principles projectile motion** calculator (no air resistance) that returns:
+- All **inputs** with units: `v₀` [m/s], `θ` [deg], `y₀` [m], `g` [m/s²], and **ball weight** [kg]
+- **Derived results**: `t_apex` [s], `max height` [m], `time of flight` [s], `range` [m], `impact speed` [m/s]
+- A **one-sentence, LLM-generated explanation** grounded strictly in the computed values.
+
+## Scope & Assumptions
+- Constant gravity `g`
+- Flat landing surface at `y = 0`
+- Neglects air resistance
+
+## UI
+- Sliders for inputs with validation ranges
+- Two panels: (i) **All values (inputs + derived)**; (ii) **One-sentence explanation**
+- ≥3 representative examples
+
+## Notes
+Educational demo; not for safety-critical use. The explainer uses a template-like prompt and the structured JSON only (no made-up numbers).