# adv-andrew/mcmc-cuda-model architecture

> Architecture diagram of the GitHub repository adv-andrew/mcmc-cuda-model, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/adv-andrew/mcmc-cuda-model
- Repository: https://github.com/adv-andrew/mcmc-cuda-model

## Overview

This is an MCMC-driven trading system: its primary workflow generates probabilistic signals, filters/ranks opportunities, and presents options recommendations; separate stock-trading and backtesting workflows reuse the signal engine. Backtesting simulates trades and calculates performance, while optimization searches strategy parameters. The README documents GPU acceleration and regime/momentum filtering. Several source excerpts are partial, so links are limited to calls shown in excerpts, SOURCE INDEX references, or documented workflows; unverified subsystem connections are omitted.

Main entry points: [`backtesting/engine.py`](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/backtesting/engine.py) (Backtest engine), [`trading/indicator.py`](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/trading/indicator.py) (MCMC indicator), [`scripts/run_paper_trader.py`](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/scripts/run_paper_trader.py) (Paper trader command), [`backtesting/data_loader.py`](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/backtesting/data_loader.py) (OHLCV data loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_signals["Signal generation"]
  node_options_now["Options signals<br/>[options_now.py]"]
  node_options_conservative["Regime-filtered options"]
  node_stock_signals["Stock signals<br/>[get_signals.py]"]
  node_indicator["MCMC indicator<br/>[indicator.py]"]
  node_combiner["Signal combiner<br/>[signal_combiner.py]"]
end

subgraph group_backtesting["Backtesting"]
  node_loader["OHLCV data loader<br/>[data_loader.py]"]
  node_options_backtest["Options backtest"]
  node_backtest_command["Stock backtest command<br/>[run_backtest.py]"]
  node_engine["Backtest engine<br/>[engine.py]"]
  node_metrics["Performance metrics<br/>[metrics.py]"]
end

subgraph group_execution["Trading and risk"]
  node_paper_command["Paper trader command"]
  node_broker["Paper broker<br/>[paper.py]"]
  node_broker_api["Broker interface<br/>[base.py]"]
  node_risk["Risk manager<br/>[risk_manager.py]"]
  node_positions["Position manager"]
end

subgraph group_optimization["Optimization"]
  node_optimizer_command["Optimizer command<br/>[run_optimizer.py]"]
  node_optimizer["Parameter optimizer<br/>[optimizer.py]"]
  node_fitness["Fitness evaluator<br/>[fitness.py]"]
end

subgraph group_integrations["Integrations"]
  node_openai["OpenAI validator"]
  node_agents["TradingAgents bridge"]
end

node_trader(("Trader"))
node_market_data["Market data provider"]

node_trader -->|"requests signals"| node_options_now
node_options_now -->|"generates forecasts"| node_indicator
node_trader -->|"requests filtered signals"| node_options_conservative
node_options_conservative -->|"generates forecasts"| node_indicator
node_trader -->|"requests stock signals"| node_stock_signals
node_stock_signals -->|"generates signals"| node_indicator
node_stock_signals -->|"validates signals"| node_openai
node_market_data -->|"provides OHLCV"| node_loader
node_trader -->|"runs options backtest"| node_options_backtest
node_options_backtest -->|"generates forecasts"| node_indicator
node_trader -->|"runs stock backtest"| node_backtest_command
node_backtest_command -->|"loads market data"| node_loader
node_backtest_command -->|"runs simulation"| node_engine
node_engine -->|"places simulated trades"| node_broker
node_engine -->|"requests signals"| node_indicator
node_engine -->|"checks exits"| node_risk
node_engine -->|"calculates performance"| node_metrics
node_broker -->|"implements interface"| node_broker_api
node_paper_command -->|"loads market data"| node_loader
node_paper_command -->|"executes paper trades"| node_broker
node_paper_command -->|"requests signals"| node_indicator
node_paper_command -->|"checks trade risk"| node_risk
node_risk -->|"reads account state"| node_broker_api
node_trader -->|"runs optimization"| node_optimizer_command
node_optimizer_command -->|"loads market data"| node_loader
node_optimizer_command -->|"starts search"| node_optimizer
node_optimizer -->|"scores parameters"| node_fitness
node_fitness -->|"runs simulation"| node_engine

click node_options_now "https://github.com/adv-andrew/mcmc-cuda-model/blob/main/scripts/options_now.py"
click node_options_conservative "https://github.com/adv-andrew/mcmc-cuda-model/blob/main/scripts/options_signal_v4.py"
click node_stock_signals "https://github.com/adv-andrew/mcmc-cuda-model/blob/main/scripts/get_signals.py"
click node_indicator "https://github.com/adv-andrew/mcmc-cuda-model/blob/main/trading/indicator.py"
click node_loader "https://github.com/adv-andrew/mcmc-cuda-model/blob/main/backtesting/data_loader.py"
click node_options_backtest "https://github.com/adv-andrew/mcmc-cuda-model/blob/main/scripts/backtest_options_v4.py"
click node_backtest_command "https://github.com/adv-andrew/mcmc-cuda-model/blob/main/scripts/run_backtest.py"
click node_engine "https://github.com/adv-andrew/mcmc-cuda-model/blob/main/backtesting/engine.py"
click node_metrics "https://github.com/adv-andrew/mcmc-cuda-model/blob/main/backtesting/metrics.py"
click node_paper_command "https://github.com/adv-andrew/mcmc-cuda-model/blob/main/scripts/run_paper_trader.py"
click node_broker "https://github.com/adv-andrew/mcmc-cuda-model/blob/main/brokers/paper.py"
click node_broker_api "https://github.com/adv-andrew/mcmc-cuda-model/blob/main/brokers/base.py"
click node_risk "https://github.com/adv-andrew/mcmc-cuda-model/blob/main/trading/risk_manager.py"
click node_positions "https://github.com/adv-andrew/mcmc-cuda-model/blob/main/trading/position_manager.py"
click node_combiner "https://github.com/adv-andrew/mcmc-cuda-model/blob/main/trading/signal_combiner.py"
click node_optimizer_command "https://github.com/adv-andrew/mcmc-cuda-model/blob/main/scripts/run_optimizer.py"
click node_optimizer "https://github.com/adv-andrew/mcmc-cuda-model/blob/main/optimization/optimizer.py"
click node_fitness "https://github.com/adv-andrew/mcmc-cuda-model/blob/main/optimization/fitness.py"
click node_openai "https://github.com/adv-andrew/mcmc-cuda-model/blob/main/integrations/openai_validator.py"
click node_agents "https://github.com/adv-andrew/mcmc-cuda-model/blob/main/integrations/tradingagents_bridge.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_options_now,node_options_conservative,node_stock_signals,node_indicator,node_combiner toneBlue
class node_loader,node_options_backtest,node_backtest_command,node_engine,node_metrics toneAmber
class node_paper_command,node_broker,node_broker_api,node_risk,node_positions toneMint
class node_optimizer_command,node_optimizer,node_fitness toneRose
class node_openai,node_agents,node_trader,node_market_data toneIndigo
```

## Components

### Signal generation

- [Options signals](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/scripts/options_now.py): `scripts/options_now.py`
- [Regime-filtered options](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/scripts/options_signal_v4.py): `scripts/options_signal_v4.py`
- [Stock signals](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/scripts/get_signals.py): `scripts/get_signals.py`
- [MCMC indicator](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/trading/indicator.py): `trading/indicator.py`
- [Signal combiner](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/trading/signal_combiner.py): `trading/signal_combiner.py`

### Backtesting

- [OHLCV data loader](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/backtesting/data_loader.py): `backtesting/data_loader.py`
- [Options backtest](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/scripts/backtest_options_v4.py): `scripts/backtest_options_v4.py`
- [Stock backtest command](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/scripts/run_backtest.py): `scripts/run_backtest.py`
- [Backtest engine](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/backtesting/engine.py): `backtesting/engine.py`
- [Performance metrics](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/backtesting/metrics.py): `backtesting/metrics.py`

### Trading and risk

- [Paper trader command](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/scripts/run_paper_trader.py): `scripts/run_paper_trader.py`
- [Paper broker](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/brokers/paper.py): `brokers/paper.py`
- [Broker interface](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/brokers/base.py): `brokers/base.py`
- [Risk manager](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/trading/risk_manager.py): `trading/risk_manager.py`
- [Position manager](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/trading/position_manager.py): `trading/position_manager.py`

### Optimization

- [Optimizer command](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/scripts/run_optimizer.py): `scripts/run_optimizer.py`
- [Parameter optimizer](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/optimization/optimizer.py): `optimization/optimizer.py`
- [Fitness evaluator](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/optimization/fitness.py): `optimization/fitness.py`

### Integrations

- [OpenAI validator](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/integrations/openai_validator.py): `integrations/openai_validator.py`
- [TradingAgents bridge](https://github.com/adv-andrew/mcmc-cuda-model/blob/main/integrations/tradingagents_bridge.py): `integrations/tradingagents_bridge.py`

### Other components

- **Trader**
- **Market data provider**

## Connections

- Trader → Options signals: requests signals (evidence: `README.md`)
- Options signals → MCMC indicator: generates forecasts (evidence: `scripts/options_now.py`)
- Trader → Regime-filtered options: requests filtered signals (evidence: `README.md`)
- Regime-filtered options → MCMC indicator: generates forecasts (evidence: `scripts/options_signal_v4.py`)
- Trader → Stock signals: requests stock signals (evidence: `README.md`)
- Stock signals → MCMC indicator: generates signals (evidence: `scripts/get_signals.py`)
- Stock signals → OpenAI validator: validates signals (evidence: `scripts/get_signals.py`)
- Market data provider → OHLCV data loader: provides OHLCV (evidence: `backtesting/data_loader.py`)
- Trader → Options backtest: runs options backtest (evidence: `README.md`)
- Options backtest → MCMC indicator: generates forecasts (evidence: `scripts/backtest_options_v4.py`)
- Trader → Stock backtest command: runs stock backtest (evidence: `README.md`)
- Stock backtest command → OHLCV data loader: loads market data (evidence: `scripts/run_backtest.py`)
- Stock backtest command → Backtest engine: runs simulation (evidence: `scripts/run_backtest.py`)
- Backtest engine → Paper broker: places simulated trades (evidence: `backtesting/engine.py`)
- Backtest engine → MCMC indicator: requests signals (evidence: `backtesting/engine.py`)
- Backtest engine → Risk manager: checks exits (evidence: `backtesting/engine.py`)
- Backtest engine → Performance metrics: calculates performance (evidence: `backtesting/engine.py`)
- Paper broker → Broker interface: implements interface (evidence: `brokers/paper.py`)
- Paper trader command → OHLCV data loader: loads market data (evidence: `scripts/run_paper_trader.py`)
- Paper trader command → Paper broker: executes paper trades (evidence: `scripts/run_paper_trader.py`)
- Paper trader command → MCMC indicator: requests signals (evidence: `scripts/run_paper_trader.py`)
- Paper trader command → Risk manager: checks trade risk (evidence: `scripts/run_paper_trader.py`)
- Risk manager → Broker interface: reads account state (evidence: `trading/risk_manager.py`)
- Trader → Optimizer command: runs optimization (evidence: `README.md`)
- Optimizer command → OHLCV data loader: loads market data (evidence: `scripts/run_optimizer.py`)
- Optimizer command → Parameter optimizer: starts search (evidence: `scripts/run_optimizer.py`)
- Parameter optimizer → Fitness evaluator: scores parameters (evidence: `optimization/optimizer.py`)
- Fitness evaluator → Backtest engine: runs simulation (evidence: `optimization/fitness.py`)
