tauricresearch/tradingagents
TradingAgents: Multi-Agents LLM Financial Trading Framework
How tradingagents is put together
TradingAgents is a Python multi-agent LLM financial trading framework that orchestrates specialized analyst, researcher, trader, and risk-management agents through a LangGraph state graph to produce a final trade decision for a given ticker and date. The core package (tradingagents/) separates agent definitions, a pluggable LLM client layer supporting ~20 providers, a dataflows layer with swappable market-data vendors (yfinance, Alpha Vantage, FRED, Polymarket), and graph orchestration with optional LangGraph SQLite checkpointing. A Typer/Rich CLI (cli/) drives interactive runs with live dashboards, and main.py shows the programmatic entry point. Data flows: user config (env/.env) -> TradingAgentsGraph -> analyst tool calls against external market-data APIs -> LLM debate rounds -> portfolio decision -> reports written under ~/.tradingagents.
Languages
Frameworks
Datastores
Infrastructure
Major components
tradingagents.graph
Builds and runs the LangGraph trading pipeline: node setup, conditional routing, propagation, signal processing, reflection/memory, and crash-safe checkpoint resume.
tradingagents.agents
Defines the LLM agent roles (analysts, bull/bear researchers, research manager, trader, risk debators, portfolio manager) plus their shared state schemas, prompts, memory, rating, and structured-output utilities.
tradingagents.llm_clients
Provider abstraction: base client, factory, model catalog, capability flags, validators, and concrete clients for OpenAI, Anthropic, Google, Azure, Bedrock, and OpenAI-compatible endpoints.
tradingagents.dataflows
Market-data access layer with a vendor registry/interface (yfinance, Alpha Vantage modules, FRED, Polymarket, Reddit, StockTwits), config singleton, symbol utilities, and market-data validation.
tradingagents.agents.utils tools
LangChain tool wrappers (core_stock_tools, technical_indicators_tools, fundamental/news/macro/prediction-market tools) that bind dataflows functions to agent tool calls.
cli/
Interactive Typer CLI with Rich live dashboard, provider/model selection wizards, API-key prompting, announcements fetching, stats callback handler, and report tree writing.
tradingagents.default_config + dataflows.config
Single source of truth for defaults with TRADINGAGENTS_* env-var overrides and type coercion, plus a global mutable config accessor used across the package.
tradingagents.reporting
Writes the run's report/decision artifacts to disk as a directory tree.
No digest this week
1 weeksWeek of
Dependencies and code review
Dependency advisories
Security Watch
No known advisories across 0 scanned dependencies.
No known advisories in the scanned dependencies.
Code review
No concrete code-level issues confirmed.
Get this report every week for your repos.
GitZoid learns each repo, reports what changed, and flags what needs attention. One flat price for the whole team.
$19 a month, flat · First 10 outputs free · No card required