How nicolas1bhr/tradeagent works
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: Connectors.cs Connector selection · TradeAgent.AgentRuntime Agent runtime · TradeAgent.App Desktop app · TradingGateway.cs Trading gateway
Components 21
Desktop and agent
- Desktop app
src/TradeAgent.App - Agent runtime
src/TradeAgent.AgentRuntime - Managed workspace
src/TradeAgent.Core/Paths.cs - Trade CLI
src/TradeAgent.TradeCli/Program.cs
Trading execution
- Trading gateway
src/TradeAgent.Gateway/TradingGateway.cs - Authenticated pipe
src/TradeAgent.Gateway/GatewayPipeServer.cs - SQLite state
src/TradeAgent.Core/Db/Database.cs
Research and data
- Strategy evaluation
src/TradeAgent.Core/Strategy/Backtest.cs - Strategy parser
src/TradeAgent.Core/Strategy/StrategyParser.cs - Market data
src/TradeAgent.Core/Data/ForwardBars.cs
Broker connectors
- Connector selection
src/TradeAgent.Platforms/Connectors.cs - ATAS connector
src/TradeAgent.Connectors.Atas/AtasConnector.cs - ATAS bridge
src/TradeAgent.AtasBridge/BridgeServer.cs - Paper connector
src/TradeAgent.Connectors.Paper/PaperConnector.cs - Simulator
src/TradeAgent.Connectors.Fake/FakeConnector.cs
Provisioning and checks
- Data acquisition
src/TradeAgent.Provisioning/MarketDataService.cs - App provisioning
src/TradeAgent.Provisioning/Downloader.cs - System diagnostics
src/TradeAgent.Diagnostics/Doctor.cs
Other components
- Account owner
- ATAS platform
- Market data sources
Connections 19
- Account owner → Desktop app: uses chat
- Desktop app → Agent runtime: hosts conversation
- Agent runtime → Managed workspace: runs within
src/TradeAgent.AgentRuntime/GrantedWorkerTools.cs - Agent runtime → Trade CLI: invokes tools
- Trade CLI → Authenticated pipe: sends requests
- Authenticated pipe → Trading gateway: routes requests
src/TradeAgent.Gateway/GatewayPipeServer.cs - Trading gateway → SQLite state: records state
- Trading gateway → Connector selection: dispatches trades
src/TradeAgent.GatewayHost/Program.cs - Connector selection → ATAS connector: creates connector
src/TradeAgent.Platforms/Connectors.cs - Connector selection → Paper connector: creates connector
src/TradeAgent.Platforms/Connectors.cs - Connector selection → Simulator: creates connector
src/TradeAgent.Platforms/Connectors.cs - ATAS connector → ATAS bridge: uses bridge
src/TradeAgent.Connectors.Atas/AtasConnector.cs - ATAS bridge → ATAS platform: runs inside
- Strategy parser → Strategy evaluation: parses strategies
src/TradeAgent.Core/Strategy/StrategyParser.cs - Strategy evaluation → Market data: evaluates bars
- Data acquisition → Market data: normalizes data
src/TradeAgent.Provisioning/MarketDataService.cs - Market data sources → Data acquisition: provides data
- App provisioning → Agent runtime: installs runtime
src/TradeAgent.AgentRuntime/CliAgentRuntime.cs - Desktop app → System diagnostics: offers checks