# vongchu/tradingagents_tauricresearch architecture

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

- Interactive diagram: https://gitdiagram.com/vongchu/tradingagents_tauricresearch
- Repository: https://github.com/vongchu/tradingagents_tauricresearch

## Overview

TradingAgents is a multi-agent financial research and trading-decision framework. A user submits an instrument and analysis settings through the CLI or package API; the graph coordinates data-backed analysts, bull/bear debate, a trader proposal, risk discussion, and a portfolio decision, which the CLI can display. Data-provider and LLM-client modules support these stages, and graph checkpointing is a separate state capability. Major workflow stages are based on the README and sampled agent code; unsampled graph wiring is represented only where the documented workflow supports it.

Main entry points: [`tradingagents/graph/trading_graph.py`](https://github.com/vongchu/tradingagents_tauricresearch/blob/main/tradingagents/graph/trading_graph.py) (Trading Graph), [`cli/main.py`](https://github.com/vongchu/tradingagents_tauricresearch/blob/main/cli/main.py) (CLI), [`tradingagents/graph/analyst_execution.py`](https://github.com/vongchu/tradingagents_tauricresearch/blob/main/tradingagents/graph/analyst_execution.py) (Analyst Execution), [`tradingagents/agents/analysts`](https://github.com/vongchu/tradingagents_tauricresearch/tree/main/tradingagents/agents/analysts) (Analyst Team)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User Entry"]
  node_cli["CLI<br/>[main.py]"]
  node_package_api["Package API<br/>[trading_graph.py]"]
end

subgraph group_orchestration["Workflow Orchestration"]
  node_workflow["Trading Graph<br/>[trading_graph.py]"]
  node_graph_setup["Graph Setup<br/>[setup.py]"]
  node_analyst_execution["Analyst Execution"]
  node_checkpoint[("Checkpointing<br/>[checkpointer.py]")]
end

subgraph group_research["Research Agents"]
  node_analysts["Analyst Team"]
  node_researchers["Bull / Bear Debate"]
  node_research_manager["Research Manager"]
end

subgraph group_decision["Decision Agents"]
  node_trader["Trader<br/>[trader.py]"]
  node_risk_team["Risk Debate"]
  node_portfolio_manager["Portfolio Manager"]
  node_reporting["Report Output<br/>[reporting.py]"]
end

subgraph group_integrations["Data And Models"]
  node_agent_tools["Agent Data Tools"]
  node_dataflows["Market Dataflows"]
  node_llm_factory["LLM Factory<br/>[factory.py]"]
  node_llm_clients["Provider Clients"]
end

node_user(("User"))
node_market_services{{"Market Data Services"}}
node_llm_services{{"LLM Providers"}}

node_user -->|"configures analysis"| node_cli
node_user -->|"submits instrument"| node_package_api
node_cli -->|"runs analysis"| node_workflow
node_package_api -->|"propagates analysis"| node_workflow
node_workflow -->|"builds workflow"| node_graph_setup
node_workflow -->|"dispatches analysts"| node_analyst_execution
node_workflow -.->|"persists state"| node_checkpoint
node_analyst_execution -->|"runs analysis"| node_analysts
node_analysts -->|"requests evidence"| node_agent_tools
node_agent_tools -->|"fetches data"| node_dataflows
node_dataflows -->|"queries providers"| node_market_services
node_analyst_execution -->|"starts debate"| node_researchers
node_researchers -->|"provides debate"| node_research_manager
node_research_manager -->|"provides investment plan"| node_trader
node_trader -->|"proposes trade"| node_risk_team
node_risk_team -->|"provides risk debate"| node_portfolio_manager
node_portfolio_manager -->|"returns decision"| node_workflow
node_workflow -->|"produces report"| node_reporting
node_workflow -->|"creates models"| node_llm_factory
node_llm_factory -->|"selects provider client"| node_llm_clients
node_llm_clients -->|"invokes model"| node_llm_services
node_cli -->|"displays results"| node_reporting

click node_cli "https://github.com/vongchu/tradingagents_tauricresearch/blob/main/cli/main.py"
click node_package_api "https://github.com/vongchu/tradingagents_tauricresearch/blob/main/tradingagents/graph/trading_graph.py"
click node_workflow "https://github.com/vongchu/tradingagents_tauricresearch/blob/main/tradingagents/graph/trading_graph.py"
click node_graph_setup "https://github.com/vongchu/tradingagents_tauricresearch/blob/main/tradingagents/graph/setup.py"
click node_analyst_execution "https://github.com/vongchu/tradingagents_tauricresearch/blob/main/tradingagents/graph/analyst_execution.py"
click node_checkpoint "https://github.com/vongchu/tradingagents_tauricresearch/blob/main/tradingagents/graph/checkpointer.py"
click node_analysts "https://github.com/vongchu/tradingagents_tauricresearch/tree/main/tradingagents/agents/analysts"
click node_researchers "https://github.com/vongchu/tradingagents_tauricresearch/tree/main/tradingagents/agents/researchers"
click node_research_manager "https://github.com/vongchu/tradingagents_tauricresearch/blob/main/tradingagents/agents/managers/research_manager.py"
click node_trader "https://github.com/vongchu/tradingagents_tauricresearch/blob/main/tradingagents/agents/trader/trader.py"
click node_risk_team "https://github.com/vongchu/tradingagents_tauricresearch/tree/main/tradingagents/agents/risk_mgmt"
click node_portfolio_manager "https://github.com/vongchu/tradingagents_tauricresearch/blob/main/tradingagents/agents/managers/portfolio_manager.py"
click node_reporting "https://github.com/vongchu/tradingagents_tauricresearch/blob/main/tradingagents/reporting.py"
click node_agent_tools "https://github.com/vongchu/tradingagents_tauricresearch/tree/main/tradingagents/agents/utils"
click node_dataflows "https://github.com/vongchu/tradingagents_tauricresearch/tree/main/tradingagents/dataflows"
click node_llm_factory "https://github.com/vongchu/tradingagents_tauricresearch/blob/main/tradingagents/llm_clients/factory.py"
click node_llm_clients "https://github.com/vongchu/tradingagents_tauricresearch/tree/main/tradingagents/llm_clients"

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_cli,node_package_api,node_user toneBlue
class node_workflow,node_graph_setup,node_analyst_execution,node_checkpoint toneAmber
class node_analysts,node_researchers,node_research_manager toneMint
class node_trader,node_risk_team,node_portfolio_manager,node_reporting toneRose
class node_agent_tools,node_dataflows,node_llm_factory,node_llm_clients,node_market_services,node_llm_services toneIndigo
```

## Components

### User Entry

- [CLI](https://github.com/vongchu/tradingagents_tauricresearch/blob/main/cli/main.py): `cli/main.py`
- [Package API](https://github.com/vongchu/tradingagents_tauricresearch/blob/main/tradingagents/graph/trading_graph.py): `tradingagents/graph/trading_graph.py`

### Workflow Orchestration

- [Trading Graph](https://github.com/vongchu/tradingagents_tauricresearch/blob/main/tradingagents/graph/trading_graph.py): `tradingagents/graph/trading_graph.py`
- [Graph Setup](https://github.com/vongchu/tradingagents_tauricresearch/blob/main/tradingagents/graph/setup.py): `tradingagents/graph/setup.py`
- [Analyst Execution](https://github.com/vongchu/tradingagents_tauricresearch/blob/main/tradingagents/graph/analyst_execution.py): `tradingagents/graph/analyst_execution.py`
- [Checkpointing](https://github.com/vongchu/tradingagents_tauricresearch/blob/main/tradingagents/graph/checkpointer.py): `tradingagents/graph/checkpointer.py`

### Research Agents

- [Analyst Team](https://github.com/vongchu/tradingagents_tauricresearch/tree/main/tradingagents/agents/analysts): `tradingagents/agents/analysts`
- [Bull / Bear Debate](https://github.com/vongchu/tradingagents_tauricresearch/tree/main/tradingagents/agents/researchers): `tradingagents/agents/researchers`
- [Research Manager](https://github.com/vongchu/tradingagents_tauricresearch/blob/main/tradingagents/agents/managers/research_manager.py): `tradingagents/agents/managers/research_manager.py`

### Decision Agents

- [Trader](https://github.com/vongchu/tradingagents_tauricresearch/blob/main/tradingagents/agents/trader/trader.py): `tradingagents/agents/trader/trader.py`
- [Risk Debate](https://github.com/vongchu/tradingagents_tauricresearch/tree/main/tradingagents/agents/risk_mgmt): `tradingagents/agents/risk_mgmt`
- [Portfolio Manager](https://github.com/vongchu/tradingagents_tauricresearch/blob/main/tradingagents/agents/managers/portfolio_manager.py): `tradingagents/agents/managers/portfolio_manager.py`
- [Report Output](https://github.com/vongchu/tradingagents_tauricresearch/blob/main/tradingagents/reporting.py): `tradingagents/reporting.py`

### Data And Models

- [Agent Data Tools](https://github.com/vongchu/tradingagents_tauricresearch/tree/main/tradingagents/agents/utils): `tradingagents/agents/utils`
- [Market Dataflows](https://github.com/vongchu/tradingagents_tauricresearch/tree/main/tradingagents/dataflows): `tradingagents/dataflows`
- [LLM Factory](https://github.com/vongchu/tradingagents_tauricresearch/blob/main/tradingagents/llm_clients/factory.py): `tradingagents/llm_clients/factory.py`
- [Provider Clients](https://github.com/vongchu/tradingagents_tauricresearch/tree/main/tradingagents/llm_clients): `tradingagents/llm_clients`

### Other components

- **User**
- **Market Data Services**
- **LLM Providers**

## Connections

- User → CLI: configures analysis
- User → Package API: submits instrument
- CLI → Trading Graph: runs analysis
- Package API → Trading Graph: propagates analysis
- Trading Graph → Graph Setup: builds workflow
- Trading Graph → Analyst Execution: dispatches analysts
- Trading Graph → Checkpointing: persists state
- Analyst Execution → Analyst Team: runs analysis
- Analyst Team → Agent Data Tools: requests evidence
- Agent Data Tools → Market Dataflows: fetches data
- Market Dataflows → Market Data Services: queries providers
- Analyst Execution → Bull / Bear Debate: starts debate
- Bull / Bear Debate → Research Manager: provides debate
- Research Manager → Trader: provides investment plan
- Trader → Risk Debate: proposes trade
- Risk Debate → Portfolio Manager: provides risk debate
- Portfolio Manager → Trading Graph: returns decision
- Trading Graph → Report Output: produces report
- Trading Graph → LLM Factory: creates models
- LLM Factory → Provider Clients: selects provider client
- Provider Clients → LLM Providers: invokes model
- CLI → Report Output: displays results