Update README.md

README.md

@@ -6,5 +6,43 @@ colorTo: pink
 sdk: docker
 app_port: 7860
 pinned: false
-short_description: CAPM+CML portfolio advisor with local embeddings
+short_description: CAPM + CML portfolio advisor w/ embeddings
+license: cc-by-4.0
+models:
+  - FinLang/finance-embeddings-investopedia
+datasets:
+  - your-username/LensIQ-Synthetic-Portfolio-1000
 ---
+
+# LensIQ — CAPM + CML Portfolio Advisor
+
+LensIQ is a Gradio app for portfolio analysis using CAPM and the Capital Market Line (CML), with embedding-aided suggestions.
+
+- **Plot**
+  - **x-axis**: historical σ (annualized, from monthly covariance of your tickers)
+  - **y-axis**: CAPM E[r] = rf + β·ERP
+  - CML drawn from risk-free to market (**VOO**).
+
+- **Efficient mixes** (market/bills only)
+  - **Same σ** as your portfolio → point on the CML at your σ
+  - **Same E[r]** as your portfolio → σ on the CML for that return
+  - Weights shown so you can replicate the mixes.
+
+- **Suggestions**
+  - Exactly **one** candidate per band (**Low / Medium / High**).
+  - Built from **1,000** random long-only mixes using **your tickers** (+ `VOO` as market proxy).
+  - Ranking uses CAPM metrics + **FinLang/finance-embeddings-investopedia** with MMR for diversity.
+
+- **Export**
+  - Each run saves a CSV with all candidate mixes (downloadable from the UI).
+
+> **Note:** Include **VOO** in your portfolio (market proxy) before computing.
+
+---
+
+## Run Locally
+
+```bash
+docker build -t lensiq .
+docker run -p 7860:7860 -e GRADIO_SERVER_NAME=0.0.0.0 lensiq
+# Open http://localhost:7860