docs: add HF Spaces deployment, LFS setup, and update README with screenshot and install instructions

.github/workflows/sync-to-hf.yml

@@ -0,0 +1,25 @@
+name: Sync to Hugging Face Spaces
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  sync-to-hub:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+          lfs: true
+      - name: Migrate binary files to Git LFS
+        run: |
+          git config user.email "github-actions@github.com"
+          git config user.name "GitHub Actions"
+          git lfs install
+          git stash || true
+          git lfs migrate import --include="*.png,*.jpg,*.jpeg,*.gif" --everything --yes
+      - name: Push to Hugging Face
+        env:
+          HF_TOKEN: ${{ secrets.HF_TOKEN }}
+        run: git push --force https://kameshcodes:$HF_TOKEN@huggingface.co/spaces/kameshcodes/value-at-risk main

.gitignore

@@ -10,4 +10,5 @@ wheels/
 .venv
 .gradio
 log/
-output/
+output/
+.env

README.md

@@ -1,7 +1,20 @@
+---
+title: VaR Engine
+emoji: 📉
+colorFrom: blue
+colorTo: red
+sdk: gradio
+sdk_version: "6.9.0"
+python_version: "3.13"
+app_file: app.py
+pinned: false
+---
+
 # VaR Engine
 
 An interactive web app to compute **Value at Risk (VaR)** and **Expected Shortfall (ES)** for equities, featuring an interactive Gradio UI and **audit-ready Excel reports with embedded formulas**.
 
+![App Screenshot](assets/screenshot.png)
 
 ## Features
 
@@ -13,6 +26,11 @@ An interactive web app to compute **Value at Risk (VaR)** and **Expected Shortfa
 
 ## Getting Started
 
+```bash
+git clone https://github.com/kameshcodes/value-at-risk.git
+cd value-at-risk
+```
+
 ### Option 1: Using `uv` (Recommended)
 
 1.  **Sync the environment**: