# triqbit/mt5-ai-xauusd-trader architecture

> Architecture diagram of the GitHub repository triqbit/mt5-ai-xauusd-trader, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/triqbit/mt5-ai-xauusd-trader
- Repository: https://github.com/triqbit/mt5-ai-xauusd-trader

## Overview

This is an MT5-focused algorithmic trading system for market analysis, model-driven signal generation, risk-controlled execution, and research. The documented user workflow is to configure the bot, run it through the CLI in demo or live mode, and evaluate strategies using backtests or research tools. The graph preserves the README’s intelligence, risk, monitoring, connector, and evaluation capabilities. Several implementation relationships are based on documented capabilities rather than inspected call sites; those links are dashed and marked unverified.

Main entry points: [`main.py`](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/main.py) (Trading CLI), [`src/trading/risk_manager.py`](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/trading/risk_manager.py) (Risk management), [`src/core/trade_logger.py`](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/core/trade_logger.py) (Trade logging), [`src/models/ensemble.py`](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/models/ensemble.py) (Model ensemble)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and configuration"]
  node_cli["Trading CLI<br/>[main.py]"]
  node_settings["Configuration<br/>[config.py]"]
end

subgraph group_intelligence["Market intelligence"]
  node_features["Feature engineering"]
  node_events["Event intelligence"]
  node_regime["Regime detection<br/>[regime_detector.py]"]
  node_models["Model ensemble<br/>[ensemble.py]"]
  node_decisions["Decision support"]
  node_explain["Signal explainability<br/>[explainability.py]"]
end

subgraph group_execution["Trading and risk"]
  node_filter["Execution filter"]
  node_risk["Risk management<br/>[risk_manager.py]"]
  node_riskengine["Risk engine<br/>[risk_engine.py]"]
  node_allocator["Capital allocation"]
  node_connector["MT5 connector<br/>[mt5_connector.py]"]
end

subgraph group_operations["Operations and records"]
  node_database[("Trade database<br/>[database.py]")]
  node_trade_log["Trade logging<br/>[trade_logger.py]"]
  node_monitor["Monitoring and alerts<br/>[monitor.py]"]
end

subgraph group_research["Evaluation and research"]
  node_backtest["Backtesting<br/>[backtester.py]"]
  node_research["Research reporting<br/>[reporting.py]"]
  node_benchmarks["Benchmarks<br/>[benchmarks.py]"]
  node_stress["Stress testing<br/>[stress_lab.py]"]
  node_journal["Journal mining<br/>[journal_mining.py]"]
end

node_operator(("Operator"))
node_mt5["MetaTrader 5"]

node_operator -->|"runs"| node_cli
node_cli -.->|"loads settings"| node_settings
node_cli -.->|"analyzes market"| node_features
node_features -.->|"provides features"| node_models
node_events -.->|"informs decisions"| node_decisions
node_regime -.->|"supplies regime"| node_models
node_models -.->|"votes on signals"| node_decisions
node_decisions -.->|"explains signals"| node_explain
node_cli -.->|"vets entries"| node_filter
node_filter -.->|"checks risk"| node_risk
node_risk -.->|"applies safeguards"| node_riskengine
node_risk -.->|"sizes exposure"| node_allocator
node_cli -.->|"starts execution"| node_connector
node_connector -->|"connects to"| node_mt5
node_trade_log -->|"writes records"| node_database
node_cli -.->|"records trades"| node_trade_log
node_cli -.->|"reports health"| node_monitor
node_operator -->|"evaluates strategy"| node_backtest
node_backtest -.->|"reports results"| node_research
node_operator -.->|"runs evaluation"| node_benchmarks
node_operator -.->|"tests scenarios"| node_stress
node_trade_log -.->|"provides trade history"| node_journal
node_journal -.->|"supports analysis"| node_research

