Upload README.md

README.md

@@ -1,13 +1,33 @@
 ---
-title: Alphaforge Pro
-emoji: 🐠
-colorFrom: yellow
-colorTo: purple
+title: AlphaForge Pro
+emoji: 🧠
+colorFrom: blue
+colorTo: indigo
 sdk: gradio
-sdk_version: 6.14.0
-python_version: '3.13'
+sdk_version: "5.0.0"
+python_version: "3.10"
 app_file: app.py
 pinned: false
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🧠 AlphaForge Pro — Quantitative Trading Dashboard
+
+**Real-time monitoring of your multi-asset alpha pipeline.**
+
+### What you see
+- 📈 **Cumulative PnL** with drawdown overlay
+- 📊 **8 live KPIs**: Sharpe, Sortino, Calmar, VaR 95%, Max Drawdown, Alpha, Beta, PnL
+- ⚖️ **Portfolio weights** bar chart
+- 🧩 **Feature importance** from XGBoost
+- 🎯 **Regime detection** (bull/bear/high-vol/neutral)
+- 🗞️ **Sentiment scores** from FinBERT
+- ⚠️ **Live alerts** feed
+
+### How it works
+```
+Market Data → Advanced Features → Alpha Model → Portfolio Optimizer → Weights
+                                    ↑
+                              Meta-Model (dynamic weighting)
+                                    ↑
+News/Social → FinBERT → Sentiment Alpha
+```