explaingit

wjhccc/tradingagents-studio

Analysis updated 2026-05-18

29PythonAudience · researcherComplexity · 3/5LicenseSetup · moderate

TLDR

A web app where AI agents research a stock, debate bull versus bear cases, and reach a trading decision you can watch unfold live.

Mindmap

mindmap
  root((repo))
    What it does
      Multi agent stock analysis
      Live bull versus bear debate
      Visual reasoning chains
    Tech stack
      Python
      FastAPI
      Vue 3
    Use cases
      Research a stock with AI agents
      Paper trade based on agent calls
      Backtest past agent decisions
    Audience
      Researchers
      Traders learning AI agents
    Markets
      US stocks
      Chinese A shares
      Hong Kong stocks

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Watch AI agents debate and analyze a specific stock through a visual web interface

USE CASE 2

Simulate paper trades based on the agents' buy or sell decisions

USE CASE 3

Backtest what your returns would have been if you had followed the agents' past decisions

What is it built with?

PythonFastAPIVue 3Vite

How does it compare?

wjhccc/tradingagents-studioadityasharmadotai-hash/docs-reader-rag-agentalekseiul/hermes-researcher-agent
Stars292929
LanguagePythonPythonPython
Setup difficultymoderateeasymoderate
Complexity3/52/52/5
Audienceresearchervibe coderresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires at least one LLM provider API key, runs entirely on free data sources by default.

Use freely for any purpose, including commercial use, as long as you keep the copyright and license notice.

In plain English

TradingAgents-Studio is a research workbench that lets you watch a team of AI agents analyze a stock, debate the bull and bear cases, and arrive at a trading decision, all through a web interface. It is a fork of an earlier command-line framework called TradingAgents, extended with a visual layer and support for Chinese A-share markets. The README is explicit that this is a research and educational tool only, not investment advice. The core idea is transparency. Most AI trading tools hand you a final buy or sell call. This one shows you the reasoning process: a chain of cards tracing how a news event flows through supply chains and into sector sentiment, and a side-by-side chat-bubble format that separates the bullish and bearish arguments round by round. The debate view updates in real time over a live connection as the analysis runs, rather than appearing all at once at the end. The project has native support for Chinese market data. It auto-detects Chinese ticker formats and routes them through data sources including AKShare (free, the default) and optionally Tushare Pro. Four analysts specific to Chinese markets cover retail investor discussion forums, event-driven causal reasoning, capital flow data (including northbound stock connect flows and margin activity), and macroeconomic indicators like CPI, M2, and the LPR policy rate. Beyond single analyses, the tool includes several workflow features. You can track a portfolio of holdings with real-time quotes and see the latest signal for each position. A paper trading account lets you simulate trades based on agent decisions with one click, including enforcement of the Chinese T+1 settlement rule. A decision replay backtest replays previously stored agent calls over any historical window to show what the return, drawdown, and Sharpe ratio would have been, at no additional AI cost since it uses stored results. Analyses can also be scheduled to run automatically on an interval or daily basis, with automatic disabling after three consecutive failures. The backend is Python with FastAPI and the frontend uses Vue 3. It supports a wide range of AI providers including DeepSeek, Alibaba Tongyi, Zhipu, and Ollama for local models, alongside the major international providers. API keys can be managed from the settings page in the web UI and are written through to the environment file so the command-line version shares the same configuration.

Copy-paste prompts

Prompt 1
Help me install TradingAgents-Studio with the web and A-share extras and set up my .env API keys.
Prompt 2
Walk me through running an analysis on a specific stock ticker using the natural language input box.
Prompt 3
Explain how the causal chain cards and bull versus bear debate view work in TradingAgents-Studio.
Prompt 4
Show me how to set up a scheduled daily analysis and enable paper trading for a ticker.

Frequently asked questions

What is tradingagents-studio?

A web app where AI agents research a stock, debate bull versus bear cases, and reach a trading decision you can watch unfold live.

What language is tradingagents-studio written in?

Mainly Python. The stack also includes Python, FastAPI, Vue 3.

What license does tradingagents-studio use?

Use freely for any purpose, including commercial use, as long as you keep the copyright and license notice.

How hard is tradingagents-studio to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is tradingagents-studio for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.