Loading repository data…
Loading repository data…
chrisnov-it / repository
AI-powered modular trading bot built with Python & Flask. Supports MetaTrader 5 with backtesting, strategy testing, and a modern web dashboard.
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
QuantumBotX is a Windows-first trading bot and backtesting platform for
MetaTrader 5. The main branch is intentionally kept focused on MT5 so users
can install, test, and run the current app without confusion from experimental
cross-platform work.
🚧 Development Status: Actively maintained but built in spare time. New features and fixes land when the developer's schedule allows. Contributions, ideas, and bug reports are always welcome.
Use this project for education, research, demo trading, and strategy validation. Always test on a demo account before considering any live trading.
Experimental cross-platform work belongs on dedicated development branches, not
on main.
For operational updates, setup-impacting fixes, and repository maintenance notes, see CHANGELOG.md.
3.12.x (tested with 3.12.10).3.13 and 3.14 may work, but are currently treated
as compatibility tests, not primary baseline.mainClone the repository:
git clone https://github.com/chrisnov-it/quantumbotx.git
cd quantumbotx
Create and activate a virtual environment:
py -3.12 -m venv venv
.\venv\Scripts\activate
Install dependencies:
pip install -r requirements.txt
Install and open MetaTrader 5.
Log in to a demo account first and keep the terminal running while using QuantumBotX.
Configure .env:
copy .env.example .env
Then fill in:
MT5_LOGIN=your_mt5_login
MT5_PASSWORD=your_mt5_password
MT5_SERVER=your_broker_server
SECRET_KEY=change_me
DB_NAME=bots.db
Initialize local database schema (first run):
python init_db.py
Start the app:
python run.py
The project includes an MT5 setup helper:
python install_mt5_integration.py
Use it to check Python compatibility, MetaTrader5 package availability, MT5 terminal installation, and basic environment setup.
For more detail, see MT5_SETUP_GUIDE.md.
QuantumBotX can download historical OHLCV data through MT5 and use it for strategy testing. Typical workflows:
python lab/download_data.py.You can run a preset batch backtest tuned for broker environments:
py -3.12 lab/run_preset_backtests.py
Optional:
py -3.12 lab/run_preset_backtests.py --preset xm_demo.json --tail 5000
Preset files are stored in:
config/presets/xm_demo.jsonconfig/presets/fbs_demo.jsonResults are saved to logs/preset_backtest_results.json.
Supported markets depend on the connected MT5 broker. Common examples include:
| Difficulty | Strategies |
|---|---|
| 🟢 Beginner | MA Crossover, RSI Crossover, Turtle Breakout |
| 🟡 Intermediate | Bollinger Reversion, Bollinger Squeeze, Ichimoku Cloud, Pulse Sync, Index Momentum, QuantumBotX Hybrid, QuantumBotX Crypto |
| 🔴 Advanced | Quantum Velocity, Mercy Edge, Dynamic Breakout, Index Breakout Pro |
Strategy availability and behavior are validated by:
python testing/validate_all_strategies.py
Public-safe tests and diagnostics belong in testing/.
Local account-specific scripts, broker diagnostics, recovery scripts, logs, and
anything with private account context belong in testing_private/, which is
ignored by Git.
README.md is the canonical public README.ROADMAP.md describes the current MT5-focused direction for main.MEMORY.md, TASKS.md, RETROSPECT.md, and
WALKTHROUGH.md are ignored and should not be committed publicly..env, database files, logs, and broker
state files out of Git.If MT5 connection fails:
.env.If dependency installation fails:
python -m pip install --upgrade pip.pip install -r requirements.txt.If you see database errors like no such table: bots:
python init_db.py once in the project root.python run.py from the same project folder.If git pull shows many conflicts after a forced remote update:
git merge --abortgit fetch origin && git reset --hard origin/main && git clean -fdTrading foreign exchange, CFDs, crypto CFDs, and other leveraged products involves significant risk. This software is provided for educational and research purposes only. The author is not responsible for financial losses, missed trades, broker issues, execution errors, or misuse of the software.
Always validate on a demo account and use conservative risk settings.
This project is licensed under the MIT License. See LICENSE.md.
Developed by Chrisnov IT Solutions.