# logiccrafterdz/argus architecture

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

- Interactive diagram: https://gitdiagram.com/logiccrafterdz/argus
- Repository: https://github.com/logiccrafterdz/argus

## Overview

This repository’s sampled runtime is a Python quantitative trading backtester, rather than the MetaTrader Expert Advisor architecture described in the README. Its main workflow prepares strategy signals, filters them by regime and session, allocates risk, simulates trades, and reports performance; separate runners support single, portfolio, and out-of-sample runs. The tree also shows optimization, learning, sentiment, and dashboard-related capabilities, but their implementation and wiring were not sampled, so those links are omitted where unverified.

Main entry points: [`backtest/run_oos.py`](https://github.com/logiccrafterdz/argus/blob/master/backtest/run_oos.py) (OOS runner), [`backtest/run_backtest.py`](https://github.com/logiccrafterdz/argus/blob/master/backtest/run_backtest.py) (Portfolio runner), [`backtest/engine.py`](https://github.com/logiccrafterdz/argus/blob/master/backtest/engine.py) (Trade simulator), [`backtest/indicators.py`](https://github.com/logiccrafterdz/argus/blob/master/backtest/indicators.py) (Indicators and regimes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runs["Backtest Runs"]
  node_run_portfolio["Portfolio runner<br/>[run_backtest.py]"]
  node_run_oos["OOS runner<br/>[run_oos.py]"]
  node_run_single["Single runner<br/>[run_single.py]"]
  node_data[("Market data<br/>[data_fetcher.py]")]
end

subgraph group_signals["Signals and Context"]
  node_strategy_set["Strategy set"]
  node_base_strategy["Strategy base<br/>[base_strategy.py]"]
  node_trend_pullback["Trend pullback<br/>[trend_pullback.py]"]
  node_price_action["Price action S/R<br/>[price_action_sr.py]"]
  node_market_structure["Market structure"]
  node_indicators["Indicators and regimes<br/>[indicators.py]"]
  node_signal_types["Signal types<br/>[signal_types.py]"]
end

subgraph group_portfolio["Portfolio Simulation"]
  node_allocator["Risk allocator<br/>[allocator.py]"]
  node_engine["Trade simulator<br/>[engine.py]"]
  node_risk_manager["Drawdown controls<br/>[risk_manager.py]"]
end

subgraph group_research["Analysis and Research"]
  node_analytics["Performance analytics<br/>[analytics.py]"]
  node_optimization["Parameter optimization<br/>[optimize.py]"]
  node_rolling_wfa["Walk-forward analysis<br/>[rolling_wfa.py]"]
  node_scoring["Strategy scoring<br/>[scoring.py]"]
  node_learning["Strategy learning<br/>[argus_learn.py]"]
  node_sentiment["Sentiment analysis<br/>[sentiment.py]"]
  node_dashboard["Dashboard updates"]
end

node_operator(("Backtest operator"))

node_operator -->|"starts run"| node_run_portfolio
node_operator -->|"starts run"| node_run_oos
node_operator -->|"starts run"| node_run_single
node_run_portfolio -->|"executes simulation"| node_engine
node_run_oos -->|"executes simulation"| node_engine
node_run_single -->|"uses simulator"| node_engine
node_run_portfolio -->|"loads strategies"| node_strategy_set
node_run_oos -->|"loads strategies"| node_strategy_set
node_run_portfolio -->|"allocates signals"| node_allocator
node_run_oos -->|"allocates signals"| node_allocator
node_run_portfolio -.->|"loads market data"| node_data
node_run_oos -.->|"loads market data"| node_data
node_strategy_set -->|"implements interface"| node_base_strategy
node_trend_pullback -->|"uses structure"| node_market_structure
node_trend_pullback -->|"uses EMA"| node_indicators
node_price_action -->|"finds swing levels"| node_market_structure
node_price_action -->|"uses EMA"| node_indicators
node_base_strategy -->|"calculates ATR"| node_indicators
node_base_strategy -->|"sets strategy type"| node_signal_types
node_allocator -->|"detects context"| node_indicators
node_engine -->|"updates risk"| node_risk_manager
node_run_oos -->|"reports results"| node_analytics
node_rolling_wfa -->|"runs windows"| node_engine
node_rolling_wfa -->|"measures results"| node_analytics
node_learning -->|"uses scoring"| node_scoring
node_dashboard -.->|"consumes results"| node_analytics

click node_run_portfolio "https://github.com/logiccrafterdz/argus/blob/master/backtest/run_backtest.py"
click node_run_oos "https://github.com/logiccrafterdz/argus/blob/master/backtest/run_oos.py"
click node_run_single "https://github.com/logiccrafterdz/argus/blob/master/backtest/run_single.py"
click node_data "https://github.com/logiccrafterdz/argus/blob/master/backtest/data_fetcher.py"
click node_strategy_set "https://github.com/logiccrafterdz/argus/tree/master/backtest/strategies"
click node_base_strategy "https://github.com/logiccrafterdz/argus/blob/master/backtest/strategies/base_strategy.py"
click node_trend_pullback "https://github.com/logiccrafterdz/argus/blob/master/backtest/strategies/trend_pullback.py"
click node_price_action "https://github.com/logiccrafterdz/argus/blob/master/backtest/strategies/price_action_sr.py"
click node_market_structure "https://github.com/logiccrafterdz/argus/blob/master/backtest/market_structure.py"
click node_indicators "https://github.com/logiccrafterdz/argus/blob/master/backtest/indicators.py"
click node_signal_types "https://github.com/logiccrafterdz/argus/blob/master/backtest/signal_types.py"
click node_allocator "https://github.com/logiccrafterdz/argus/blob/master/backtest/allocator.py"
click node_engine "https://github.com/logiccrafterdz/argus/blob/master/backtest/engine.py"
click node_risk_manager "https://github.com/logiccrafterdz/argus/blob/master/backtest/risk_manager.py"
click node_analytics "https://github.com/logiccrafterdz/argus/blob/master/backtest/analytics.py"
click node_optimization "https://github.com/logiccrafterdz/argus/blob/master/backtest/optimize.py"
click node_rolling_wfa "https://github.com/logiccrafterdz/argus/blob/master/backtest/rolling_wfa.py"
click node_scoring "https://github.com/logiccrafterdz/argus/blob/master/skills/scripts/scoring.py"
click node_learning "https://github.com/logiccrafterdz/argus/blob/master/skills/scripts/argus_learn.py"
click node_sentiment "https://github.com/logiccrafterdz/argus/blob/master/backtest/sentiment.py"
click node_dashboard "https://github.com/logiccrafterdz/argus/blob/master/update_dashboard_v2.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_run_portfolio,node_run_oos,node_run_single,node_data toneBlue
class node_strategy_set,node_base_strategy,node_trend_pullback,node_price_action,node_market_structure,node_indicators,node_signal_types toneAmber
class node_allocator,node_engine,node_risk_manager toneMint
class node_analytics,node_optimization,node_rolling_wfa,node_scoring,node_learning,node_sentiment,node_dashboard toneRose
class node_operator toneIndigo
```

## Components

### Backtest Runs

- [Portfolio runner](https://github.com/logiccrafterdz/argus/blob/master/backtest/run_backtest.py): `backtest/run_backtest.py`
- [OOS runner](https://github.com/logiccrafterdz/argus/blob/master/backtest/run_oos.py): `backtest/run_oos.py`
- [Single runner](https://github.com/logiccrafterdz/argus/blob/master/backtest/run_single.py): `backtest/run_single.py`
- [Market data](https://github.com/logiccrafterdz/argus/blob/master/backtest/data_fetcher.py): `backtest/data_fetcher.py`

### Signals and Context

- [Strategy set](https://github.com/logiccrafterdz/argus/tree/master/backtest/strategies): `backtest/strategies`
- [Strategy base](https://github.com/logiccrafterdz/argus/blob/master/backtest/strategies/base_strategy.py): `backtest/strategies/base_strategy.py`
- [Trend pullback](https://github.com/logiccrafterdz/argus/blob/master/backtest/strategies/trend_pullback.py): `backtest/strategies/trend_pullback.py`
- [Price action S/R](https://github.com/logiccrafterdz/argus/blob/master/backtest/strategies/price_action_sr.py): `backtest/strategies/price_action_sr.py`
- [Market structure](https://github.com/logiccrafterdz/argus/blob/master/backtest/market_structure.py): `backtest/market_structure.py`
- [Indicators and regimes](https://github.com/logiccrafterdz/argus/blob/master/backtest/indicators.py): `backtest/indicators.py`
- [Signal types](https://github.com/logiccrafterdz/argus/blob/master/backtest/signal_types.py): `backtest/signal_types.py`

### Portfolio Simulation

- [Risk allocator](https://github.com/logiccrafterdz/argus/blob/master/backtest/allocator.py): `backtest/allocator.py`
- [Trade simulator](https://github.com/logiccrafterdz/argus/blob/master/backtest/engine.py): `backtest/engine.py`
- [Drawdown controls](https://github.com/logiccrafterdz/argus/blob/master/backtest/risk_manager.py): `backtest/risk_manager.py`

### Analysis and Research

- [Performance analytics](https://github.com/logiccrafterdz/argus/blob/master/backtest/analytics.py): `backtest/analytics.py`
- [Parameter optimization](https://github.com/logiccrafterdz/argus/blob/master/backtest/optimize.py): `backtest/optimize.py`
- [Walk-forward analysis](https://github.com/logiccrafterdz/argus/blob/master/backtest/rolling_wfa.py): `backtest/rolling_wfa.py`
- [Strategy scoring](https://github.com/logiccrafterdz/argus/blob/master/skills/scripts/scoring.py): `skills/scripts/scoring.py`
- [Strategy learning](https://github.com/logiccrafterdz/argus/blob/master/skills/scripts/argus_learn.py): `skills/scripts/argus_learn.py`
- [Sentiment analysis](https://github.com/logiccrafterdz/argus/blob/master/backtest/sentiment.py): `backtest/sentiment.py`
- [Dashboard updates](https://github.com/logiccrafterdz/argus/blob/master/update_dashboard_v2.py): `update_dashboard_v2.py`

### Other components

- **Backtest operator**

## Connections

- Backtest operator → Portfolio runner: starts run
- Backtest operator → OOS runner: starts run
- Backtest operator → Single runner: starts run
- Portfolio runner → Trade simulator: executes simulation (evidence: `backtest/run_backtest.py`)
- OOS runner → Trade simulator: executes simulation (evidence: `backtest/run_oos.py`)
- Single runner → Trade simulator: uses simulator (evidence: `backtest/run_single.py`)
- Portfolio runner → Strategy set: loads strategies (evidence: `backtest/run_backtest.py`)
- OOS runner → Strategy set: loads strategies (evidence: `backtest/run_oos.py`)
- Portfolio runner → Risk allocator: allocates signals (evidence: `backtest/run_backtest.py`)
- OOS runner → Risk allocator: allocates signals (evidence: `backtest/run_oos.py`)
- Portfolio runner → Market data: loads market data
- OOS runner → Market data: loads market data
- Strategy set → Strategy base: implements interface (evidence: `backtest/strategies/trend_pullback.py`)
- Trend pullback → Market structure: uses structure (evidence: `backtest/strategies/trend_pullback.py`)
- Trend pullback → Indicators and regimes: uses EMA (evidence: `backtest/strategies/trend_pullback.py`)
- Price action S/R → Market structure: finds swing levels (evidence: `backtest/strategies/price_action_sr.py`)
- Price action S/R → Indicators and regimes: uses EMA (evidence: `backtest/strategies/price_action_sr.py`)
- Strategy base → Indicators and regimes: calculates ATR (evidence: `backtest/strategies/base_strategy.py`)
- Strategy base → Signal types: sets strategy type (evidence: `backtest/strategies/base_strategy.py`)
- Risk allocator → Indicators and regimes: detects context (evidence: `backtest/allocator.py`)
- Trade simulator → Drawdown controls: updates risk (evidence: `backtest/engine.py`)
- OOS runner → Performance analytics: reports results (evidence: `backtest/run_oos.py`)
- Walk-forward analysis → Trade simulator: runs windows (evidence: `backtest/rolling_wfa.py`)
- Walk-forward analysis → Performance analytics: measures results (evidence: `backtest/rolling_wfa.py`)
- Strategy learning → Strategy scoring: uses scoring (evidence: `skills/scripts/argus_learn.py`)
- Dashboard updates → Performance analytics: consumes results
