Update README.md

README.md

@@ -8,7 +8,58 @@ sdk_version: 5.47.0
 app_file: app.py
 pinned: false
 license: mit
-short_description: A simple, deterministic, and first-principles calculator.
+short_description: Thin-walled cylinder calculator with LLM explanations.
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 📚 LLM Explainer: Thin-Walled Cylinder Calculator
+
+This Hugging Face Space provides a **first-principles calculator** for thin-walled closed-end pressure vessels.  
+It combines **deterministic mechanics** with a **lightweight language model** that explains the results in plain language.
+
+## 🔧 Features
+
+- **Deterministic Mechanics**  
+  Implements the classic thin-wall hoop-stress model to compute maximum permissible internal pressure.
+
+- **Validation Checks**  
+  Automatically detects when the thin-wall assumptions (0.5% ≤ t/Do ≤ 10%) are violated.
+
+- **LLM Explanations**  
+  A tiny local LLM provides clear, TA-style explanations of the results in plain English.
+
+- **Interactive Gradio UI**  
+  Enter vessel geometry and material properties, compute results, and get both numerical tables and natural-language narratives.
+
+## 📊 What It Computes
+
+- Maximum permissible internal pressure, **p_allow [MPa]**  
+- von Mises stress at p_allow  
+- Predicted elastic diameter growth Δd [mm]  
+- Predicted elastic length growth ΔL [mm]  
+- Applicability verdict (thin-wall check)
+
+## 🚀 Usage
+
+1. Enter the following parameters:
+   - Outer diameter **Do [m]**
+   - Wall thickness **t [m]**
+   - Length **L [m]**
+   - Yield strength **Sy [MPa]**
+   - Elastic modulus **E [GPa]**
+   - Poisson’s ratio **ν [-]**
+
+2. Click **Compute**.  
+   - A results table is generated.  
+   - A concise explanation is provided by the LLM.
+
+3. Try the built-in examples:
+   - ✅ Valid thin-wall cylinder  
+   - ⚠️ Too thick (fails upper bound check)  
+
+## 📜 License
+
+MIT License – see [LICENSE](./LICENSE).
+
+## 📬 Contact
+
+Feel free to reach out for questions or suggestions: **aslann@cmu.edu**