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.

---

## Quick Start

### 1. Install 

Install the 6 files located in the releases section (most recent ones preferred).
- Place all EAs (5) .ex5 files in your MQL5\\Experts\\ folder
- Place the DLL DllFileSelctDialog.dll in your MQL5\\Libraries\\ folder
- Place the executable file py_trainer.exe in a folder relative to your terminal path or a custom location.
  
> You must have the following products purchased:
> - ICTLibrary (https://www.thebotplace.com/bot/ict-fastlibrary)
> - FastNL (https://www.thebotplace.com/bot/fast-newslibrary)

### 2. Check the wiki's quick start
Visit the wiki: https://forge.mql5.io/nique_372/AiDataTaskRuner/wiki/QuickStartPanelUse

 
---

## 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
```

---

## Requirements
- If you only want to use the bot, you don't need to download anything else besides the ex5 files. Otherwise, if you want the code, you should check the file:
> - [dependencies.json](./dependencies.json) file.
- In addition, review the following requirements.txt file for the necessary requirements for Python (using the MCP server).
> - [requirements.txt](./requirements.txt) file.

--- 

## Installation of repo code
- Clone the git repository into shared projects via cmd.
- Contact me privately on MQL5 chats (user: nique_372) to be added as a collaborator with your MQL5 nickname (read-only access), which will make the repository automatically appear in your Shared Projects folder.
- Fork the repository.

---

## 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.

---

## License

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

---

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