# mementum/backtrader architecture

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

- Interactive diagram: https://gitdiagram.com/mementum/backtrader
- Repository: https://github.com/mementum/backtrader
- Video tour (about a minute): https://gitdiagram.com/mementum/backtrader/video

## Overview

Backtrader is a Python backtesting and live-trading platform. The main workflow is to configure Cerebro with market data and strategies, run the strategy against feeds and a broker, then inspect results through analyzers, observers, or plots. Its domain capabilities include feed conversion and resampling, indicators, order sizing and execution, and live broker integrations. The line-buffer/iterator machinery is an important internal layer supporting time-series calculations. The graph uses README-documented workflow links where implementation excerpts are incomplete; it does not imply unsampled call details.

Main entry points: [`backtrader/cerebro.py`](https://github.com/mementum/backtrader/blob/master/backtrader/cerebro.py) (Cerebro engine), [`backtrader/strategy.py`](https://github.com/mementum/backtrader/blob/master/backtrader/strategy.py) (Strategy runtime), [`backtrader/feed.py`](https://github.com/mementum/backtrader/blob/master/backtrader/feed.py) (Data feeds), [`backtrader/brokers/bbroker.py`](https://github.com/mementum/backtrader/blob/master/backtrader/brokers/bbroker.py) (Broker execution)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Run orchestration"]
  node_cerebro["Cerebro engine<br/>[cerebro.py]"]
end

subgraph group_marketdata["Market data"]
  node_feed["Data feeds<br/>[feed.py]"]
  node_feed_adapters["Feed adapters"]
  node_filters["Filters and resampling<br/>[resamplerfilter.py]"]
  node_calendar["Trading calendars<br/>[tradingcal.py]"]
  node_live_stores["Live stores"]
end

subgraph group_strategy["Strategy and signals"]
  node_line_engine["Line engine<br/>[linebuffer.py]"]
  node_indicators["Indicators"]
  node_strategy_runtime["Strategy runtime<br/>[strategy.py]"]
end

subgraph group_execution["Trading execution"]
  node_sizers["Position sizing"]
  node_orders["Orders and positions<br/>[order.py]"]
  node_broker["Broker execution<br/>[bbroker.py]"]
  node_commissions["Commission schemes<br/>[comminfo.py]"]
end

subgraph group_results["Results and presentation"]
  node_analyzers["Analyzers"]
  node_observers["Observers"]
  node_writer["Result writer<br/>[writer.py]"]
  node_plotter["Plotting<br/>[plot.py]"]
end

node_user(("Strategy author"))

node_user -->|"configures and runs"| node_cerebro
node_user -->|"defines strategy"| node_strategy_runtime
node_cerebro -->|"runs feeds"| node_feed
node_cerebro -->|"runs strategies"| node_strategy_runtime
node_feed_adapters -.->|"provides feeds"| node_feed
node_feed -->|"filters and resamples"| node_filters
node_feed -.->|"uses live sources"| node_live_stores
node_strategy_runtime -->|"evaluates signals"| node_indicators
node_indicators -->|"operates on lines"| node_line_engine
node_strategy_runtime -->|"sizes orders"| node_sizers
node_strategy_runtime -->|"submits orders"| node_orders
node_broker -->|"executes and updates"| node_orders
node_broker -.->|"applies commissions"| node_commissions
node_cerebro -->|"runs broker"| node_broker
node_cerebro -->|"collects analysis"| node_analyzers
node_cerebro -->|"attaches observers"| node_observers
node_cerebro -.->|"writes results"| node_writer
node_cerebro -->|"plots results"| node_plotter
node_cerebro -.->|"supports scheduling"| node_calendar

click node_cerebro "https://github.com/mementum/backtrader/blob/master/backtrader/cerebro.py"
click node_feed "https://github.com/mementum/backtrader/blob/master/backtrader/feed.py"
click node_feed_adapters "https://github.com/mementum/backtrader/tree/master/backtrader/feeds"
click node_filters "https://github.com/mementum/backtrader/blob/master/backtrader/resamplerfilter.py"
click node_calendar "https://github.com/mementum/backtrader/blob/master/backtrader/tradingcal.py"
click node_live_stores "https://github.com/mementum/backtrader/tree/master/backtrader/stores"
click node_line_engine "https://github.com/mementum/backtrader/blob/master/backtrader/linebuffer.py"
click node_indicators "https://github.com/mementum/backtrader/tree/master/backtrader/indicators"
click node_strategy_runtime "https://github.com/mementum/backtrader/blob/master/backtrader/strategy.py"
click node_sizers "https://github.com/mementum/backtrader/tree/master/backtrader/sizers"
click node_orders "https://github.com/mementum/backtrader/blob/master/backtrader/order.py"
click node_broker "https://github.com/mementum/backtrader/blob/master/backtrader/brokers/bbroker.py"
click node_commissions "https://github.com/mementum/backtrader/blob/master/backtrader/comminfo.py"
click node_analyzers "https://github.com/mementum/backtrader/tree/master/backtrader/analyzers"
click node_observers "https://github.com/mementum/backtrader/tree/master/backtrader/observers"
click node_writer "https://github.com/mementum/backtrader/blob/master/backtrader/writer.py"
click node_plotter "https://github.com/mementum/backtrader/blob/master/backtrader/plot/plot.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_cerebro toneBlue
class node_feed,node_feed_adapters,node_filters,node_calendar,node_live_stores toneAmber
class node_line_engine,node_indicators,node_strategy_runtime toneMint
class node_sizers,node_orders,node_broker,node_commissions toneRose
class node_analyzers,node_observers,node_writer,node_plotter,node_user toneIndigo
```

## Components

### Run orchestration

- [Cerebro engine](https://github.com/mementum/backtrader/blob/master/backtrader/cerebro.py): `backtrader/cerebro.py`

### Market data

- [Data feeds](https://github.com/mementum/backtrader/blob/master/backtrader/feed.py): `backtrader/feed.py`
- [Feed adapters](https://github.com/mementum/backtrader/tree/master/backtrader/feeds): `backtrader/feeds`
- [Filters and resampling](https://github.com/mementum/backtrader/blob/master/backtrader/resamplerfilter.py): `backtrader/resamplerfilter.py`
- [Trading calendars](https://github.com/mementum/backtrader/blob/master/backtrader/tradingcal.py): `backtrader/tradingcal.py`
- [Live stores](https://github.com/mementum/backtrader/tree/master/backtrader/stores): `backtrader/stores`

### Strategy and signals

- [Line engine](https://github.com/mementum/backtrader/blob/master/backtrader/linebuffer.py): `backtrader/linebuffer.py`
- [Indicators](https://github.com/mementum/backtrader/tree/master/backtrader/indicators): `backtrader/indicators`
- [Strategy runtime](https://github.com/mementum/backtrader/blob/master/backtrader/strategy.py): `backtrader/strategy.py`

### Trading execution

- [Position sizing](https://github.com/mementum/backtrader/tree/master/backtrader/sizers): `backtrader/sizers`
- [Orders and positions](https://github.com/mementum/backtrader/blob/master/backtrader/order.py): `backtrader/order.py`
- [Broker execution](https://github.com/mementum/backtrader/blob/master/backtrader/brokers/bbroker.py): `backtrader/brokers/bbroker.py`
- [Commission schemes](https://github.com/mementum/backtrader/blob/master/backtrader/comminfo.py): `backtrader/comminfo.py`

### Results and presentation

- [Analyzers](https://github.com/mementum/backtrader/tree/master/backtrader/analyzers): `backtrader/analyzers`
- [Observers](https://github.com/mementum/backtrader/tree/master/backtrader/observers): `backtrader/observers`
- [Result writer](https://github.com/mementum/backtrader/blob/master/backtrader/writer.py): `backtrader/writer.py`
- [Plotting](https://github.com/mementum/backtrader/blob/master/backtrader/plot/plot.py): `backtrader/plot/plot.py`

### Other components

- **Strategy author**

## Connections

- Strategy author → Cerebro engine: configures and runs
- Strategy author → Strategy runtime: defines strategy
- Cerebro engine → Data feeds: runs feeds (evidence: `backtrader/cerebro.py`)
- Cerebro engine → Strategy runtime: runs strategies (evidence: `backtrader/cerebro.py`)
- Feed adapters → Data feeds: provides feeds (evidence: `backtrader/feeds/ibdata.py`)
- Data feeds → Filters and resampling: filters and resamples (evidence: `backtrader/feed.py`)
- Data feeds → Live stores: uses live sources (evidence: `backtrader/stores/vcstore.py`)
- Strategy runtime → Indicators: evaluates signals
- Indicators → Line engine: operates on lines
- Strategy runtime → Position sizing: sizes orders (evidence: `backtrader/strategy.py`)
- Strategy runtime → Orders and positions: submits orders
- Broker execution → Orders and positions: executes and updates (evidence: `backtrader/brokers/bbroker.py`)
- Broker execution → Commission schemes: applies commissions (evidence: `backtrader/brokers/bbroker.py`)
- Cerebro engine → Broker execution: runs broker (evidence: `backtrader/cerebro.py`)
- Cerebro engine → Analyzers: collects analysis
- Cerebro engine → Observers: attaches observers (evidence: `backtrader/cerebro.py`)
- Cerebro engine → Result writer: writes results (evidence: `backtrader/cerebro.py`)
- Cerebro engine → Plotting: plots results
- Cerebro engine → Trading calendars: supports scheduling (evidence: `backtrader/cerebro.py`)
