explaingit

tauricresearch/tradingagents

🔥 Hot76,914PythonAudience · researcherComplexity · 4/5ActiveLicenseSetup · moderate

TLDR

A Python research framework that simulates a professional trading firm using multiple AI agents that debate and analyze market data before making trading decisions.

Mindmap

mindmap
  root((repo))
    What it does
      Multi-agent debate system
      Simulates trading firm
      Backtests strategies
    Agent roles
      Fundamentals Analyst
      Sentiment Analyst
      News Analyst
      Technical Analyst
    Decision structure
      Researcher Team debate
      Risk Management review
      Portfolio Manager approval
    Tech stack
      Python framework
      LLM integrations
      Docker deployment
    Use cases
      LLM research
      Market analysis tools
      Strategy backtesting

Things people build with this

USE CASE 1

Research how LLM-based multi-agent systems perform in financial decision-making and market analysis.

USE CASE 2

Backtest trading strategies against historical market data to evaluate hypothetical past performance.

USE CASE 3

Build automated market analysis tools that combine fundamental, sentiment, news, and technical analysis.

USE CASE 4

Compare performance across different LLM providers (OpenAI, Anthropic, Google Gemini) in trading scenarios.

Tech stack

PythonOpenAIAnthropicGoogle GeminiDocker

Getting it running

Difficulty · moderate Time to first run · 30min

Requires API keys from OpenAI, Anthropic, and/or Google Gemini to run agents.

Use freely for any purpose including commercial. Keep the notice and disclose changes to the patent grant.

In plain English

TradingAgents is a research framework that simulates a professional trading firm using multiple AI agents powered by large language models (LLMs). The concept behind it is that real-world investment firms do not make decisions with a single analyst, they use specialists in different areas who discuss, debate, and challenge each other before reaching a conclusion. This framework replicates that structure computationally. The system is organized into teams. An Analyst Team consists of four specialized agents: a Fundamentals Analyst that evaluates company financial data, a Sentiment Analyst that processes social media and public opinion signals, a News Analyst that interprets macroeconomic events and global news, and a Technical Analyst that identifies price patterns using indicators like MACD (Moving Average Convergence Divergence) and RSI (Relative Strength Index, common tools in trading that measure momentum and trend). These analysts report to a Researcher Team, which includes both optimistic (bullish) and pessimistic (bearish) researchers who debate the findings to pressure-test conclusions. A Trader Agent then synthesizes all of this into a trade proposal, which a Risk Management team and Portfolio Manager either approve or reject. The framework connects to real or historical market data and supports multiple LLM providers including OpenAI, Anthropic, Google Gemini, and others, so you can swap in different AI models to investigate how they perform. It includes backtesting capabilities, meaning you can run it against historical data to evaluate hypothetical past performance. You would use TradingAgents for academic research into how LLM-based multi-agent systems perform in financial decision-making, or as a starting point for building automated market analysis tools. The README explicitly notes this is intended for research purposes, not as financial or investment advice. It is written in Python and deployable via Docker.

Copy-paste prompts

Prompt 1
How do I set up TradingAgents to run a backtest on historical stock data using OpenAI as the LLM provider?
Prompt 2
Show me how to customize the Analyst Team agents in TradingAgents to focus on specific market sectors or asset classes.
Prompt 3
How can I modify the Risk Management and Portfolio Manager approval logic in TradingAgents to match my own trading rules?
Prompt 4
What data sources does TradingAgents support for feeding market data, news, and sentiment signals to the agents?
Prompt 5
How do I compare trading performance across different LLM models (OpenAI vs Anthropic vs Gemini) using TradingAgents?
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.