README.md

.github/workflows/upload-screenshots.yml

@@ -0,0 +1,26 @@
+name: Upload Screenshots
+
+on:
+  workflow_dispatch:
+
+jobs:
+  upload:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Download and replace screenshots
+        run: |
+          curl -L "https://hcti.io/v1/image/019e4b3f-9d2e-7cf7-a399-ee72c75fa4b4" -o screenshots/screenshot_1.jpg
+          curl -L "https://hcti.io/v1/image/019e4b3f-9d2e-7cf7-a399-ee72c75fa4b4" -o screenshots/screenshot_2.jpg
+          ls -la screenshots/
+      
+      - name: Commit screenshots
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add screenshots/
+          git status
+          git diff --cached --stat
+          git commit -m "Add real screenshots from design" || echo "Nothing to commit"
+          git push

README.md

@@ -10,7 +10,7 @@
 
 ---
 
-## 📖 About The Project (نظرة عامة على المشروع)
+## 📖 About The Project
 
 **Quantum Terminal** is an advanced, fully free, and open-source trading terminal designed to bridge the gap between institutional-grade quantitative analysis and retail day trading. 
 
@@ -28,35 +28,35 @@ Unlike traditional platforms that rely on lagging indicators (like RSI or MACD),
 
 ---
 
-## ✨ Core Features (المميزات الأساسية)
+## ✨ Core Features 
 
-### 1. 🌐 Multi-Provider Live Feeds (ربط مباشر مع الأسواق)
+### 1. 🌐 Multi-Provider Live Feeds 
 Quantum Terminal is built to handle ultra-fast data streams from the most reliable data providers in the industry:
 - **MetaTrader 5 (MT5):** Direct integration via Python API for Forex, Crypto, and CFD markets.
 - **Rithmic:** High-frequency, sub-millisecond tick processing for CME Futures (NQ, ES).
 - **Tradovate:** Seamless integration for retail futures traders.
 *(The platform features a dedicated `focus_tick_loop` ensuring the chart you are actively watching refreshes at maximum FPS without bottlenecking the system).*
 
-### 2. 📐 Advanced Quantitative Models (النماذج الكمية المتقدمة)
+### 2. 📐 Advanced Quantitative Models 
 Move beyond simple support and resistance. The platform integrates institutional volatility models to forecast price action probabilities:
 - **Volatility Cones:** Visualizing expected price ranges using Geometric Brownian Motion (**GBM**), Merton Jump Diffusion (**MJD**), and **Bates** models.
 - **Scalp Bands & Micro Volatility:** Real-time bands designed specifically for high-frequency scalpers.
 - **Probability Fields:** Heatmaps mapping the statistical likelihood of price reverting or trending.
 
-### 3. 🌊 Options Flow & Market Maker Positioning (تحليل سيولة الخيارات)
+### 3. 🌊 Options Flow & Market Maker Positioning 
 Understanding where Market Makers are hedging is critical. Quantum Terminal visualizes:
 - **Gamma Exposure (GEX):** Identifies sticky price levels and volatility triggers.
 - **Max Pain:** Highlights the strike price with the most open options contracts.
 - **Option Walls:** Visualizes heavy Call/Put resistance and support barriers.
 
-### 4. 🌍 Macro Regime & Sector Rotation (تحليل الماكرو والسيولة)
+### 4. 🌍 Macro Regime & Sector Rotation
 Using data from `yfinance`, the terminal analyzes global market regimes:
 - Tracks ETF Sector Rotation to see where smart money is flowing.
 - Identifies the current market regime (Risk-On, Risk-Off, Inflationary, etc.) to align your trades with the broader macroeconomic trend.
 
 ---
 
-## 🏗️ Architecture & Repository Structure (هيكلية المشروع)
+## 🏗️ Architecture & Repository Structure 
 
 The project follows a decoupled architecture, ensuring the UI remains buttery smooth while the backend handles heavy lifting.
 
