===========================================
QuantumForexTrader EA - Installation Guide
===========================================

STEP-BY-STEP INSTALLATION INSTRUCTIONS

===========================================
REQUIREMENTS
===========================================

Essential:
- MetaTrader 5 (latest version recommended)
- Windows 7 or higher / macOS / Linux with Wine
- Minimum 4GB RAM
- Active internet connection
- Forex broker account with MT5 support

Optional (for Python integration):
- Python 3.8 or higher
- Required Python packages (see PYTHON_COMMANDS.txt)

===========================================
STEP 1: DOWNLOAD FILES
===========================================

Download the complete FOREX_TRADER directory containing:
- QuantumForexTrader_Base.mq5
- QuantumForexTrader_Scalper.mq5
- Include/ folder with all helpers
- Config/ folder with settings
- Python/ folder with scripts
- Docs/ folder with documentation

===========================================
STEP 2: INSTALL IN MT5
===========================================

Method 1 - Copy Entire Folder (Recommended):
1. Open MetaTrader 5
2. Click File -> Open Data Folder
3. Navigate to MQL5/Experts/
4. Copy the entire FOREX_TRADER folder here
5. Close and reopen MT5 OR press F4 and click Refresh

Method 2 - Manual File Placement:
1. Copy .mq5 files to: MQL5/Experts/FOREX_TRADER/
2. Copy Include/*.mqh to: MQL5/Experts/FOREX_TRADER/Include/
3. Copy Config files to: MQL5/Experts/FOREX_TRADER/Config/
4. Copy Python files to: MQL5/Experts/FOREX_TRADER/Python/
5. Refresh Navigator (F4)

Verify Installation:
- Open Navigator panel (Ctrl+N)
- Expand "Experts"
- Look for "FOREX_TRADER" folder
- You should see both EA files

===========================================
STEP 3: COMPILE EA
===========================================

1. Open MetaEditor (F4 from MT5)
2. Navigate to Experts/FOREX_TRADER/
3. Double-click QuantumForexTrader_Base.mq5
4. Click Compile (F7) or Tools -> Compile
5. Check for "0 errors" in Toolbox
6. Repeat for QuantumForexTrader_Scalper.mq5

If Compilation Errors:
- Verify all Include files are present
- Check folder structure matches exactly
- Ensure MT5 is updated to latest version
- Review error messages in Toolbox

===========================================
STEP 4: ATTACH EA TO CHART
===========================================

1. Open MT5
2. Open a chart (File -> New Chart -> Select pair)
3. Set timeframe:
   - Base EA: M15, M30, or H1
   - Scalper: M1 or M5
4. In Navigator, find Experts/FOREX_TRADER
5. Drag QuantumForexTrader_Base.mq5 onto chart
6. EA properties window opens

===========================================
STEP 5: CONFIGURE EA
===========================================

In EA Properties Window:

Common Tab:
- [x] Allow Algorithmic Trading
- [x] Allow DLL imports (if using Python)
- [x] Allow WebRequest (optional)
- Set Magic Number (default OK)

Inputs Tab:
Option A - Load Preset:
- Click "Load"
- Navigate to Config/
- Select QuantumForexTrader_Base.set
- Click OK

Option B - Manual Configuration:
- Review and adjust parameters
- See CONFIGURATION.txt for details
- Key settings:
  * UseQuantumAnalysis = true
  * QuantumConfidenceThreshold = 60
  * BaseRiskPercent = 1.5
  * MaxConcurrentPositions = 5

Dependencies Tab:
- Usually no changes needed
- MQL5 libraries included with MT5

Click OK to attach EA

===========================================
STEP 6: ENABLE AUTOTRADING
===========================================

1. Check green "AutoTrading" button is active (top toolbar)
2. If not, click it or press F7
3. EA should show smiley face in top-right of chart
4. Check Expert tab for initialization message

Successful Initialization Shows:
"========================================"
"QuantumForexTrader Base - Initialized"
"Symbol: EURUSD"
"Quantum Analysis: Enabled"
"Active Strategies: 4"
"Target Win Rate: 60-70% (Quantum Enhanced)"
"========================================"

===========================================
STEP 7: VERIFY OPERATION
===========================================

Initial Checks:
1. EA shows smiley face (not sad face)
2. No errors in Expert tab
3. Quantum components initialized successfully
4. Indicators loaded without errors
5. Account allows automated trading

Test on Demo First:
- ALWAYS test on demo account initially
- Run for at least 2-4 weeks
- Monitor performance metrics
- Adjust parameters as needed
- Only move to live after consistent profitability

===========================================
STEP 8: OPTIONAL - PYTHON SETUP
===========================================

Note: Python integration is OPTIONAL
EA works fully without Python

If you want Python integration:
1. Install Python 3.8+
2. Install required packages
3. Run setup script
4. Configure file paths
5. Set UsePythonIntegration = true

See PYTHON_COMMANDS.txt for detailed instructions

===========================================
TROUBLESHOOTING INSTALLATION
===========================================

EA Not Appearing in Navigator:
- Verify files are in correct location
- Refresh Navigator (right-click -> Refresh)
- Restart MT5
- Check file permissions

Compilation Errors:
- Error: "Include file not found"
  Solution: Verify Include folder structure
  
- Error: "Undeclared identifier"
  Solution: Check all .mqh files are present
  
- Error: "Invalid version"
  Solution: Update MT5 to latest version

EA Not Starting:
- Check AutoTrading is enabled
- Verify account allows automated trading
- Review Expert tab for error messages
- Check EA inputs are valid

Initialization Failed:
- Check indicator handles created successfully
- Verify sufficient bar history
- Confirm symbol/timeframe compatibility
- Review initialization message for details

===========================================
FOLDER STRUCTURE REFERENCE
===========================================

Correct structure:
MQL5/
└── Experts/
    └── FOREX_TRADER/
        ├── QuantumForexTrader_Base.mq5
        ├── QuantumForexTrader_Scalper.mq5
        ├── run_quantum_python.bat
        ├── PYTHON_COMMANDS.txt
        ├── Include/
        │   ├── QuantumSignals.mqh
        │   ├── QuantumAnalysis.mqh
        │   ├── BinaryEncoder.mqh
        │   ├── QuantumRiskManager.mqh
        │   └── PythonBridge.mqh
        ├── Config/
        │   ├── QuantumForexTrader_Base.set
        │   ├── QuantumForexTrader_Scalper.set
        │   ├── QuantumForexTrader_Base.ini
        │   └── QuantumForexTrader_Scalper.ini
        ├── Python/
        │   ├── quantum_analysis.py
        │   └── quantum_visual.py
        └── Docs/
            ├── USAGE_INSTRUCTIONS.txt
            ├── INSTALLATION.txt (this file)
            ├── CONFIGURATION.txt
            └── QUANTUM_THEORY.txt

===========================================
POST-INSTALLATION CHECKLIST
===========================================

□ EA files copied to correct location
□ Include files in Include folder
□ Config files in Config folder
□ EA compiled without errors
□ EA attached to appropriate chart
□ AutoTrading enabled
□ EA shows smiley face
□ Initialization successful
□ No errors in Expert tab
□ Demo account testing started
□ Performance monitoring set up

===========================================
NEXT STEPS
===========================================

After successful installation:
1. Read USAGE_INSTRUCTIONS.txt thoroughly
2. Review CONFIGURATION.txt for parameter tuning
3. Study QUANTUM_THEORY.txt to understand mechanics
4. Start with demo account
5. Monitor performance for 2-4 weeks
6. Adjust parameters based on results
7. Only move to live trading when consistently profitable

===========================================
SUPPORT
===========================================

For installation issues:
1. Review troubleshooting section above
2. Check MT5 Expert tab for error messages
3. Verify all files are in correct locations
4. Test compilation in MetaEditor
5. Consult GitHub repository for updates

Repository:
https://github.com/simonokwundue-ops/Experienced-FX-Trader

===========================================