# vibetradinglabs/vibetrading architecture

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

- Interactive diagram: https://gitdiagram.com/vibetradinglabs/vibetrading
- Repository: https://github.com/vibetradinglabs/vibetrading

## Overview

VibeTrading is a cryptocurrency strategy framework: users can describe or template a strategy, validate it, backtest it on historical data, analyze performance, and deploy it live. The graph preserves those stages, plus indicators, sizing, data access, comparison, CLI, and exchange integrations. Edges are limited to relationships shown in the README, excerpts, or SOURCE INDEX; live-adapter wiring is not verified in the sampled source.

Main entry points: [`vibetrading/strategy.py`](https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/strategy.py) (Strategy API), [`vibetrading/_core/backtest.py`](https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_core/backtest.py) (Simulation engine), [`vibetrading/backtest.py`](https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/backtest.py) (Backtest API), [`vibetrading/cli.py`](https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/cli.py) (Command-line interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_strategy["Strategy authoring"]
  node_strategy_api["Strategy API<br/>[strategy.py]"]
  node_generation["LLM generation<br/>[generator.py]"]
  node_validation["Static validation<br/>[validator.py]"]
  node_analysis["LLM analysis<br/>[analyzer.py]"]
  node_templates["Strategy templates"]
end

subgraph group_research["Backtesting and research"]
  node_backtest_api["Backtest API<br/>[backtest.py]"]
  node_engine["Simulation engine<br/>[backtest.py]"]
  node_sandbox["Historical sandbox<br/>[static_sandbox.py]"]
  node_metrics["Performance metrics<br/>[calculator.py]"]
  node_compare["Strategy comparison<br/>[compare.py]"]
  node_downloader["Market data download<br/>[data_downloader.py]"]
  node_loader["CSV data loading<br/>[data_loader.py]"]
end

subgraph group_runtime["Trading runtime"]
  node_live_api["Live API<br/>[live.py]"]
  node_live_runner["Live runner<br/>[live_runner.py]"]
  node_exchanges["Exchange adapters"]
  node_orders["Order models<br/>[orders.py]"]
end

subgraph group_shared["Shared capabilities"]
  node_indicators["Technical indicators<br/>[indicators.py]"]
  node_sizing["Position sizing<br/>[sizing.py]"]
  node_cli["Command-line interface<br/>[cli.py]"]
end

node_user(("Strategy user"))

node_user -->|"describes strategy"| node_strategy_api
node_strategy_api -->|"generates code"| node_generation
node_strategy_api -->|"validates code"| node_validation
node_strategy_api -->|"analyzes results"| node_analysis
node_user -->|"selects template"| node_templates
node_user -->|"runs backtest"| node_backtest_api
node_backtest_api -->|"runs engine"| node_engine
node_engine -->|"simulates trades"| node_sandbox
node_engine -->|"calculates metrics"| node_metrics
node_engine -->|"loads market data"| node_loader
node_sandbox -->|"uses order models"| node_orders
node_sandbox -->|"loads cached data"| node_loader
node_compare -->|"runs strategies"| node_backtest_api
node_user -->|"requests data"| node_downloader
node_downloader -->|"uses cache utilities"| node_loader
node_user -->|"deploys strategy"| node_live_api
node_live_api -->|"starts runner"| node_live_runner
node_live_runner -.->|"connects exchanges"| node_exchanges
node_exchanges -->|"uses order models"| node_orders
node_cli -->|"invokes workflows"| node_strategy_api
node_cli -->|"runs backtests"| node_backtest_api
node_cli -->|"downloads data"| node_downloader
node_strategy_api -->|"offers templates"| node_templates

click node_strategy_api "https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/strategy.py"
click node_generation "https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_agent/generator.py"
click node_validation "https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_agent/validator.py"
click node_analysis "https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_agent/analyzer.py"
click node_templates "https://github.com/vibetradinglabs/vibetrading/tree/main/vibetrading/templates"
click node_backtest_api "https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/backtest.py"
click node_engine "https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_core/backtest.py"
click node_sandbox "https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_core/static_sandbox.py"
click node_metrics "https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_metrics/calculator.py"
click node_compare "https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/compare.py"
click node_downloader "https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_tools/data_downloader.py"
click node_loader "https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_tools/data_loader.py"
click node_live_api "https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/live.py"
click node_live_runner "https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_core/live_runner.py"
click node_exchanges "https://github.com/vibetradinglabs/vibetrading/tree/main/vibetrading/_exchanges"
click node_orders "https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_models/orders.py"
click node_indicators "https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_utils/indicators.py"
click node_sizing "https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_utils/sizing.py"
click node_cli "https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/cli.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_strategy_api,node_generation,node_validation,node_analysis,node_templates,node_user toneBlue
class node_backtest_api,node_engine,node_sandbox,node_metrics,node_compare,node_downloader,node_loader toneAmber
class node_live_api,node_live_runner,node_exchanges,node_orders toneMint
class node_indicators,node_sizing,node_cli toneRose
```

## Components

### Strategy authoring

- [Strategy API](https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/strategy.py): `vibetrading/strategy.py`
- [LLM generation](https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_agent/generator.py): `vibetrading/_agent/generator.py`
- [Static validation](https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_agent/validator.py): `vibetrading/_agent/validator.py`
- [LLM analysis](https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_agent/analyzer.py): `vibetrading/_agent/analyzer.py`
- [Strategy templates](https://github.com/vibetradinglabs/vibetrading/tree/main/vibetrading/templates): `vibetrading/templates`

### Backtesting and research

- [Backtest API](https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/backtest.py): `vibetrading/backtest.py`
- [Simulation engine](https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_core/backtest.py): `vibetrading/_core/backtest.py`
- [Historical sandbox](https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_core/static_sandbox.py): `vibetrading/_core/static_sandbox.py`
- [Performance metrics](https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_metrics/calculator.py): `vibetrading/_metrics/calculator.py`
- [Strategy comparison](https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/compare.py): `vibetrading/compare.py`
- [Market data download](https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_tools/data_downloader.py): `vibetrading/_tools/data_downloader.py`
- [CSV data loading](https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_tools/data_loader.py): `vibetrading/_tools/data_loader.py`

### Trading runtime

- [Live API](https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/live.py): `vibetrading/live.py`
- [Live runner](https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_core/live_runner.py): `vibetrading/_core/live_runner.py`
- [Exchange adapters](https://github.com/vibetradinglabs/vibetrading/tree/main/vibetrading/_exchanges): `vibetrading/_exchanges`
- [Order models](https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_models/orders.py): `vibetrading/_models/orders.py`

### Shared capabilities

- [Technical indicators](https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_utils/indicators.py): `vibetrading/_utils/indicators.py`
- [Position sizing](https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/_utils/sizing.py): `vibetrading/_utils/sizing.py`
- [Command-line interface](https://github.com/vibetradinglabs/vibetrading/blob/main/vibetrading/cli.py): `vibetrading/cli.py`

### Other components

- **Strategy user**

## Connections

- Strategy user → Strategy API: describes strategy (evidence: `README.md`)
- Strategy API → LLM generation: generates code (evidence: `vibetrading/strategy.py`)
- Strategy API → Static validation: validates code (evidence: `vibetrading/strategy.py`)
- Strategy API → LLM analysis: analyzes results (evidence: `vibetrading/strategy.py`)
- Strategy user → Strategy templates: selects template (evidence: `README.md`)
- Strategy user → Backtest API: runs backtest (evidence: `README.md`)
- Backtest API → Simulation engine: runs engine (evidence: `vibetrading/backtest.py`)
- Simulation engine → Historical sandbox: simulates trades (evidence: `vibetrading/_core/backtest.py`)
- Simulation engine → Performance metrics: calculates metrics (evidence: `vibetrading/_core/backtest.py`)
- Simulation engine → CSV data loading: loads market data (evidence: `vibetrading/_core/backtest.py`)
- Historical sandbox → Order models: uses order models (evidence: `vibetrading/_core/static_sandbox.py`)
- Historical sandbox → CSV data loading: loads cached data (evidence: `vibetrading/_core/static_sandbox.py`)
- Strategy comparison → Backtest API: runs strategies (evidence: `vibetrading/compare.py`)
- Strategy user → Market data download: requests data (evidence: `README.md`)
- Market data download → CSV data loading: uses cache utilities (evidence: `vibetrading/_tools/data_downloader.py`)
- Strategy user → Live API: deploys strategy (evidence: `README.md`)
- Live API → Live runner: starts runner (evidence: `README.md`)
- Live runner → Exchange adapters: connects exchanges
- Exchange adapters → Order models: uses order models (evidence: `vibetrading/_exchanges/hyperliquid.py`)
- Command-line interface → Strategy API: invokes workflows (evidence: `vibetrading/cli.py`)
- Command-line interface → Backtest API: runs backtests (evidence: `vibetrading/cli.py`)
- Command-line interface → Market data download: downloads data (evidence: `vibetrading/cli.py`)
- Strategy API → Strategy templates: offers templates (evidence: `vibetrading/templates/__init__.py`)
