# tauricresearch/tradingagents

> tradingagents is a multi-agent trading framework for research that uses LLM-powered agents to reach a trading decision on a stock. Its agents mirror a trading firm: analysts write reports, researchers debate them, and a trader and portfolio manager decide. It is not intended as financial, investment, or trading advice. The code is written in Python.

Source: https://github.com/tauricresearch/tradingagents
Indexed: commit 9fa1196 on 2026-11-06 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: App
- Language: Python
- Stars: 122,698 at index time
- License: Apache-2.0
- Code health: 8.5/10, Excellent
- Last commit: 2026-10-27
- Contributors: 24

## Install

From the README: https://github.com/tauricresearch/tradingagents#installation-and-cli

Clone the tradingagents repository.
    git clone https://github.com/tauricresearch/tradingagents.git

Move into the tradingagents folder.
    cd tradingagents

Install the package and its dependencies from the repository directory.
    pip install .

## How to use

Launch the interactive CLI.
    tradingagents # installed command

## How it works

Input enters as a ticker and a date, either through the interactive terminal tool in cli/main.py or by calling TradingAgentsGraph.propagate from tradingagents/graph/trading_graph.py. The tradingagents/graph package builds the LangGraph workflow that runs the analyst agents, then the research and risk debates, up to a portfolio decision. The tradingagents/agents directory writes the analyst reports a run starts from and holds the shared state and rating logic that later steps read. The tradingagents/dataflows package provides the helpers that market-data vendor calls rely on, such as settings, HTTP access and cache writes. Settings come from tradingagents/default_config.py, and the root main.py copies them before building the trading graph. A finished run is saved as a report tree, which includes complete_report.html.

- cli/main.py: entry point
- cli/run.py: entry point
- main.py: entry point
- tradingagents/__init__.py: entry point
- .github/ISSUE_TEMPLATE/bug-report.yml: central file
Modules: tests, tradingagents, cli, root. 195 files, 21,847 lines, 2,118 symbols.

## Code health

- Score: 8.5/10 (Excellent)
- Rank: #38 of 4,000+ indexed repos
- Hotspots: cli/main.py, tradingagents/graph/trading_graph.py, tradingagents/dataflows/vendors/yahoo/market.py, cli/prompts.py, tradingagents/dataflows/vendors/reddit.py
- Lowest file: cli/run.py
- Dead code: none found

## Maintenance

- Last commit 2026-10-27, first commit 2024-12-28, 477 commits
- 24 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/tauricresearch/tradingagents/security

## More

- Page: https://repowise.dev/repo/tauricresearch/tradingagents
- Ask this codebase: https://repowise.dev/repo/tauricresearch/tradingagents/chat
- Docs: https://repowise.dev/repo/tauricresearch/tradingagents/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/tauricresearch/tradingagents
