TradingAgents
TradingAgents是基于大语言模型(LLM,可理解生成自然语言的AI模型)的多智能体金融交易框架,模拟专业交易机构的分工协作流程生成交易决策参考。
这个项目值得继续研究吗?
TradingAgents是基于大语言模型(LLM,可理解生成自然语言的AI模型)的多智能体金融交易框架,模拟专业交易机构的分工协作流程生成交易决策参考。
- 解决什么问题
- 解决中小交易团队、投研机构配齐各领域专业交易分析人员成本高,人工整合基本面、舆情、技术面等多维度信息效率低,交易策略回测缺乏标准化协作模拟流程的痛点。
- 适合什么团队
- 适合有金融交易投研需求的量化交易团队、资管机构投研部门、金融科技研究团队,以及想要验证多智能体交易策略的相关从业者。
- 使用前注意
- 本项目仅用于研究用途,不构成任何金融投资、交易建议,使用需配置对应大语言模型服务商的API密钥,需Python 3.11+或Docker环境部署。
本页用于缩短初步筛选时间,不构成技术、采购或法律结论。 正式使用前请在真实业务数据上验证,并以官方说明与许可证为准。
从官方资料看清能力、部署与采用边界
以下内容依据项目公开 README 或模型卡翻译整理,代码、命令和产品名保持原样。
TradingAgents 项目导读
一、项目定位
TradingAgents是一款面向研究场景的多智能体(Multi-Agent,指多个具备独立专项能力的AI程序协同完成复杂任务的架构)金融交易框架,基于大语言模型(LLM,可理解和生成自然语言的人工智能模型)技术,完全复刻真实专业交易机构的组织架构与协作流程,将复杂的交易决策任务拆解为不同专业角色的智能体协同完成,所有输出仅作研究参考,不构成任何金融投资、交易建议。
二、核心能力
专业化多智能体分工协作
框架将交易全流程拆分为4个核心团队协同执行:
- 分析师团队:包含基本面分析师(评估企业财务数据、判断内在价值)、舆情分析师(整合社交平台、资讯平台的市场情绪)、新闻分析师(跟踪宏观经济事件与行业新闻判断影响)、技术分析师(基于MACD、RSI等技术指标判断价格走势),四类分析师可并行工作,输出各自维度的分析报告。
- 研究员团队:由看多、看空两个方向的研究员组成,对分析师团队的输出做交叉验证,通过结构化辩论平衡收益与风险。
- 交易员智能体:汇总分析师、研究员的所有报告,制定具体的交易时机、仓位规模方案。
- 风控与投资组合管理团队:评估持仓风险、市场波动等因素,审核交易方案,最终由投资组合经理审批是否执行交易。
多模型灵活适配
支持OpenAI、Google、Anthropic、DeepSeek、通义千问、智谱AI等国内外主流大模型服务商,不同角色的智能体可配置不同层级的模型,平衡效果与成本。
合规回测能力
回测逻辑严格限制仅使用对应分析日期前已公开的数据,避免未来数据泄露,支持自定义回测标的、时间范围,所有决策过程可追溯。
结构化输出
最新版本支持将全流程运行结果、决策依据导出为单页HTML报告,每次运行的参数配置都会同步记录在报告中。
三、典型使用场景
- 交易策略验证:量化团队可自定义输入标的、时间区间,通过多智能体协作输出交易策略,结合历史收益数据验证策略有效性。
- 投研辅助:投研团队可将其作为信息整合工具,自动汇总基本面、舆情、技术面、宏观数据等多维度信息,输出结构化投研参考,减少人工信息整理工作量。
- 交易流程模拟:可用于交易新人培训,模拟不同市场环境下的全链路交易、风控决策流程,降低实操训练成本。
四、部署要求
框架提供两种部署方式:
- 本地Python部署:需Python 3.11及以上版本,克隆代码仓库后,通过conda或uv创建虚拟环境,安装依赖包即可运行。
- Docker部署:复制.env示例文件配置对应大模型的API密钥后,直接执行docker compose命令即可启动,运行产生的报告、日志、缓存默认存储在tradingagentsdata卷中,也可自定义存储路径。如果要使用本地部署的大模型,支持对接Ollama服务。
五、近期迭代状态
项目仍在活跃迭代中:
- 2026年10月发布v0.6.0版本,新增单页HTML报告导出能力,支持不同角色配置不同层级的模型,优化了个股历史决策回溯能力,补充雅虎搜索作为新闻源。
- 2026年9月发布v0.5.2版本,支持分析师并行计算提升分析速度,新增无交互命令行运行模式,优化回测逻辑确保仅使用分析时点前已公开的数据。
- 2026年9月发布v0.5.1版本,优化了模块组织结构,新增可选的社交帖子筛选能力,修复了SEC EDGAR财报数据读取问题。
六、许可证与采用建议
本项目采用Apache-2.0开源许可证,支持自由修改、商用,无需开源二次开发后的代码。
采用建议:
- 本项目仅用于研究用途,所有输出不构成投资建议,实际交易使用前务必做充分的回测验证与人工复核。
- 可根据自身预算、算力情况选择合适的大模型,不同角色可搭配不同性价比的模型降低使用成本。
- 如果用于机构内部场景,建议对接内部合规风控系统,所有交易决策需经过人工审核后再执行。
官方资料与来源
- agent
- finance
- llm
- multiagent
- trading
## Installation and CLI ### Installation Clone TradingAgents: ```bash git clone https://github.com/TauricResearch/TradingAgents.git cd TradingAgents ``` TradingAgents needs Python 3.11 or later. Create a virtual environment in any of your favorite environment managers: ```bash conda create -n tradingagents python=3.13 conda activate tradingagents ``` Or with [uv](https://docs.astral.sh/uv/): ```bash uv venv --python 3.13 source .venv/bin/activate ``` Install the package and its dependencies (`uv pip install .` with uv): ```bash pip install . ``` ### Docker Alternatively, run with Docker: ```bash cp .env.example .env # add your API keys docker compose run --rm tradingagents ``` After updating the repository, rebuild the image with `docker compose build`. Results, reports, the memory log and the cache live in the `tradingagents_data` volume. To keep them in a folder on the host i
该片段来自项目 README,仅用于初步判断;实际部署请以官方文档为准。