@@ -80,7 +80,7 @@ QuantumTerminal/
 
 ---
 
-## 🚀 Getting Started (طريقة التشغيل)
+## 🚀 Getting Started 
 
 ### Prerequisites
 - **Python 3.10** or higher.
@@ -90,7 +90,7 @@ QuantumTerminal/
 ### Installation
 1. Clone the repository:
    ```bash
-   git clone https://github.com/wJubran/QuantumTerminal.git
+   git clone [https://github.com/wJubran/QuantumTerminal.git](https://github.com/wJubran/QuantumTerminal.git)
    cd QuantumTerminal/backend
    ```
 2. Install Python dependencies:
@@ -107,7 +107,7 @@ QuantumTerminal/
 
 ---
 
-## 🛠️ Contributing (المساهمة)
+## 🛠️ Contributing 
 This is a community-driven project! If you are a Python developer, Quant, or React engineer, your pull requests are welcome. 
 - **Areas needing help:** Enhancing thread safety for MT5 in `data_server.py`, adding new broker providers (like Interactive Brokers), and rebuilding an open-source React UI.
 

social-preview.svg

@@ -0,0 +1,101 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="640" viewBox="0 0 1280 640">
+  <!-- Background -->
+  <defs>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#0d1117"/>
+      <stop offset="100%" style="stop-color:#161b22"/>
+    </linearGradient>
+    <linearGradient id="accent" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" style="stop-color:#00d4aa"/>
+      <stop offset="100%" style="stop-color:#0094ff"/>
+    </linearGradient>
+    <linearGradient id="glow" x1="0%" y1="0%" x2="0%" y2="100%">
+      <stop offset="0%" style="stop-color:#00d4aa;stop-opacity:0.3"/>
+      <stop offset="100%" style="stop-color:#00d4aa;stop-opacity:0"/>
+    </linearGradient>
+  </defs>
+
+  <!-- Main background -->
+  <rect width="1280" height="640" fill="url(#bg)"/>
+
+  <!-- Grid lines -->
+  <g stroke="#21262d" stroke-width="1" opacity="0.6">
+    <line x1="0" y1="160" x2="1280" y2="160"/>
+    <line x1="0" y1="320" x2="1280" y2="320"/>
+    <line x1="0" y1="480" x2="1280" y2="480"/>
+    <line x1="320" y1="0" x2="320" y2="640"/>
+    <line x1="640" y1="0" x2="640" y2="640"/>
+    <line x1="960" y1="0" x2="960" y2="640"/>
+  </g>
+
+  <!-- Accent top bar -->
+  <rect x="0" y="0" width="1280" height="4" fill="url(#accent)"/>
+
+  <!-- Decorative chart line (right side) -->
+  <polyline
+    points="680,520 740,480 800,490 860,420 920,440 980,360 1040,380 1100,300 1160,320 1220,260 1280,240"
+    fill="none" stroke="#00d4aa" stroke-width="2.5" opacity="0.5"/>
+
+  <!-- Glow under chart line -->
+  <polygon
+    points="680,520 740,480 800,490 860,420 920,440 980,360 1040,380 1100,300 1160,320 1220,260 1280,240 1280,640 680,640"
+    fill="url(#glow)" opacity="0.4"/>
+
+  <!-- Volatility cone shapes (decorative) -->
+  <polygon points="900,500 1000,300 1100,500" fill="#0094ff" opacity="0.07"/>
+  <polygon points="920,500 1000,340 1080,500" fill="#00d4aa" opacity="0.07"/>
+
+  <!-- Left side content -->
+  <!-- Icon circle -->
+  <circle cx="120" cy="200" r="48" fill="#00d4aa" opacity="0.15"/>
+  <circle cx="120" cy="200" r="36" fill="#00d4aa" opacity="0.2"/>
+  <text x="120" y="212" font-family="monospace" font-size="28" fill="#00d4aa" text-anchor="middle">QT</text>
+
+  <!-- Main title -->
+  <text x="195" y="190" font-family="-apple-system, BlinkMacSystemFont, Segoe UI, sans-serif" font-size="52" font-weight="700" fill="#ffffff">Quantum Terminal</text>
+
+  <!-- Subtitle -->
+  <text x="195" y="230" font-family="-apple-system, BlinkMacSystemFont, Segoe UI, sans-serif" font-size="22" fill="#8b949e">Free &amp; Open Source Trading Terminal</text>
+
+  <!-- Divider line -->
+  <rect x="80" y="268" width="560" height="2" fill="url(#accent)" rx="1"/>
+
+  <!-- Feature tags -->
+  <!-- Tag 1: Python / FastAPI -->
+  <rect x="80" y="295" width="160" height="36" rx="18" fill="#00d4aa" opacity="0.15"/>
+  <rect x="80" y="295" width="160" height="36" rx="18" fill="none" stroke="#00d4aa" stroke-width="1" opacity="0.4"/>
+  <text x="160" y="319" font-family="monospace" font-size="14" fill="#00d4aa" text-anchor="middle">Python / FastAPI</text>
+
+  <!-- Tag 2: Electron -->
+  <rect x="252" y="295" width="120" height="36" rx="18" fill="#0094ff" opacity="0.15"/>
+  <rect x="252" y="295" width="120" height="36" rx="18" fill="none" stroke="#0094ff" stroke-width="1" opacity="0.4"/>
+  <text x="312" y="319" font-family="monospace" font-size="14" fill="#0094ff" text-anchor="middle">Electron</text>
+
+  <!-- Tag 3: MIT License -->
+  <rect x="384" y="295" width="120" height="36" rx="18" fill="#3fb950" opacity="0.15"/>
+  <rect x="384" y="295" width="120" height="36" rx="18" fill="none" stroke="#3fb950" stroke-width="1" opacity="0.4"/>
+  <text x="444" y="319" font-family="monospace" font-size="14" fill="#3fb950" text-anchor="middle">MIT License</text>
+
+  <!-- Feature list -->
+  <!-- Item 1 -->
+  <circle cx="97" cy="378" r="5" fill="#00d4aa"/>
+  <text x="115" y="384" font-family="-apple-system, BlinkMacSystemFont, Segoe UI, sans-serif" font-size="18" fill="#c9d1d9">Volatility Cones &amp; GEX Overlays</text>
+
+  <!-- Item 2 -->
+  <circle cx="97" cy="420" r="5" fill="#0094ff"/>
+  <text x="115" y="426" font-family="-apple-system, BlinkMacSystemFont, Segoe UI, sans-serif" font-size="18" fill="#c9d1d9">Live MT5 / Rithmic / Tradovate Feeds</text>
+
+  <!-- Item 3 -->
+  <circle cx="97" cy="462" r="5" fill="#f78166"/>
+  <text x="115" y="468" font-family="-apple-system, BlinkMacSystemFont, Segoe UI, sans-serif" font-size="18" fill="#c9d1d9">Max Pain &amp; Dealer Positioning</text>
+
+  <!-- Item 4 -->
+  <circle cx="97" cy="504" r="5" fill="#d2a8ff"/>
+  <text x="115" y="510" font-family="-apple-system, BlinkMacSystemFont, Segoe UI, sans-serif" font-size="18" fill="#c9d1d9">Open Source — Contributors Welcome</text>
+
+  <!-- Bottom GitHub link -->
+  <text x="80" y="590" font-family="monospace" font-size="16" fill="#8b949e">github.com/wJubran/QuantumTerminal</text>
+
+  <!-- Bottom right stars/stats area -->
+  <text x="1200" y="590" font-family="monospace" font-size="14" fill="#3fb950" text-anchor="end">v0.1.0-alpha</text>
+</svg>