Update README.md

README.md

@@ -8,5 +8,46 @@ sdk_version: 5.47.2
 app_file: app.py
 pinned: false
 ---
+# Simply Supported Beam Calculator (with Natural Language Explanation)
+
+This Gradio app demonstrates a **deterministic first-principles calculator** for a simply supported beam with a **centered point load**.  
+
+## Features
+- Deterministic backend formulas:  
+  - Maximum bending moment: M = P·L / 4  
+  - Maximum stress: σ = M·c / I  
+  - Midspan deflection: δ = P·L³ / (48·E·I)  
+- **Input validation** with clear ranges and units.  
+- **Structured JSON record** showing all assumptions, inputs, formulas, and results.  
+- **Natural language explanation**: results are contextualized by an LLM pipeline (Flan-T5) or fallback template.  
+- User-facing Gradio interface with:  
+  - Numerical results table  
+  - Explanation panel  
+  - JSON record panel  
+
+## Inputs
+- L (m): span length  
+- P (kN): center point load  
+- E (GPa): elastic modulus  
+- I (cm^4): second moment of area  
+- c (cm): extreme fiber distance  
+- Optional: allowable stress (σ_allow), yield strength (fy), safety factor (n)
+
+## Outputs
+- Numerical results: bending moment, stress, deflection, utilization, pass/fail  
+- Explanation text  
+- Structured JSON (for reproducibility and transparency)
+
+## Limitations
+- Only valid for simply supported beams with a single center load.  
+- Small deflection theory, linear elastic, prismatic section.  
+- Users must provide correct I and c (from section properties).
+
+---
+
+### How to run locally
+```bash
+pip install -r requirements.txt
+python app.py
 
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference