Initial commit: forex quant dashboard with momentum strategy + TA-Lib free impl

2026-05-12 21:42:26 +08:00
commit 24d2f4feed
15 changed files with 1643 additions and 0 deletions
@@ -0,0 +1,58 @@
+# Forex Quant Dashboard
+
+Real-time monitoring dashboard for your forex quant trading strategy.
+Free to run locally or deploy to Streamlit Community Cloud.
+
+## Quick Start (Local)
+
+```bash
+cd ~/forex-quant
+source .venv/bin/activate
+streamlit run dashboard/app.py
+```
+
+Open http://localhost:8501 in your browser.
+
+## Deploy for Free (Remote Access)
+
+### Option 1: Streamlit Community Cloud ⭐ (recommended)
+
+1. Push `dashboard/` to a GitHub repo
+2. Go to https://streamlit.io/cloud
+3. Sign in with GitHub
+4. Click "New app" → select your repo
+5. Main file path: `dashboard/app.py`
+6. Deploy → your app is live at `https://your-app.streamlit.app`
+
+**No credit card needed. Free forever.**
+- 1 app included
+- Unlimited team members
+- Community support
+
+### Option 2: Local + Cloudflare Tunnel
+
+```bash
+# Install cloudflared
+brew install cloudflare/cloudflared/cloudflared
+
+# Run dashboard
+streamlit run dashboard/app.py --server.port 8501
+
+# In another terminal, expose it
+cloudflared tunnel --url http://localhost:8501
+```
+
+You get a `*.trycloudflare.com` URL — accessible from anywhere.
+
+## Dashboard Features
+
+- **Live prices** — all major forex pairs
+- **Strategy signals** — MACD-confirmed momentum
+- **Performance metrics** — Sharpe, drawdown, win rate
+- **Equity curve** — strategy vs buy & hold
+- **Multi-pair comparison** — find what's working
+- **Adjustable parameters** — tweak in real-time
+
+## Data Source
+
+All data from Yahoo Finance — **free, no API key required**.