| --- |
| title: Ahsan Stock Portfolio AI Center |
| emoji: 📈 |
| colorFrom: blue |
| colorTo: indigo |
| sdk: docker |
| app_file: app.py |
| pinned: false |
| --- |
| |
| # Ahsan Stock Portfolio AI Center (Live Quotes + AI Insights) |
|
|
| This Space runs a **FastAPI** app (served on port **7860**) that: |
| - pulls **live quotes** (Finnhub or Twelve Data), |
| - shows **portfolio P/L**, winners/losers, |
| - fetches **latest news** (Finnhub if configured) + one‑click source links, |
| - computes **Buy/Sell/Hold** signals using technical indicators (SMA/RSI/MACD), |
| - provides a lightweight **forecast** (statistical projection) and optional **LLM explanation** via Hugging Face Inference. |
|
|
| ## Required secrets (Settings → Variables and secrets) |
| Choose **one** market data provider: |
|
|
| ### Option A — Finnhub (recommended) |
| - `FINNHUB_API_KEY` = your Finnhub token |
|
|
| ### Option B — Twelve Data |
| - `TWELVEDATA_API_KEY` = your Twelve Data key |
|
|
| Optional (for AI explanations): |
| - `HF_TOKEN` = your Hugging Face access token |
| - `HF_TEXT_MODEL` = model repo id (example: `google/gemma-2-2b-it`) |
|
|
| ## Notes |
| - “Real-time” depends on your provider/plan and may be delayed. |
| - Signals/forecasts are **not financial advice**. |
|
|
