# ufund-me/qbot architecture

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

- Interactive diagram: https://gitdiagram.com/ufund-me/qbot
- Repository: https://github.com/ufund-me/qbot

## Overview

Qbot is an AI-oriented quantitative investment platform. Its documented user workflow is to obtain market data, develop and evaluate strategies through backtesting and simulated trading, then connect a strategy to automated live trading; GUI and web tools provide analysis and operation. The repository is a broad collection of related applications and engines rather than one visibly unified runtime. The graph preserves the documented product stages and sampled engine relationships; some subsystem paths and connections are based on README descriptions because their implementation was not sampled.

Main entry points: [`pytrader/easyquant/backtest_engine.py`](https://github.com/ufund-me/qbot/blob/main/pytrader/easyquant/backtest_engine.py) (Backtesting), [`pytrader/strategies`](https://github.com/ufund-me/qbot/tree/main/pytrader/strategies) (AI strategies), [`pytrader/easyquant/push_engine/quotation_engine.py`](https://github.com/ufund-me/qbot/blob/main/pytrader/easyquant/push_engine/quotation_engine.py) (Quotation engine), [`pytrader/easyquant/event_engine.py`](https://github.com/ufund-me/qbot/blob/main/pytrader/easyquant/event_engine.py) (Event engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_research["Research and backtesting"]
  node_strategies["AI strategies"]
  node_analyzers["Strategy analysis"]
  node_backtest["Backtesting<br/>[backtest_engine.py]"]
  node_quantstats["Performance reporting"]
end

subgraph group_marketdata["Market data"]
  node_data["Market data"]
  node_quotation["Quotation providers<br/>[quotation.py]"]
end

subgraph group_runtime["Trading runtime"]
  node_context["Strategy context<br/>[context.py]"]
  node_events["Event engine<br/>[event_engine.py]"]
  node_quotation_engine["Quotation engine"]
  node_clock["Clock engine<br/>[clock_engine.py]"]
  node_main_engine["Main engine<br/>[main_engine.py]"]
  node_sim_trade["Simulated trading<br/>[trade_sim.py]"]
  node_trade_dispatch["Trade dispatcher<br/>[trade_engine.py]"]
  node_live_trade["Live trading<br/>[trade_real.py]"]
  node_exchange_adapters["Exchange adapters"]
end

subgraph group_interfaces["User interfaces"]
  node_gui["Desktop GUI"]
  node_web_ui["Web interface"]
end

subgraph group_fundtools["Fund research tools"]
  node_fund_extension["Fund browser extension"]
  node_fund_strategies["Fund strategies"]
  node_investool["Investment data service"]
end

node_investigator(("Quant researcher"))
node_markets(("Market services"))
node_broker(("Broker or exchange"))

node_investigator -.->|"gets data"| node_data
node_data -.->|"feeds research"| node_strategies
node_investigator -->|"develops"| node_strategies
node_strategies -.->|"evaluates"| node_backtest
node_strategies -.->|"analyzes"| node_analyzers
node_quotation -->|"provides bars"| node_context
node_quotation_engine -->|"fetches bars"| node_quotation
node_quotation_engine -->|"queues bars"| node_events
node_clock -->|"queues clock events"| node_events
node_main_engine -->|"initializes"| node_quotation_engine
node_main_engine -->|"initializes"| node_clock
node_main_engine -->|"registers strategies"| node_events
node_backtest -->|"fetches bars"| node_quotation_engine
node_backtest -->|"creates"| node_events
node_backtest -.->|"creates"| node_context
node_strategies -.->|"validates strategies"| node_backtest
node_investigator -.->|"validates strategy"| node_sim_trade
node_investigator -.->|"starts trading"| node_trade_dispatch
node_trade_dispatch -->|"selects simulation"| node_sim_trade
node_trade_dispatch -->|"selects live trading"| node_live_trade
node_live_trade -.->|"uses adapters"| node_exchange_adapters
node_exchange_adapters -.->|"sends orders"| node_broker
node_markets -.->|"serves quotes"| node_quotation
node_investigator -.->|"operates"| node_gui
node_investigator -.->|"uses analysis"| node_web_ui
node_investigator -.->|"researches funds"| node_fund_extension
node_investigator -.->|"compares strategies"| node_fund_strategies
node_investigator -.->|"queries investments"| node_investool
node_backtest -.->|"reports results"| node_quantstats

click node_data "https://github.com/ufund-me/qbot/tree/main/pytrader/data"
click node_quotation "https://github.com/ufund-me/qbot/blob/main/pytrader/easyquant/quotation.py"
click node_context "https://github.com/ufund-me/qbot/blob/main/pytrader/easyquant/context.py"
click node_strategies "https://github.com/ufund-me/qbot/tree/main/pytrader/strategies"
click node_analyzers "https://github.com/ufund-me/qbot/tree/main/pytrader/analyser"
click node_backtest "https://github.com/ufund-me/qbot/blob/main/pytrader/easyquant/backtest_engine.py"
click node_events "https://github.com/ufund-me/qbot/blob/main/pytrader/easyquant/event_engine.py"
click node_quotation_engine "https://github.com/ufund-me/qbot/blob/main/pytrader/easyquant/push_engine/quotation_engine.py"
click node_clock "https://github.com/ufund-me/qbot/blob/main/pytrader/easyquant/push_engine/clock_engine.py"
click node_main_engine "https://github.com/ufund-me/qbot/blob/main/pytrader/easyquant/main_engine.py"
click node_sim_trade "https://github.com/ufund-me/qbot/blob/main/qbot/engine/trade/trade_sim.py"
click node_trade_dispatch "https://github.com/ufund-me/qbot/blob/main/qbot/engine/trade/trade_engine.py"
click node_live_trade "https://github.com/ufund-me/qbot/blob/main/qbot/engine/trade/trade_real.py"
click node_exchange_adapters "https://github.com/ufund-me/qbot/tree/main/qbot/engine/trade/engine_apis"
click node_gui "https://github.com/ufund-me/qbot/tree/main/qbot/gui"
click node_web_ui "https://github.com/ufund-me/qbot/tree/main/pytrader/frontend/src"
click node_fund_extension "https://github.com/ufund-me/qbot/tree/main/pyfunds/web-extension/src"
click node_fund_strategies "https://github.com/ufund-me/qbot/tree/main/pyfunds/fund-strategies/src"
click node_investool "https://github.com/ufund-me/qbot/tree/main/qbot/plugins/investool"
click node_quantstats "https://github.com/ufund-me/qbot/tree/main/qbot/plugins/quantstats/quantstats"

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_strategies,node_analyzers,node_backtest,node_quantstats toneBlue
class node_data,node_quotation toneAmber
class node_context,node_events,node_quotation_engine,node_clock,node_main_engine,node_sim_trade,node_trade_dispatch,node_live_trade,node_exchange_adapters toneMint
class node_gui,node_web_ui toneRose
class node_fund_extension,node_fund_strategies,node_investool,node_investigator,node_markets,node_broker toneIndigo
```

## Components

### Research and backtesting

- [AI strategies](https://github.com/ufund-me/qbot/tree/main/pytrader/strategies): `pytrader/strategies`
- [Strategy analysis](https://github.com/ufund-me/qbot/tree/main/pytrader/analyser): `pytrader/analyser`
- [Backtesting](https://github.com/ufund-me/qbot/blob/main/pytrader/easyquant/backtest_engine.py): `pytrader/easyquant/backtest_engine.py`
- [Performance reporting](https://github.com/ufund-me/qbot/tree/main/qbot/plugins/quantstats/quantstats): `qbot/plugins/quantstats/quantstats`

### Market data

- [Market data](https://github.com/ufund-me/qbot/tree/main/pytrader/data): `pytrader/data`
- [Quotation providers](https://github.com/ufund-me/qbot/blob/main/pytrader/easyquant/quotation.py): `pytrader/easyquant/quotation.py`

### Trading runtime

- [Strategy context](https://github.com/ufund-me/qbot/blob/main/pytrader/easyquant/context.py): `pytrader/easyquant/context.py`
- [Event engine](https://github.com/ufund-me/qbot/blob/main/pytrader/easyquant/event_engine.py): `pytrader/easyquant/event_engine.py`
- [Quotation engine](https://github.com/ufund-me/qbot/blob/main/pytrader/easyquant/push_engine/quotation_engine.py): `pytrader/easyquant/push_engine/quotation_engine.py`
- [Clock engine](https://github.com/ufund-me/qbot/blob/main/pytrader/easyquant/push_engine/clock_engine.py): `pytrader/easyquant/push_engine/clock_engine.py`
- [Main engine](https://github.com/ufund-me/qbot/blob/main/pytrader/easyquant/main_engine.py): `pytrader/easyquant/main_engine.py`
- [Simulated trading](https://github.com/ufund-me/qbot/blob/main/qbot/engine/trade/trade_sim.py): `qbot/engine/trade/trade_sim.py`
- [Trade dispatcher](https://github.com/ufund-me/qbot/blob/main/qbot/engine/trade/trade_engine.py): `qbot/engine/trade/trade_engine.py`
- [Live trading](https://github.com/ufund-me/qbot/blob/main/qbot/engine/trade/trade_real.py): `qbot/engine/trade/trade_real.py`
- [Exchange adapters](https://github.com/ufund-me/qbot/tree/main/qbot/engine/trade/engine_apis): `qbot/engine/trade/engine_apis`

### User interfaces

- [Desktop GUI](https://github.com/ufund-me/qbot/tree/main/qbot/gui): `qbot/gui`
- [Web interface](https://github.com/ufund-me/qbot/tree/main/pytrader/frontend/src): `pytrader/frontend/src`

### Fund research tools

- [Fund browser extension](https://github.com/ufund-me/qbot/tree/main/pyfunds/web-extension/src): `pyfunds/web-extension/src`
- [Fund strategies](https://github.com/ufund-me/qbot/tree/main/pyfunds/fund-strategies/src): `pyfunds/fund-strategies/src`
- [Investment data service](https://github.com/ufund-me/qbot/tree/main/qbot/plugins/investool): `qbot/plugins/investool`

### Other components

- **Quant researcher**
- **Market services**
- **Broker or exchange**

## Connections

- Quant researcher → Market data: gets data
- Market data → AI strategies: feeds research
- Quant researcher → AI strategies: develops
- AI strategies → Backtesting: evaluates
- AI strategies → Strategy analysis: analyzes
- Quotation providers → Strategy context: provides bars (evidence: `pytrader/easyquant/context.py`)
- Quotation engine → Quotation providers: fetches bars (evidence: `pytrader/easyquant/push_engine/quotation_engine.py`)
- Quotation engine → Event engine: queues bars (evidence: `pytrader/easyquant/push_engine/quotation_engine.py`)
- Clock engine → Event engine: queues clock events (evidence: `pytrader/easyquant/push_engine/clock_engine.py`)
- Main engine → Quotation engine: initializes (evidence: `pytrader/easyquant/main_engine.py`)
- Main engine → Clock engine: initializes (evidence: `pytrader/easyquant/main_engine.py`)
- Main engine → Event engine: registers strategies (evidence: `pytrader/easyquant/main_engine.py`)
- Backtesting → Quotation engine: fetches bars (evidence: `pytrader/easyquant/backtest_engine.py`)
- Backtesting → Event engine: creates (evidence: `pytrader/easyquant/backtest_engine.py`)
- Backtesting → Strategy context: creates (evidence: `pytrader/easyquant/backtest_engine.py`)
- AI strategies → Backtesting: validates strategies
- Quant researcher → Simulated trading: validates strategy
- Quant researcher → Trade dispatcher: starts trading
- Trade dispatcher → Simulated trading: selects simulation (evidence: `qbot/engine/trade/trade_engine.py`)
- Trade dispatcher → Live trading: selects live trading (evidence: `qbot/engine/trade/trade_engine.py`)
- Live trading → Exchange adapters: uses adapters
- Exchange adapters → Broker or exchange: sends orders
- Market services → Quotation providers: serves quotes
- Quant researcher → Desktop GUI: operates
- Quant researcher → Web interface: uses analysis
- Quant researcher → Fund browser extension: researches funds
- Quant researcher → Fund strategies: compares strategies
- Quant researcher → Investment data service: queries investments
- Backtesting → Performance reporting: reports results
