Update README.md

README.md

@@ -10,3 +10,45 @@ pinned: false
 ---
 
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+
+---
+title: I-Beam Calculator
+colorFrom: blue
+colorTo: gray
+sdk: gradio
+sdk_version: 5.46.0
+app_file: app.py
+pinned: false
+license: apache-2.0
+---
+
+Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+
+# I-Beam Calculator
+
+This Gradio app performs **deterministic engineering calculations** for a simply-supported I-beam under a central point load.  
+It computes maximum stress, midspan deflection, and factors of safety (yield and deflection) based on user-defined inputs.
+
+Additionally, the results are explained in plain language using a small LLM model, helping non-experts understand the engineering outcomes.
+
+---
+
+## How to Use
+1. Input the beam length, I-beam cross-section dimensions (height, flange width, flange thickness, web thickness), and the applied point load.  
+2. Material properties (elastic modulus, yield strength) are fixed to structural steel defaults.  
+3. Click **Compute**.  
+4. View the numerical results (stress, deflection, safety factors) and a concise natural language explanation.  
+
+Representative examples are included for quick testing.
+
+---
+
+## Model Information
+- **Backend**: Deterministic engineering formulas (mechanics of materials).  
+- **Framework**: Gradio v5.46.0 + Transformers v4.56.1  
+
+---
+
+## Notes
+- Assumes simply-supported beam, central point load, and linear elastic material behavior.  
+- Results are **educational demonstrations** and **not suitable for real-world engineering design**.