# nicolas1bhr/tradeagent architecture

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

- Interactive diagram: https://gitdiagram.com/nicolas1bhr/tradeagent
- Repository: https://github.com/nicolas1bhr/tradeagent

## Overview

TradeAgent is a Windows desktop AI trading agent whose principal workflow runs from the user’s chat, through a managed agent workspace and the `trade` CLI, to an authenticated local gateway that enforces trading authority and risk before dispatching to a simulator, paper connector, or ATAS. The repository also supports strategy backtests, market-data acquisition, provisioning, and operational checks. The graph uses documented relationships and sampled wiring; unsampled internals are represented only where the README identifies their capability.

Main entry points: [`src/TradeAgent.Platforms/Connectors.cs`](https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Platforms/Connectors.cs) (Connector selection), [`src/TradeAgent.AgentRuntime`](https://github.com/nicolas1bhr/tradeagent/tree/main/src/TradeAgent.AgentRuntime) (Agent runtime), [`src/TradeAgent.App`](https://github.com/nicolas1bhr/tradeagent/tree/main/src/TradeAgent.App) (Desktop app), [`src/TradeAgent.Gateway/TradingGateway.cs`](https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Gateway/TradingGateway.cs) (Trading gateway)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop and agent"]
  node_desktop_app["Desktop app<br/>[TradeAgent.App]"]
  node_agent_runtime["Agent runtime"]
  node_workspace["Managed workspace<br/>[Paths.cs]"]
  node_trade_cli["Trade CLI<br/>[Program.cs]"]
end

subgraph group_execution["Trading execution"]
  node_gateway["Trading gateway<br/>[TradingGateway.cs]"]
  node_pipe_server["Authenticated pipe"]
  node_database[("SQLite state<br/>[Database.cs]")]
end

subgraph group_research["Research and data"]
  node_strategy["Strategy evaluation<br/>[Backtest.cs]"]
  node_strategy_parser["Strategy parser<br/>[StrategyParser.cs]"]
  node_market_data["Market data<br/>[ForwardBars.cs]"]
end

subgraph group_connectors["Broker connectors"]
  node_connector_factory["Connector selection<br/>[Connectors.cs]"]
  node_atas_connector["ATAS connector<br/>[AtasConnector.cs]"]
  node_atas_bridge["ATAS bridge<br/>[BridgeServer.cs]"]
  node_paper_connector["Paper connector<br/>[PaperConnector.cs]"]
  node_simulator["Simulator<br/>[FakeConnector.cs]"]
end

subgraph group_operations["Provisioning and checks"]
  node_data_provisioning["Data acquisition"]
  node_provisioning["App provisioning<br/>[Downloader.cs]"]
  node_diagnostics["System diagnostics<br/>[Doctor.cs]"]
end

node_user(("Account owner"))
node_atas["ATAS platform"]
node_market_sources["Market data sources"]

node_user -->|"uses chat"| node_desktop_app
node_desktop_app -->|"hosts conversation"| node_agent_runtime
node_agent_runtime -->|"runs within"| node_workspace
node_agent_runtime -->|"invokes tools"| node_trade_cli
node_trade_cli -->|"sends requests"| node_pipe_server
node_pipe_server -->|"routes requests"| node_gateway
node_gateway -->|"records state"| node_database
node_gateway -->|"dispatches trades"| node_connector_factory
node_connector_factory -->|"creates connector"| node_atas_connector
node_connector_factory -->|"creates connector"| node_paper_connector
node_connector_factory -->|"creates connector"| node_simulator
node_atas_connector -->|"uses bridge"| node_atas_bridge
node_atas_bridge -->|"runs inside"| node_atas
node_strategy_parser -->|"parses strategies"| node_strategy
node_strategy -.->|"evaluates bars"| node_market_data
node_data_provisioning -->|"normalizes data"| node_market_data
node_market_sources -.->|"provides data"| node_data_provisioning
node_provisioning -->|"installs runtime"| node_agent_runtime
node_desktop_app -->|"offers checks"| node_diagnostics

click node_desktop_app "https://github.com/nicolas1bhr/tradeagent/tree/main/src/TradeAgent.App"
click node_agent_runtime "https://github.com/nicolas1bhr/tradeagent/tree/main/src/TradeAgent.AgentRuntime"
click node_workspace "https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Core/Paths.cs"
click node_trade_cli "https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.TradeCli/Program.cs"
click node_gateway "https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Gateway/TradingGateway.cs"
click node_pipe_server "https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Gateway/GatewayPipeServer.cs"
click node_database "https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Core/Db/Database.cs"
click node_strategy "https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Core/Strategy/Backtest.cs"
click node_strategy_parser "https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Core/Strategy/StrategyParser.cs"
click node_market_data "https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Core/Data/ForwardBars.cs"
click node_data_provisioning "https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Provisioning/MarketDataService.cs"
click node_connector_factory "https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Platforms/Connectors.cs"
click node_atas_connector "https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Connectors.Atas/AtasConnector.cs"
click node_atas_bridge "https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.AtasBridge/BridgeServer.cs"
click node_paper_connector "https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Connectors.Paper/PaperConnector.cs"
click node_simulator "https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Connectors.Fake/FakeConnector.cs"
click node_provisioning "https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Provisioning/Downloader.cs"
click node_diagnostics "https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Diagnostics/Doctor.cs"

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_desktop_app,node_agent_runtime,node_workspace,node_trade_cli toneBlue
class node_gateway,node_pipe_server,node_database toneAmber
class node_strategy,node_strategy_parser,node_market_data toneMint
class node_connector_factory,node_atas_connector,node_atas_bridge,node_paper_connector,node_simulator toneRose
class node_data_provisioning,node_provisioning,node_diagnostics,node_user,node_atas,node_market_sources toneIndigo
```

## Components

### Desktop and agent

- [Desktop app](https://github.com/nicolas1bhr/tradeagent/tree/main/src/TradeAgent.App): `src/TradeAgent.App`
- [Agent runtime](https://github.com/nicolas1bhr/tradeagent/tree/main/src/TradeAgent.AgentRuntime): `src/TradeAgent.AgentRuntime`
- [Managed workspace](https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Core/Paths.cs): `src/TradeAgent.Core/Paths.cs`
- [Trade CLI](https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.TradeCli/Program.cs): `src/TradeAgent.TradeCli/Program.cs`

### Trading execution

- [Trading gateway](https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Gateway/TradingGateway.cs): `src/TradeAgent.Gateway/TradingGateway.cs`
- [Authenticated pipe](https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Gateway/GatewayPipeServer.cs): `src/TradeAgent.Gateway/GatewayPipeServer.cs`
- [SQLite state](https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Core/Db/Database.cs): `src/TradeAgent.Core/Db/Database.cs`

### Research and data

- [Strategy evaluation](https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Core/Strategy/Backtest.cs): `src/TradeAgent.Core/Strategy/Backtest.cs`
- [Strategy parser](https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Core/Strategy/StrategyParser.cs): `src/TradeAgent.Core/Strategy/StrategyParser.cs`
- [Market data](https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Core/Data/ForwardBars.cs): `src/TradeAgent.Core/Data/ForwardBars.cs`

### Broker connectors

- [Connector selection](https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Platforms/Connectors.cs): `src/TradeAgent.Platforms/Connectors.cs`
- [ATAS connector](https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Connectors.Atas/AtasConnector.cs): `src/TradeAgent.Connectors.Atas/AtasConnector.cs`
- [ATAS bridge](https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.AtasBridge/BridgeServer.cs): `src/TradeAgent.AtasBridge/BridgeServer.cs`
- [Paper connector](https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Connectors.Paper/PaperConnector.cs): `src/TradeAgent.Connectors.Paper/PaperConnector.cs`
- [Simulator](https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Connectors.Fake/FakeConnector.cs): `src/TradeAgent.Connectors.Fake/FakeConnector.cs`

### Provisioning and checks

- [Data acquisition](https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Provisioning/MarketDataService.cs): `src/TradeAgent.Provisioning/MarketDataService.cs`
- [App provisioning](https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Provisioning/Downloader.cs): `src/TradeAgent.Provisioning/Downloader.cs`
- [System diagnostics](https://github.com/nicolas1bhr/tradeagent/blob/main/src/TradeAgent.Diagnostics/Doctor.cs): `src/TradeAgent.Diagnostics/Doctor.cs`

### Other components

- **Account owner**
- **ATAS platform**
- **Market data sources**

## Connections

- Account owner → Desktop app: uses chat
- Desktop app → Agent runtime: hosts conversation
- Agent runtime → Managed workspace: runs within (evidence: `src/TradeAgent.AgentRuntime/GrantedWorkerTools.cs`)
- Agent runtime → Trade CLI: invokes tools
- Trade CLI → Authenticated pipe: sends requests
- Authenticated pipe → Trading gateway: routes requests (evidence: `src/TradeAgent.Gateway/GatewayPipeServer.cs`)
- Trading gateway → SQLite state: records state
- Trading gateway → Connector selection: dispatches trades (evidence: `src/TradeAgent.GatewayHost/Program.cs`)
- Connector selection → ATAS connector: creates connector (evidence: `src/TradeAgent.Platforms/Connectors.cs`)
- Connector selection → Paper connector: creates connector (evidence: `src/TradeAgent.Platforms/Connectors.cs`)
- Connector selection → Simulator: creates connector (evidence: `src/TradeAgent.Platforms/Connectors.cs`)
- ATAS connector → ATAS bridge: uses bridge (evidence: `src/TradeAgent.Connectors.Atas/AtasConnector.cs`)
- ATAS bridge → ATAS platform: runs inside
- Strategy parser → Strategy evaluation: parses strategies (evidence: `src/TradeAgent.Core/Strategy/StrategyParser.cs`)
- Strategy evaluation → Market data: evaluates bars
- Data acquisition → Market data: normalizes data (evidence: `src/TradeAgent.Provisioning/MarketDataService.cs`)
- Market data sources → Data acquisition: provides data
- App provisioning → Agent runtime: installs runtime (evidence: `src/TradeAgent.AgentRuntime/CliAgentRuntime.cs`)
- Desktop app → System diagnostics: offers checks
