AiDataTaskRuner/README.md

<p align="center">
  <img src="./Images/AiDataTaskRunerByLeo.png" alt="AiDataTaskRunerByLeo. Logo" width="1150" height="175"/>
</p>

<p align="center">
  Automate data generation and AI model training through a simple, easy-to-use GUI.
</p>

<p align="center">
  <img src="https://img.shields.io/badge/Language-MQL5-1B6CA8?style=flat-square"/>
  <img src="https://img.shields.io/badge/Platform-MetaTrader%205-0D1B2A?style=flat-square"/>
  <img src="https://img.shields.io/badge/Author-nique__372%20and%20Leo-C9D6DF?style=flat-square"/>
<a href="./LICENSE">
  <img src="https://img.shields.io/badge/License-Nique%26Leo%20NL--ND-red.svg"/>
</a>
</p>


---

## Features

- **Data generation | Main tab** — choose timeframe, symbol, date range and add tasks to the queue.

[![Imagen](./Images/TabGeneralMain.png)](./Images/TabGeneralMain.png)

- **Data generation | Tasks tab** — view and manage all pending, running and completed tasks.

[![Imagen](./Images/TabGeneralTask.png)](./Images/TabGeneralTask.png)

- **Settings tab** — choose the interface language.

[![Imagen](./Images/TabConfig.png)](./Images/TabConfig.png)

- **Training tab | Run** — Choose the py trainer settings and run it

[![Imagen](./Images/TabTrainingPy.png)](./Images/TabTrainingPy.png)

- **Training tab | Results** — View the results of the py training in real time

[![Imagen](./Images/TabTrainingRes.png)](./Images/TabTrainingRes.png)

- **Feature editor** — Modify\Compile (csv)\Save\Load\etc the features that your AI model will use through a simple editor for the FGBLC DSL

[![Imagen](./Images/TabFeatureEditor.png)](./Images/TabFeatureEditor.png)


- **Utils tab** — Encrypt/Decrypt/Clean folders
Useful if you want to distribute the onnx files, etc., generated by the panel
 
[![Imagen](./Images/TabUtilGeneral.png)](./Images/TabUtilGeneral.png)
 
-  **Workflows tab** — Run workflows without touching the panel
Useful for the mass automation of data generation/training of ML models
 
[![Imagen](./Images/TabWf.png)](./Images/TabWf.png)
 

- **AI tab** — configure the LLM model and control the panel via Telegram in natural language Or use MCP.

[![Imagen](./Images/TabAi.png)](./Images/TabAi.png)

**Currently supported via Telegram and MCP:**
- Query task status and count
- Add, save and load tasks
- Execute and clean all tasks
- Load and save panel configuration
- Query panel folders and settings
- Query MT5 logs, manage files, check system time

> - Results from panel operations are delivered asynchronously directly to the chat.
> - A subtab has now also been added to allow the use of MCP with the panel.

 
---

## Repository Structure

```
AiDataTaskRuner/
├── Backend/       # The backend of the panel is where the code that the tester executes for data generation is located.
├── FileInstaler/  # This is where the panel's file installer is located... such as ini files, etc.
├── DllFilseSelctDialog/ # C++ code for the DLL (this allows the use of a custom file select dialog without sandbox limitations)
├── UI/            # Frontend code for the panel (tabs and main window)
├── Images/        # Repository banner
└── Utils/         # Utility scripts for working with .set
```

---

## ⚠️ License Activation (Required)

To use the panel, two EX5 libraries are required to function.

- **McpServerByLeo**
- **LLmAgentsByLeoFinal**
- **ICT FastLibrary**

### How to activate

1. Purchase both products from my **TheBotPlace** profile:
   - https://thebotplace.com/user/46vILTzIIBbqDhugEvqWGlc8rl52

2. Retrieve your **TBP ID** from your account:
   - https://thebotplace.com/profile

---

## Requirements

### For developers (repository installation)

Before installing the repository, review the project dependencies:

- `dependencies.json`

### For end users

Download the latest release from:

https://forge.mql5.io/nique_372/AiDataTaskRuner/releases

Required files:

- `AiDataTaskRunnerByLeo.ex5`: Main control panel.
- `DllFileSelectDialog.dll`: DLL for selecting files outside the MT5 sandbox.
- `FolderTaskToCSV.ex5`: Converts organized task folders into CSV files for workflow execution.
- `FolderTaskToCSV2.ex5`:  Converts organized task folders into CSV files for workflow execution.
- `McpServ.ex5`: MCP server Expert Advisor.
- `Runner.ex5`: Expert Advisor for running the MT5 Strategy Tester.
- `RunnerWF.ex5`: Expert Advisor for executing workflows.
- `TlgBot.ex5`: Expert Advisor for Telegram integration.
- `TrainingLauncher.ex5`: Expert Advisor that launches the Python training process.
- `run_training.zip`: Complete Python training package for model training.
- `RegistryService.ex5`: Expert Advisor service that manages the SQL database containing the availability of LLM models.

---

## Repository Installation (Developers)

Clone and install the project using **tsndep**:

```bash
cd "C:\Users\YOUR_USER\AppData\Roaming\MetaQuotes\Terminal\YOUR_TERMINAL_ID\MQL5\Shared Projects"

tsndep install "https://forge.mql5.io/nique_372/AiDataTaskRuner.git"
```

### Install tsndep

The `tsndep` command is available on PyPI:

https://pypi.org/project/tsndep

`tsndep` automatically:

- Downloads all repository dependencies.
- Installs all required projects.
- Resolves repository references.

### Private repositories

If the installation fails because one or more repositories are private:

- Contactme to request access.
- If the repository belongs to a commercial product, you will need to purchase the corresponding license first.

---

## Quick Start (End Users)

### Step 1 — Install the release files

Download the latest release and install the files as follows.

### Expert Advisors (.ex5)

Copy every `.ex5` file into:

```
MQL5/Experts/
```

### DLL

Copy:

```
DllFileSelctDialog.dll
```

into:

```
MQL5/Libraries/
```

### Training package

Extract:

```
run_training.zip
```

into either:

- a folder relative to your MetaTrader terminal, or
- any custom directory you prefer.

---

### Step 2 — Open the Quick Start Guide

For a complete setup walkthrough, visit the project wiki:

https://forge.mql5.io/nique_372/AiDataTaskRuner/wiki/QuickStartPanelUse

The guide explains:

- Initial installation
- Basic configuration
- Running the first tasks
- Training setup
- Common usage workflow


---

## Documentation

Full documentation including tab-by-tab guides, parameter reference and configuration examples is available in the [Wiki](https://forge.mql5.io/nique_372/AiDataTaskRuner/wiki).


---

## Disclaimer

**Trading involves substantial risk of loss.**

- This software is a technical tool, not financial advice
- Past performance does not guarantee future results
- You are solely responsible for your trading decisions
- Always test thoroughly before deploying with real capital
- Apply appropriate risk management at all times

The authors assume no liability for trading losses, system failures, or any damages arising from the use of this software.

---

## Contact

- **Platform:** [MQL5 Community](https://www.mql5.com/es/users/nique_372)
- **Profile:** https://www.mql5.com/es/users/nique_372

---

## License

**[Read Full License](./LICENSE)**

---

<p align="center">Copyright © 2026 Nique-Leo.</p>