The problem
How it works
TradingAgents models a trading firm with LLM agents: fundamentals, sentiment, news and technical analysts work in parallel, bullish and bearish researchers debate their findings, a trader drafts a decision and a risk team plus portfolio manager approve or reject it. You run it from the CLI with a ticker and date, through Docker, or from Python via `propagate`. Data comes from sources such as SEC EDGAR, Yahoo Finance, news and social feeds.
Results and limitations
The README presents the output as a debated trading decision for research, and states that results depend on many factors.
Before you try it
The maintainers say it is a research framework and not financial, investment or trading advice; Top 200 Repos does not offer investment advice either. It needs LLM and data API keys, which may cost money. Results depend on your setup and were not independently reproduced by Top 200 Repos.
Tools and repositories
- Tools
- Python 3.11+ · Docker (optional)
- Prerequisites
- An LLM provider API key (or a local model) and data keys such as Alpha Vantage; FRED is optional.
Try it yourself: Research run for one ticker
Fill the fields to adapt the prompt. Empty fields stay as visible [placeholders].
Set up TradingAgents to analyse [Ticker symbol] as of [Analysis date] using [Model provider]. Before running, list which API keys and data sources the run will call and estimate how many model calls it may make, then wait for my approval. Run it in research mode only: do not connect a brokerage or place any orders. Save the full analyst, debate and risk reports to [Report folder], then give me a plain-language summary of the bull case, the bear case and the main risks, with the data sources each claim came from. Label the outcome as a research artefact, not advice.Treat the result as a learning and research exercise; never let the agent trade or move money.
Related videos
About TauricResearch/TradingAgents
Copy any app, Claude does SEO, and the top 10 repos (opens in a new tab)
The description links the GitHub repository.
Watch on YouTube (opens in a new tab)Independent creators. Listing a video implies no endorsement, sponsorship or partnership.
Sources
- TauricResearch/TradingAgents README (opens in a new tab)
Project documentation · github.com · Undated · Source checked 9 Nov 2026, 22:22 UTC
What this source supports
- Analyst, researcher, trader, risk and portfolio manager agent roles
- CLI with ticker and date flags, Docker and Python usage
- Supports many LLM providers and local models via Ollama
- Data from SEC EDGAR, Yahoo Finance, news and social sources
- Disclaimer: research purposes only, not financial advice
