# ankit-144/mft architecture

> Architecture diagram of the GitHub repository ankit-144/mft, 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/ankit-144/mft
- Repository: https://github.com/ankit-144/mft

## Overview

MFT is a market-data and trading platform. Its main live workflow ingests broker ticks into closed candles, which inference reads to build features and produce signals; inference can submit orders to the execution service, which applies risk controls and manages broker order state. Separate branches provide historical backfill and strategy research/backtesting. The graph preserves documented capabilities where implementation excerpts are absent; those links are omitted or marked unverified rather than inferred from filenames alone.

Main entry points: [`services/execution/engine.go`](https://github.com/ankit-144/mft/blob/master/services/execution/engine.go) (Order lifecycle), [`services/inference/app/research/engine.py`](https://github.com/ankit-144/mft/blob/master/services/inference/app/research/engine.py) (Research simulation), [`services/ingestion/pipeline.go`](https://github.com/ankit-144/mft/blob/master/services/ingestion/pipeline.go) (Tick ingestion), [`services/inference/app/candles.py`](https://github.com/ankit-144/mft/blob/master/services/inference/app/candles.py) (Candle reader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_marketdata["Market data"]
  node_ingestion["Tick ingestion<br/>[pipeline.go]"]
  node_candle_rollup["Candle rollup<br/>[candles.go]"]
  node_jobs["Historical backfill<br/>[worker.go]"]
  node_job_store[("Backfill store<br/>[store.go]")]
end

subgraph group_inference["Inference"]
  node_candle_reader["Candle reader<br/>[candles.py]"]
  node_features["Feature builder<br/>[features.py]"]
  node_predictor["Model predictor<br/>[predictor.py]"]
  node_model_registry["Model registry<br/>[base.py]"]
  node_model_algorithms["Algorithm baselines<br/>[algorithms.py]"]
  node_heuristic["Heuristic model<br/>[heuristic_model.py]"]
  node_tabfm["TabFM model<br/>[tabfm_model.py]"]
  node_scheduler["Minute scheduler<br/>[loop.py]"]
  node_inference_http["Inference API<br/>[main.py]"]
  node_signal_execution["Signal execution<br/>[execution.py]"]
end

subgraph group_execution["Execution"]
  node_execution_engine["Order lifecycle<br/>[engine.go]"]
  node_risk["Risk controls<br/>[risk.go]"]
  node_journal[("Order journal<br/>[journal.go]")]
  node_execution_http["Execution API<br/>[http.go]"]
end

subgraph group_research["Research and backtesting"]
  node_research_engine["Research simulation<br/>[engine.py]"]
  node_research_adapters["Research adapters<br/>[adapters.py]"]
  node_research_splits["Chronological splits<br/>[splits.py]"]
  node_research_evaluators["Candidate evaluators<br/>[evaluators.py]"]
  node_backtest["Backtest runner<br/>[backtest.py]"]
end

subgraph group_shared["Shared platform"]
  node_live_store[("Parquet storage<br/>[storage.go]")]
  node_config["Runtime configuration<br/>[config.go]"]
  node_contracts["Domain contracts<br/>[contracts.go]"]
  node_cache[("KV cache<br/>[fluxkv.go]")]
end

node_broker["Kite broker<br/>[kite.go]"]
node_trader(("Inference client"))
node_broker_service["Broker service"]

node_broker -.->|"streams ticks"| node_ingestion
node_ingestion -->|"writes ticks"| node_live_store
node_ingestion -.->|"rolls ticks"| node_candle_rollup
node_candle_rollup -.->|"writes candles"| node_live_store
node_jobs -->|"fetches history"| node_broker
node_jobs -.->|"writes segments"| node_job_store
node_live_store -.->|"reads candles"| node_candle_reader
node_job_store -.->|"historical data"| node_candle_reader
node_inference_http -->|"reads context"| node_candle_reader
node_inference_http -->|"builds features"| node_features
node_inference_http -->|"scores context"| node_predictor
node_predictor -->|"selects model"| node_model_registry
node_model_registry -->|"registers model"| node_heuristic
node_model_registry -->|"registers model"| node_tabfm
node_model_registry -->|"registers algorithms"| node_model_algorithms
node_scheduler -->|"reads candles"| node_candle_reader
node_scheduler -.->|"builds features"| node_features
node_scheduler -->|"requests scores"| node_predictor
node_scheduler -.->|"dispatches signals"| node_signal_execution
node_signal_execution -.->|"submits orders"| node_execution_http
node_trader -->|"requests prediction"| node_inference_http
node_execution_http -.->|"routes orders"| node_execution_engine
node_execution_engine -->|"checks risk"| node_risk
node_execution_engine -.->|"persists state"| node_journal
node_execution_engine -->|"reconciles orders"| node_broker_service
node_research_engine -->|"loads data"| node_research_adapters
node_research_engine -->|"splits chronology"| node_research_splits
node_research_engine -->|"evaluates candidates"| node_research_evaluators
node_research_engine -->|"builds features"| node_features
node_research_engine -->|"compares algorithms"| node_model_algorithms
node_backtest -.->|"loads candles"| node_candle_reader
node_backtest -.->|"scores model"| node_predictor
node_config -.->|"configures pipeline"| node_ingestion
node_config -.->|"configures engine"| node_execution_engine
node_contracts -->|"defines inputs"| node_features
node_contracts -->|"maps records"| node_live_store
node_cache -.->|"caches state"| node_ingestion
node_cache -.->|"tracks claims"| node_execution_engine

click node_broker "https://github.com/ankit-144/mft/blob/master/core/broker/kite.go"
click node_ingestion "https://github.com/ankit-144/mft/blob/master/services/ingestion/pipeline.go"
click node_candle_rollup "https://github.com/ankit-144/mft/blob/master/services/ingestion/candles.go"
click node_live_store "https://github.com/ankit-144/mft/blob/master/core/storage/storage.go"
click node_jobs "https://github.com/ankit-144/mft/blob/master/services/jobs/worker.go"
click node_job_store "https://github.com/ankit-144/mft/blob/master/services/jobs/store.go"
click node_candle_reader "https://github.com/ankit-144/mft/blob/master/services/inference/app/candles.py"
click node_features "https://github.com/ankit-144/mft/blob/master/services/inference/app/features.py"
click node_predictor "https://github.com/ankit-144/mft/blob/master/services/inference/app/predictor.py"
click node_model_registry "https://github.com/ankit-144/mft/blob/master/services/inference/model/base.py"
click node_model_algorithms "https://github.com/ankit-144/mft/blob/master/services/inference/model/algorithms.py"
click node_heuristic "https://github.com/ankit-144/mft/blob/master/services/inference/model/heuristic_model.py"
click node_tabfm "https://github.com/ankit-144/mft/blob/master/services/inference/model/tabfm_model.py"
click node_scheduler "https://github.com/ankit-144/mft/blob/master/services/inference/app/loop.py"
click node_inference_http "https://github.com/ankit-144/mft/blob/master/services/inference/app/main.py"
click node_signal_execution "https://github.com/ankit-144/mft/blob/master/services/inference/app/execution.py"
click node_execution_engine "https://github.com/ankit-144/mft/blob/master/services/execution/engine.go"
click node_risk "https://github.com/ankit-144/mft/blob/master/services/execution/risk/risk.go"
click node_journal "https://github.com/ankit-144/mft/blob/master/services/execution/journal.go"
click node_execution_http "https://github.com/ankit-144/mft/blob/master/services/execution/http.go"
click node_research_engine "https://github.com/ankit-144/mft/blob/master/services/inference/app/research/engine.py"
click node_research_adapters "https://github.com/ankit-144/mft/blob/master/services/inference/app/research/adapters.py"
click node_research_splits "https://github.com/ankit-144/mft/blob/master/services/inference/app/research/splits.py"
click node_research_evaluators "https://github.com/ankit-144/mft/blob/master/services/inference/app/research/evaluators.py"
click node_backtest "https://github.com/ankit-144/mft/blob/master/services/inference/app/backtest.py"
click node_config "https://github.com/ankit-144/mft/blob/master/core/config/config.go"
click node_contracts "https://github.com/ankit-144/mft/blob/master/core/contracts/contracts.go"
click node_cache "https://github.com/ankit-144/mft/blob/master/core/fluxkv/fluxkv.go"

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_ingestion,node_candle_rollup,node_jobs,node_job_store,node_trader toneBlue
class node_candle_reader,node_features,node_predictor,node_model_registry,node_model_algorithms,node_heuristic,node_tabfm,node_scheduler,node_inference_http,node_signal_execution toneAmber
class node_execution_engine,node_risk,node_journal,node_execution_http toneMint
class node_research_engine,node_research_adapters,node_research_splits,node_research_evaluators,node_backtest toneRose
class node_live_store,node_config,node_contracts,node_cache,node_broker_service toneIndigo
class node_broker toneTeal
```

## Components

### Market data

- [Tick ingestion](https://github.com/ankit-144/mft/blob/master/services/ingestion/pipeline.go): `services/ingestion/pipeline.go`
- [Candle rollup](https://github.com/ankit-144/mft/blob/master/services/ingestion/candles.go): `services/ingestion/candles.go`
- [Historical backfill](https://github.com/ankit-144/mft/blob/master/services/jobs/worker.go): `services/jobs/worker.go`
- [Backfill store](https://github.com/ankit-144/mft/blob/master/services/jobs/store.go): `services/jobs/store.go`

### Inference

- [Candle reader](https://github.com/ankit-144/mft/blob/master/services/inference/app/candles.py): `services/inference/app/candles.py`
- [Feature builder](https://github.com/ankit-144/mft/blob/master/services/inference/app/features.py): `services/inference/app/features.py`
- [Model predictor](https://github.com/ankit-144/mft/blob/master/services/inference/app/predictor.py): `services/inference/app/predictor.py`
- [Model registry](https://github.com/ankit-144/mft/blob/master/services/inference/model/base.py): `services/inference/model/base.py`
- [Algorithm baselines](https://github.com/ankit-144/mft/blob/master/services/inference/model/algorithms.py): `services/inference/model/algorithms.py`
- [Heuristic model](https://github.com/ankit-144/mft/blob/master/services/inference/model/heuristic_model.py): `services/inference/model/heuristic_model.py`
- [TabFM model](https://github.com/ankit-144/mft/blob/master/services/inference/model/tabfm_model.py): `services/inference/model/tabfm_model.py`
- [Minute scheduler](https://github.com/ankit-144/mft/blob/master/services/inference/app/loop.py): `services/inference/app/loop.py`
- [Inference API](https://github.com/ankit-144/mft/blob/master/services/inference/app/main.py): `services/inference/app/main.py`
- [Signal execution](https://github.com/ankit-144/mft/blob/master/services/inference/app/execution.py): `services/inference/app/execution.py`

### Execution

- [Order lifecycle](https://github.com/ankit-144/mft/blob/master/services/execution/engine.go): `services/execution/engine.go`
- [Risk controls](https://github.com/ankit-144/mft/blob/master/services/execution/risk/risk.go): `services/execution/risk/risk.go`
- [Order journal](https://github.com/ankit-144/mft/blob/master/services/execution/journal.go): `services/execution/journal.go`
- [Execution API](https://github.com/ankit-144/mft/blob/master/services/execution/http.go): `services/execution/http.go`

### Research and backtesting

- [Research simulation](https://github.com/ankit-144/mft/blob/master/services/inference/app/research/engine.py): `services/inference/app/research/engine.py`
- [Research adapters](https://github.com/ankit-144/mft/blob/master/services/inference/app/research/adapters.py): `services/inference/app/research/adapters.py`
- [Chronological splits](https://github.com/ankit-144/mft/blob/master/services/inference/app/research/splits.py): `services/inference/app/research/splits.py`
- [Candidate evaluators](https://github.com/ankit-144/mft/blob/master/services/inference/app/research/evaluators.py): `services/inference/app/research/evaluators.py`
- [Backtest runner](https://github.com/ankit-144/mft/blob/master/services/inference/app/backtest.py): `services/inference/app/backtest.py`

### Shared platform

- [Parquet storage](https://github.com/ankit-144/mft/blob/master/core/storage/storage.go): `core/storage/storage.go`
- [Runtime configuration](https://github.com/ankit-144/mft/blob/master/core/config/config.go): `core/config/config.go`
- [Domain contracts](https://github.com/ankit-144/mft/blob/master/core/contracts/contracts.go): `core/contracts/contracts.go`
- [KV cache](https://github.com/ankit-144/mft/blob/master/core/fluxkv/fluxkv.go): `core/fluxkv/fluxkv.go`

### Other components

- [Kite broker](https://github.com/ankit-144/mft/blob/master/core/broker/kite.go): `core/broker/kite.go`
- **Inference client**
- **Broker service**

## Connections

- Kite broker → Tick ingestion: streams ticks
- Tick ingestion → Parquet storage: writes ticks (evidence: `services/ingestion/pipeline.go`)
- Tick ingestion → Candle rollup: rolls ticks
- Candle rollup → Parquet storage: writes candles
- Historical backfill → Kite broker: fetches history
- Historical backfill → Backfill store: writes segments
- Parquet storage → Candle reader: reads candles
- Backfill store → Candle reader: historical data
- Inference API → Candle reader: reads context (evidence: `services/inference/app/main.py`)
- Inference API → Feature builder: builds features (evidence: `services/inference/app/main.py`)
- Inference API → Model predictor: scores context (evidence: `services/inference/app/main.py`)
- Model predictor → Model registry: selects model (evidence: `services/inference/app/predictor.py`)
- Model registry → Heuristic model: registers model (evidence: `services/inference/model/base.py`)
- Model registry → TabFM model: registers model (evidence: `services/inference/model/base.py`)
- Model registry → Algorithm baselines: registers algorithms (evidence: `services/inference/model/__init__.py`)
- Minute scheduler → Candle reader: reads candles (evidence: `services/inference/app/runtime.py`)
- Minute scheduler → Feature builder: builds features
- Minute scheduler → Model predictor: requests scores (evidence: `services/inference/app/runtime.py`)
- Minute scheduler → Signal execution: dispatches signals
- Signal execution → Execution API: submits orders
- Inference client → Inference API: requests prediction (evidence: `services/inference/app/main.py`)
- Execution API → Order lifecycle: routes orders
- Order lifecycle → Risk controls: checks risk (evidence: `services/execution/engine.go`)
- Order lifecycle → Order journal: persists state
- Order lifecycle → Broker service: reconciles orders (evidence: `services/execution/engine.go`)
- Research simulation → Research adapters: loads data (evidence: `services/inference/app/research/engine.py`)
- Research simulation → Chronological splits: splits chronology (evidence: `services/inference/app/research/engine.py`)
- Research simulation → Candidate evaluators: evaluates candidates (evidence: `services/inference/app/research/engine.py`)
- Research simulation → Feature builder: builds features (evidence: `services/inference/app/research/engine.py`)
- Research simulation → Algorithm baselines: compares algorithms (evidence: `services/inference/app/research/engine.py`)
- Backtest runner → Candle reader: loads candles
- Backtest runner → Model predictor: scores model
- Runtime configuration → Tick ingestion: configures pipeline
- Runtime configuration → Order lifecycle: configures engine
- Domain contracts → Feature builder: defines inputs
- Domain contracts → Parquet storage: maps records (evidence: `core/storage/storage.go`)
- KV cache → Tick ingestion: caches state
- KV cache → Order lifecycle: tracks claims