核对上游原始说明节选
TradingAgents: Multi-Agents LLM Financial Trading Framework
Deutsch | Español | français | 日本語 | 한국어 | Português | Русский | 中文
---
TradingAgents: Multi-Agents LLM Financial Trading Framework
News
- [2026-10] TradingAgents v0.7.0 released with runs on your own ChatGPT Plus or Pro plan, backtests scored from the first close after each decision, a note at start-up when a newer release is out, and a wheel attached to each GitHub release.
- [2026-10] TradingAgents v0.6.0 released with reports saved as one HTML page, a provider per model tier so the managers and analysts can run on different models, past decisions settled for every ticker while the analysts work, and company news read from Yahoo search while Yahoo's news feed is down.
- [2026-09] TradingAgents v0.5.2 released with parallel analysts for a faster analysis, a CLI that runs without prompts from flags such as --ticker and --date, the run's settings recorded in every report, and backtests that see only data published by each analysis date.
Full release notes are in CHANGELOG.md.
Earlier news
- [2026-09] TradingAgents v0.5.1 released with a package layout organised by what each module holds (import paths moved), optional Jev screening of social posts, GPT-6 Sol and Luna as the default models, and fixes to run isolation and SEC EDGAR statements.
- [2026-09] TradingAgents v0.5.0 released with point-in-time integrity across every dated path, SEC EDGAR fundamentals served as filed, backtesting over a ticker and date grid, portfolio-aware runs, and current model lineups across every provider.
- [2026-08] TradingAgents v0.4.0 released with look-ahead / point-in-time fixes across FRED macro, social sentiment, and the decision-log memory; clearer decision signals; working CLI checkpoint resume; Trader price grounding; and the GPT-5.6 and GLM-5.3 models.
- [2026-07] TradingAgents v0.3.1 released with correctness and stability fixes: Alpha Vantage look-ahead filtering, graph-router crash-safety, graph-shape-aware checkpoint resume, working crypto sentiment sources, a configurable LLM retry budget, Bedrock API-key auth, and Claude Sonnet 5 / Fable 5 support.
- [2026-06] TradingAgents v0.3.0 released with a verified data-access contract, an expanded provider registry (NVIDIA, Kimi, Groq, Mistral, Bedrock, and any OpenAI-compatible endpoint), FRED and Polymarket data vendors, a current-generation model catalog, and a CI gate.
- [2026-05] TradingAgents v0.2.5 released with the grounded Sentiment Analyst, GPT-5.5 etc. model coverage, Qwen/GLM/MiniMax dual-region support, TRADINGAGENTS env-var configurability with API-key auto-detection, remote Ollama support, non-US alpha benchmarks, and ticker path-traversal hardening.
- [2026-04] TradingAgents v0.2.4 released with structured-output agents (Research Manager, Trader, Portfolio Manager), LangGraph checkpoint resume, persistent decision log, DeepSeek/Qwen/GLM/Azure provider support, Docker, and a Windows UTF-8 encoding fix.
- [2026-03] TradingAgents v0.2.3 released with multi-language support, GPT-5.4 family models, unified model catalog, backtesting date fidelity, and proxy support.
- [2026-03] TradingAgents v0.2.2 released with GPT-5.4/Gemini 3.1/Claude 4.6 model coverage, five-tier rating scale, OpenAI Responses API, Anthropic effort control, and cross-platform stability.
- [2026-02] TradingAgents v0.2.0 released with multi-provider LLM support (GPT-5.x, Gemini 3.x, Claude 4.x, Grok 4.x) and improved system architecture.
- [2026-01] Trading-R1 Technical Report released, with Terminal expected to land soon.
🚀 TradingAgents | ⚡ Installation & CLI | 🎬 Demo | 📦 Package Usage | 🤝 Contributing | 📄 Citation
🎉 TradingAgents officially released! We have received numerous inquiries about the work, and we would like to express our thanks for the enthusiasm in our community.
So we decided to fully open-source the framework. Looking forward to building impactful projects with you!
TradingAgents Framework
TradingAgents is a multi-agent trading framework that mirrors the dynamics of real-world trading firms. By deploying specialized LLM-powered agents: from fundamental analysts, sentiment experts, and technical analysts, to trader, risk management team, the platform collaboratively evaluates market conditions and informs trading decisions. Moreover, these agents engage in dynamic discussions to pinpoint the optimal strategy.
TradingAgents framework is designed for research purposes. Trading performance may vary based on many factors, including the chosen backbone language models, model temperature, trading periods, the quality of data, and other non-deterministic factors. It is not intended as financial, investment, or trading advice.
Our framework decomposes complex trading tasks into specialized roles.
Analyst Team
- Fundamentals Analyst: Evaluates company financials and performance metrics, identifying intrinsic values and potential red flags.
- Sentiment Analyst: Aggregates news headlines, StockTwits, and Reddit chatter into a single sentiment read to gauge short-term market mood.
- News Analyst: Monitors global news and macroeconomic indicators, interpreting the impact of events on market conditions.
- Technical Analyst: Utilizes technical indicators (like MACD and RSI) to detect trading patterns and forecast price movements.
The selected analysts work at the same time, each on its own tools, and the research debate starts once all of their reports are in.
Researcher Team
- Comprises both bullish and bearish researchers who critically assess the insights provided by the Analyst Team. Through structured debates, they balance potential gains against inherent risks.
Trader Agent
- Composes reports from the analysts and researchers to make informed trading decisions, determining the timing and magnitude of trades.
Risk Management and Portfolio Manager
- Continuously evaluates portfolio risk by assessing market volatility, liquidity, and other risk factors. The risk management team evaluates and adjusts trading strategies, providing assessment reports to the Portfolio Manager for final decision.
- The Portfolio Manager approves/rejects the transaction proposal. If approved, the order will be sent to the simulated exchange and executed.
Installation and CLI
Installation
Clone TradingAgents:
git clone https://github.com/TauricResearch/TradingAgents.git
cd TradingAgentsTradingAgents needs Python 3.11 or later. Create a virtual environment in any of your favorite environment managers:
conda create -n tradingagents python=3.13
conda activate tradingagentsOr with uv:
uv venv --python 3.13
source .venv/bin/activateInstall the package and its dependencies (uv pip install . with uv):
pip install .Docker
Alternatively, run with Docker:
cp .env.example .env # add your API keys
docker compose run --rm tradingagentsAfter updating the repository, rebuild the image with docker compose build.
Results, reports, the memory log and the cache live in the tradingagentsdata volume. To keep them in a folder on the host instead, create the folder and point TRADINGAGENTSDATADIR at it, in .env or the shell: mkdir -p data && TRADINGAGENTSDATADIR=./data docker compose run --rm tradingagents.
For local models with Ollama:
docker compose --profile ollama run --rm tradingagents-ollamaRequired APIs
TradingAgents supports multiple LLM providers. Set the API key for your chosen provider:
export OPENAI_API_KEY=... # OpenAI (GPT)
export GOOGLE_API_KEY=... # Google (Gemini)
export ANTHROPIC_API_KEY=... # Anthropic (Claude)
export XAI_API_KEY=... 上游文档较长,此处为节选。完整内容见官方项目。