Upload README.md with huggingface_hub

README.md

@@ -1,12 +1,25 @@
 ---
-title: Cantilever Rectangular Pointload
-emoji: 🌍
-colorFrom: blue
-colorTo: green
+title: Cantilever Rectangular Beam — Point Load (General)
+emoji: 🏗️
+colorFrom: indigo
+colorTo: blue
 sdk: gradio
-sdk_version: 5.49.0
+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
+# Cantilever Rectangular Beam — Point Load (Free End or at Position a)
+
+A Gradio app that computes **max bending stress**, **yield FoS**, **free-end deflection**, and **deflection FoS (L/180)** for a **cantilever rectangular beam** with a **point load at the free end or at distance a**.  
+It prints explicit arithmetic (with `*`) so students can *see the math*, and generates a one-sentence, friendly explanation using a tiny LLM when available.
+
+## Run locally
+```bash
+pip install -r requirements.txt
+python app.py
+```
+
+## Notes
+- If Transformers/Torch aren't available in the Space, the app gracefully falls back to a deterministic one-liner.
+- Educational demo (Euler–Bernoulli, small deflection); not a full design code check.