click node_cli "https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/main.py"
click node_settings "https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/core/config.py"
click node_features "https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/core/feature_engineering.py"
click node_events "https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/data/event_intelligence.py"
click node_regime "https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/models/regime_detector.py"
click node_models "https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/models/ensemble.py"
click node_decisions "https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/core/decision_support.py"
click node_explain "https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/core/explainability.py"
click node_filter "https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/trading/execution_filter.py"
click node_risk "https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/trading/risk_manager.py"
click node_riskengine "https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/trading/risk_engine.py"
click node_allocator "https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/trading/capital_allocator.py"
click node_connector "https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/trading/mt5_connector.py"
click node_database "https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/core/database.py"
click node_trade_log "https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/core/trade_logger.py"
click node_monitor "https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/core/monitor.py"
click node_backtest "https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/trading/backtester.py"
click node_research "https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/research/reporting.py"
click node_benchmarks "https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/research/benchmarks.py"
click node_stress "https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/research/stress_lab.py"
click node_journal "https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/analytics/journal_mining.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_settings toneBlue
class node_features,node_events,node_regime,node_models,node_decisions,node_explain toneAmber
class node_filter,node_risk,node_riskengine,node_allocator,node_connector toneMint
class node_database,node_trade_log,node_monitor toneRose
class node_backtest,node_research,node_benchmarks,node_stress,node_journal,node_operator,node_mt5 toneIndigo
```

## Components

### Entry and configuration

- [Trading CLI](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/main.py): `main.py`
- [Configuration](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/core/config.py): `src/core/config.py`

### Market intelligence

- [Feature engineering](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/core/feature_engineering.py): `src/core/feature_engineering.py`
- [Event intelligence](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/data/event_intelligence.py): `src/data/event_intelligence.py`
- [Regime detection](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/models/regime_detector.py): `src/models/regime_detector.py`
- [Model ensemble](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/models/ensemble.py): `src/models/ensemble.py`
- [Decision support](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/core/decision_support.py): `src/core/decision_support.py`
- [Signal explainability](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/core/explainability.py): `src/core/explainability.py`

### Trading and risk

- [Execution filter](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/trading/execution_filter.py): `src/trading/execution_filter.py`
- [Risk management](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/trading/risk_manager.py): `src/trading/risk_manager.py`
- [Risk engine](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/trading/risk_engine.py): `src/trading/risk_engine.py`
- [Capital allocation](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/trading/capital_allocator.py): `src/trading/capital_allocator.py`
- [MT5 connector](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/trading/mt5_connector.py): `src/trading/mt5_connector.py`

### Operations and records

- [Trade database](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/core/database.py): `src/core/database.py`
- [Trade logging](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/core/trade_logger.py): `src/core/trade_logger.py`
- [Monitoring and alerts](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/core/monitor.py): `src/core/monitor.py`

### Evaluation and research

- [Backtesting](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/trading/backtester.py): `src/trading/backtester.py`
- [Research reporting](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/research/reporting.py): `src/research/reporting.py`
- [Benchmarks](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/research/benchmarks.py): `src/research/benchmarks.py`
- [Stress testing](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/research/stress_lab.py): `src/research/stress_lab.py`
- [Journal mining](https://github.com/triqbit/mt5-ai-xauusd-trader/blob/main/src/analytics/journal_mining.py): `src/analytics/journal_mining.py`

### Other components

- **Operator**
- **MetaTrader 5**

## Connections

- Operator → Trading CLI: runs (evidence: `README.md`)
- Trading CLI → Configuration: loads settings (evidence: `main.py`)
- Trading CLI → Feature engineering: analyzes market (evidence: `main.py`)
- Feature engineering → Model ensemble: provides features
- Event intelligence → Decision support: informs decisions
- Regime detection → Model ensemble: supplies regime (evidence: `src/models/ensemble.py`)
- Model ensemble → Decision support: votes on signals
- Decision support → Signal explainability: explains signals (evidence: `src/core/decision_support.py`)
- Trading CLI → Execution filter: vets entries (evidence: `main.py`)
- Execution filter → Risk management: checks risk
- Risk management → Risk engine: applies safeguards (evidence: `src/trading/risk_manager.py`)
- Risk management → Capital allocation: sizes exposure
- Trading CLI → MT5 connector: starts execution (evidence: `main.py`)
- MT5 connector → MetaTrader 5: connects to (evidence: `README.md`)
- Trade logging → Trade database: writes records (evidence: `src/core/trade_logger.py`)
- Trading CLI → Trade logging: records trades (evidence: `main.py`)
- Trading CLI → Monitoring and alerts: reports health (evidence: `main.py`)
- Operator → Backtesting: evaluates strategy (evidence: `README.md`)
- Backtesting → Research reporting: reports results
- Operator → Benchmarks: runs evaluation
- Operator → Stress testing: tests scenarios
- Trade logging → Journal mining: provides trade history (evidence: `src/analytics/journal_mining.py`)
- Journal mining → Research reporting: supports analysis (evidence: `src/analytics/journal_mining.py`)
