Update README.md

README.md

@@ -1,14 +1,66 @@
 ---
-title: Actuarial Model Point Generator
-emoji: 🌍
-colorFrom: yellow
-colorTo: indigo
+---
+title: "Actuarial Model Point Generator"
+emoji: 🏗️
+colorFrom: gray
+colorTo: red
 sdk: gradio
 sdk_version: 5.31.0
 app_file: app.py
 pinned: false
 license: mit
-short_description: Generate and analyze synthetic actuarial model points.
+short_description: Generate synthetic actuarial model points
+tags:
+  - actuarial
+  - insurance
+  - model-points
+  - synthetic-data
+  - data-generation
+  - gradio
+  - dashboard
+  - portfolio-analytics
+---
+
+
+# 🏗️ Actuarial Model Point Generator
+
+A professional Gradio dashboard for **generating and analyzing synthetic insurance model points**.  
+Designed for actuaries and data scientists who need realistic portfolio data for testing, training, and analysis.
+
+[![Open in Spaces](https://huggingface.co/datasets/huggingface/badges/raw/main/open-in-hf-spaces-sm.svg)](https://huggingface.co/spaces/alidenewade/actuarial-model-point-generator)
+
+---
+
+## 🌟 Key Features
+
+| Category | Highlights |
+| -------- | ---------- |
+| **📊 Interactive Generation** | • Set policy count, age/sum assured ranges, terms<br>• Positive **duration** ensures in-force modeling<br>• Supports **sex**, **policy counts**, and reproducible outputs |
+| **📈 Advanced Analytics** | • Distribution charts per field<br>• Correlation matrix<br>• Box plots by term and duration<br>• Portfolio-level summaries |
+| **📋 Professional Output** | • View table of generated policies<br>• Export to CSV<br>• Summary statistics by variable |
+| **🎯 Actuarial Applications** | Ideal for:<br>• Model clustering<br>• Stress testing<br>• Product development<br>• Risk exposure profiling<br>• Simulation input |
+| **🔧 Customization Options** | - Policy count: 100–50,000<br>- Age: 18–80<br>- Sum assured: custom min–max<br>- Policy term: multi-select (5–30 years)<br>- Sex: optional<br>- Policy count per row: fixed or variable |
+
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+## 🚀 Quick Start (Hugging Face Spaces)
+
+1. Open [this Space](https://huggingface.co/spaces/alidenewade/actuarial-model-point-generator)  
+2. Configure generation parameters  
+3. Click **“Generate Portfolio”**  
+4. Explore the analytics and export CSV if needed
+
+---
+
+## 🛠️ Local Installation
+
+```bash
+# Clone this repository
+git clone https://github.com/YOUR-USERNAME/actuarial-model-point-generator.git
+cd actuarial-model-point-generator
+
+# Install dependencies
+pip install -r requirements.txt
+
+# Run the app
+python app.py