<p align="center">
 <strong>Advanced AI-Powered Trading Platform - Desktop Edition</strong>
</p>
<p align="center">
 <img src="https://img.shields.io/badge/Version-0.1.7--beta-blue.svg" alt="Version">
 <img src="https://img.shields.io/badge/Python-3.10+-blue.svg" alt="Python">
 <img src="https://img.shields.io/badge/Electron-Desktop-333333.svg" alt="Electron">
 <img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License">
</p>
---
## 🚀 Overview
**Quantum Llama Terminal** is a professional, institutional-grade desktop trading platform designed for modern algorithmic and manual trading. Powered by an **Electron** frontend and a high-performance **Python (FastAPI)** backend, it integrates bleeding-edge Machine Learning and Deep Learning models to provide unparalleled market insights.
Whether you are trading Traditional Finance (TradFi) or Cryptocurrencies (DeFi), Quantum Llama offers seamless execution, advanced order flow visualization, and AI-driven predictive analytics.
---
## ✨ Key Features
### 📊 Advanced Order Flow & Charting
- **Footprint Charts**: Granular view of bid/ask volume imbalance at every price level.
- **Bookmap / DOM (Depth of Market)**: High-definition liquidity visualization and order book heatmaps.
- **Microstructure Analysis**: Tick-level data processing for precision entries and exits.
### 🤖 AI & Machine Learning Integration
- **Deep Learning Models**: Powered by `PyTorch` and `Transformers` for sequence modeling and predictive analytics.
- **Machine Learning Algorithms**: Utilizing `XGBoost`, `Scikit-Learn`, and `Statsmodels` for robust signal generation.
- **Automated Algorithmic Execution**: Built-in algorithm runner and backtesting engine using `VectorBT`.
### 🔗 Multi-Broker & Multi-Exchange Support
- **MetaTrader 5 (MT5)**: Native integration for Forex, Indices, and Commodities.
- **Crypto Exchanges**: Supported via the robust `CCXT` library (Binance, Bybit, etc.).
- **Futures Platforms**: Integration keys for `NinjaTrader` and `Tradovate`.
### ⚙️ High-Performance Architecture
- **Desktop Client**: Built with `Electron` and `Monaco Editor` for a responsive, customizable workspace.
- **FastAPI Backend**: Asynchronous, high-throughput backend communicating via `WebSockets`.
- **Local Database**: Supabase backend connection available, with seamless local SQLite persistence.
---
## 📸 Platform Screenshots
### Main Trading Terminal
![Main Terminal](file://D:\Betas\QuntumLLamaTerminal_V0.1.7Beta\terminalmagen\imagen1.png?msec=1774220591385)
### Footprint Charting
![Footprint Chart](file://D:\Betas\QuntumLLamaTerminal_V0.1.7Beta\terminalmagen\fOOTpRING.png?msec=1774220591320)
### Bookmap / Order Book Heatmap
![Bookmap](file://D:\Betas\QuntumLLamaTerminal_V0.1.7Beta\terminalmagen\BoockMap.png?msec=1774220591322)
---
## 🛠️ Technology Stack
| Component | Technologies Used |
| --- | --- |
| **Frontend** | Electron, JavaScript/HTML/CSS, Monaco Editor |
| **Backend** | Python, FastAPI, Uvicorn, WebSockets |
| **AI / Data Science** | PyTorch, Transformers, XGBoost, Pandas, Numpy |
| **Trading Interfaces** | MetaTrader5, CCXT, yFinance |
| **Backtesting** | VectorBT, TA-Lib |
| **Security & Build** | Bytenode, PyArmor, Electron-Builder |
---
## 📥 Installation & Setup
### Prerequisites
- **Node.js** (v18+)
- **Python** (3.10+)
- **Visual Studio Build Tools** (for compiling Python dependencies like TA-Lib)
### 1. Clone the Repository
```bash
git clone https://github.com/nbmsystemas/QuantumLlamaTerminal.git
cd QuantumLlamaTerminal
```
### 2. Setup Backend (Python)
```bash
# Create and activate virtual environment
python -m venv venv
venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
```
### 3. Setup Frontend (Electron)
```bash
npm install
```
### 4. Run Development Servers
**Start Backend:**
```bash
venv\Scripts\python.exe run.py
# Alternatively: start_server.bat
```
**Start Desktop App (in a new terminal):**
```bash
npm start
# Alternatively: start_desktop.bat
```
### 5. Build for Production
```bash
npm run dist
```
*This command will obfuscate both the Python backend and JavaScript frontend, then package the application using `electron-builder`.*
---
## 🛡️ License
This project is licensed under the [MIT License](LICENSE).
---
<p align="center">
 <em>Built with ❤️ by the Quantum Llama Team.</em>
</p>