AiDataTaskRuner/README.md
Nique_372 1f6b6b8243
2026-07-17 17:47:00 -05:00

264 lines
No EOL
7 KiB
Markdown

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