TradingAgents (Tauric Research): A Multi‑Agent LLM Framework for Market Analysis—What the Repo Actually Does
TradingAgents is an open-source, Python-based framework that models a trading firm as multiple cooperating LLM agents—analysts, bullish/bearish researchers, a trader, risk managers, and a portfolio manager—coordinated to produce a structured trading decision. The canonical source is the public repository and README: github.com/TauricResearch/TradingAgents (Apache-2.0). This article summarizes only what those primary materials state, plus the linked research paper.
Architecture in plain language
Per the README, specialized agents cover fundamentals, sentiment, news, and technical signals (e.g. indicators such as MACD and RSI mentioned in the docs). A researcher team stages structured bullish vs bearish critique of analyst outputs. A trader agent synthesizes those threads into a proposal; risk management and a portfolio manager gate or reject orders before execution in the framework's simulated exchange path. The design goal is modularity and debate-style reasoning rather than a single monolithic prompt.
Implementation stack and providers
The project is built with LangGraph for orchestration. The README lists broad LLM backend support, including OpenAI, Google Gemini, Anthropic, xAI (Grok), DeepSeek, Qwen (DashScope), GLM (Zhipu), OpenRouter, Ollama for local models, and enterprise paths such as Azure OpenAI (via configuration examples). Market/data integrations include references to Alpha Vantage API keys alongside LLM keys in the environment setup.
Recent release notes on the repo (as of the README "News" section) mention milestones such as v0.2.4 with structured-output agents (Research Manager, Trader, Portfolio Manager), LangGraph checkpoint resume, a persistent decision log, additional provider coverage, Docker, and CLI quality fixes—always compare your checkout to CHANGELOG.md on GitHub for the exact feature list for your version.
How you run it
- CLI: install the package (
pip install .from a clone), configure.envfrom.env.example, then runtradingagentsorpython -m cli.mainfor an interactive flow (ticker, date, provider, depth). - Python API: instantiate
TradingAgentsGraphand call.propagate(ticker, date)as shown in the README; configuration defaults live indefault_config.py. - Memory & checkpoints: the README describes an append-only decision log under
~/.tradingagents/memory/and optional LangGraph checkpoint resume for long runs—useful when learning how agent state persists across failures.
Academic reference
The authors ask users to cite their arXiv preprint: "TradingAgents: Multi-Agents LLM Financial Trading Framework" — arXiv:2412.20138 (q-fin.TR). For ecosystem context, tauric.ai describes Tauric Research's broader mission (verify live site content for current offerings).