Remove Tauric Research branding and improve README SEO/UX
- Delete TauricResearch.png and wechat.png assets - Fix clone URL to point to hemangjoshi37a/TradingAgents - Fix broken anchor links in README navigation - Fix license badge (Apache 2.0, not MIT) - Add Analysis Pipeline and Investment Debates screenshots - Improve image alt texts for SEO - Replace Unicode box-drawing chars with ASCII in architecture diagram - Update package.json with keywords, author, correct URLs - Update pyproject.toml description - Update setup.py URL - Refresh screenshots after dark mode theme fix - Update .gitignore for Playwright and test artifacts
|
|
@ -18,3 +18,10 @@ node_modules/
|
||||||
|
|
||||||
# Runtime config
|
# Runtime config
|
||||||
schedule_config.json
|
schedule_config.json
|
||||||
|
|
||||||
|
# Playwright MCP artifacts
|
||||||
|
.playwright-mcp/
|
||||||
|
|
||||||
|
# Test screenshots (root level)
|
||||||
|
test-*.png
|
||||||
|
prediction-accuracy-new.png
|
||||||
|
|
|
||||||
92
README.md
|
|
@ -8,7 +8,7 @@
|
||||||
|
|
||||||
[](https://arxiv.org/abs/2412.20138)
|
[](https://arxiv.org/abs/2412.20138)
|
||||||
[](https://www.python.org/)
|
[](https://www.python.org/)
|
||||||
[](LICENSE)
|
[](LICENSE)
|
||||||
[](https://react.dev/)
|
[](https://react.dev/)
|
||||||
[](https://fastapi.tiangolo.com/)
|
[](https://fastapi.tiangolo.com/)
|
||||||
[](https://tailwindcss.com/)
|
[](https://tailwindcss.com/)
|
||||||
|
|
@ -19,7 +19,7 @@ An open-source framework that deploys **specialized AI agents** — analysts
|
||||||
|
|
||||||
<br />
|
<br />
|
||||||
|
|
||||||
[Getting Started](#-getting-started) • [Web Dashboard](#-nifty50-ai-web-dashboard) • [Python API](#-python-api) • [Architecture](#-architecture) • [Contributing](#-contributing)
|
[Getting Started](#getting-started) • [Web Dashboard](#nifty50-ai-web-dashboard) • [Python API](#python-api) • [Architecture](#architecture) • [Contributing](#contributing)
|
||||||
|
|
||||||
<br />
|
<br />
|
||||||
|
|
||||||
|
|
@ -56,7 +56,7 @@ An open-source framework that deploys **specialized AI agents** — analysts
|
||||||
<summary><b>Dashboard — AI Recommendations at a Glance</b></summary>
|
<summary><b>Dashboard — AI Recommendations at a Glance</b></summary>
|
||||||
<br />
|
<br />
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="frontend/docs/screenshots/01-dashboard.png" width="100%" alt="TradingAgents Dashboard showing all 50 Nifty stocks with AI recommendations, rank badges, and decision filters" />
|
<img src="frontend/docs/screenshots/01-dashboard.png" width="100%" alt="TradingAgents Dashboard showing all 50 Nifty stocks with AI-powered BUY, SELL, HOLD recommendations, rank badges, confidence levels, and decision filters" />
|
||||||
</p>
|
</p>
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
|
|
@ -64,7 +64,7 @@ An open-source framework that deploys **specialized AI agents** — analysts
|
||||||
<summary><b>History — Backtesting & Portfolio Simulation</b></summary>
|
<summary><b>History — Backtesting & Portfolio Simulation</b></summary>
|
||||||
<br />
|
<br />
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="frontend/docs/screenshots/10-history-page.png" width="100%" alt="Historical analysis page with prediction accuracy, risk metrics, portfolio simulator, and AI vs Nifty50 comparison" />
|
<img src="frontend/docs/screenshots/10-history-page.png" width="100%" alt="Historical backtesting page with prediction accuracy tracking, Sharpe ratio, max drawdown, win rate, portfolio simulator with Zerodha brokerage, and AI vs Nifty50 index comparison chart" />
|
||||||
</p>
|
</p>
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
|
|
@ -72,7 +72,23 @@ An open-source framework that deploys **specialized AI agents** — analysts
|
||||||
<summary><b>Stock Detail — Deep Analysis View</b></summary>
|
<summary><b>Stock Detail — Deep Analysis View</b></summary>
|
||||||
<br />
|
<br />
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="frontend/docs/screenshots/03-stock-detail-overview.png" width="100%" alt="Stock detail page showing SBIN analysis with rank badge, recommendation history, and prediction accuracy" />
|
<img src="frontend/docs/screenshots/03-stock-detail-overview.png" width="100%" alt="Individual stock analysis page showing AI recommendation with confidence level, risk assessment, recommendation history timeline, and detailed analysis summary" />
|
||||||
|
</p>
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>Analysis Pipeline — 12-Step AI Decision Process</b></summary>
|
||||||
|
<br />
|
||||||
|
<p align="center">
|
||||||
|
<img src="frontend/docs/screenshots/04-analysis-pipeline.png" width="100%" alt="12-step analysis pipeline visualization showing data collection, technical analysis, fundamental analysis, sentiment analysis, bull vs bear debate, and final trading decision" />
|
||||||
|
</p>
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>Investment Debates — Bull vs Bear AI Agents</b></summary>
|
||||||
|
<br />
|
||||||
|
<p align="center">
|
||||||
|
<img src="frontend/docs/screenshots/05-debates-tab.png" width="100%" alt="AI-powered investment debate between bull and bear researcher agents with research manager synthesis and final judgment" />
|
||||||
</p>
|
</p>
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
|
|
@ -80,7 +96,7 @@ An open-source framework that deploys **specialized AI agents** — analysts
|
||||||
<summary><b>Historical Date View — Ranked Stock Lists</b></summary>
|
<summary><b>Historical Date View — Ranked Stock Lists</b></summary>
|
||||||
<br />
|
<br />
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="frontend/docs/screenshots/11-history-stocks-expanded.png" width="100%" alt="History page with date cards showing buy/sell/hold breakdown and expanded ranked stock list" />
|
<img src="frontend/docs/screenshots/11-history-stocks-expanded.png" width="100%" alt="History page with date cards showing buy/sell/hold breakdown, return percentages, and expanded ranked stock list with hold periods" />
|
||||||
</p>
|
</p>
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
|
|
@ -88,7 +104,7 @@ An open-source framework that deploys **specialized AI agents** — analysts
|
||||||
<summary><b>How It Works — Multi-Agent AI System</b></summary>
|
<summary><b>How It Works — Multi-Agent AI System</b></summary>
|
||||||
<br />
|
<br />
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="frontend/docs/screenshots/09-how-it-works.png" width="100%" alt="Educational page explaining the multi-agent AI system with agent cards and debate process" />
|
<img src="frontend/docs/screenshots/09-how-it-works.png" width="100%" alt="Educational page explaining the multi-agent AI system architecture with agent role cards and structured debate process flow" />
|
||||||
</p>
|
</p>
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
|
|
@ -96,7 +112,7 @@ An open-source framework that deploys **specialized AI agents** — analysts
|
||||||
<summary><b>Settings — Configurable AI Models</b></summary>
|
<summary><b>Settings — Configurable AI Models</b></summary>
|
||||||
<br />
|
<br />
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="frontend/docs/screenshots/02-settings-modal.png" width="60%" alt="Settings panel for configuring LLM provider, model selection, and analysis parameters" />
|
<img src="frontend/docs/screenshots/02-settings-modal.png" width="60%" alt="Settings panel for configuring LLM provider selection between Claude and OpenAI, model tier selection, API key management, and debate round configuration" />
|
||||||
</p>
|
</p>
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
|
|
@ -104,7 +120,7 @@ An open-source framework that deploys **specialized AI agents** — analysts
|
||||||
<summary><b>Dark Mode</b></summary>
|
<summary><b>Dark Mode</b></summary>
|
||||||
<br />
|
<br />
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="frontend/docs/screenshots/08-dashboard-dark-mode.png" width="100%" alt="Dashboard in dark mode with glassmorphic cards and premium styling" />
|
<img src="frontend/docs/screenshots/08-dashboard-dark-mode.png" width="100%" alt="Dashboard in dark mode with glassmorphic card design, premium styling, and automatic system theme detection" />
|
||||||
</p>
|
</p>
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
|
|
@ -115,32 +131,32 @@ An open-source framework that deploys **specialized AI agents** — analysts
|
||||||
TradingAgents mirrors the structure of real-world trading firms by decomposing complex trading tasks into specialized roles:
|
TradingAgents mirrors the structure of real-world trading firms by decomposing complex trading tasks into specialized roles:
|
||||||
|
|
||||||
```
|
```
|
||||||
┌─────────────────────────────────────┐
|
+-------------------------------------+
|
||||||
│ Data Collection │
|
| Data Collection |
|
||||||
│ (Market, News, Social, Financials) │
|
| (Market, News, Social, Financials) |
|
||||||
└──────────────┬──────────────────────┘
|
+-----------------+-------------------+
|
||||||
│
|
|
|
||||||
┌──────────────▼──────────────────────┐
|
+-----------------v-------------------+
|
||||||
│ Analyst Team │
|
| Analyst Team |
|
||||||
│ Technical ┃ Fundamental ┃ Sentiment │
|
| Technical | Fundamental | Sentiment |
|
||||||
│ ┃ News ┃ │
|
| | News | |
|
||||||
└──────────────┬──────────────────────┘
|
+-----------------+-------------------+
|
||||||
│
|
|
|
||||||
┌──────────────▼──────────────────────┐
|
+-----------------v-------------------+
|
||||||
│ Researcher Team │
|
| Researcher Team |
|
||||||
│ Bull Researcher ⚔ Bear Researcher │
|
| Bull Researcher vs Bear Researcher |
|
||||||
│ (Structured AI Debate) │
|
| (Structured AI Debate) |
|
||||||
└──────────────┬──────────────────────┘
|
+-----------------+-------------------+
|
||||||
│
|
|
|
||||||
┌──────────────▼──────────────────────┐
|
+-----------------v-------------------+
|
||||||
│ Trader Agent │
|
| Trader Agent |
|
||||||
│ Synthesizes reports → Decision │
|
| Synthesizes reports -> Decision |
|
||||||
└──────────────┬──────────────────────┘
|
+-----------------+-------------------+
|
||||||
│
|
|
|
||||||
┌──────────────▼──────────────────────┐
|
+-----------------v-------------------+
|
||||||
│ Risk Management & Portfolio Mgr │
|
| Risk Management & Portfolio Mgr |
|
||||||
│ Evaluates risk → Approves/Rejects │
|
| Evaluates risk -> Approves/Rejects |
|
||||||
└─────────────────────────────────────┘
|
+-------------------------------------+
|
||||||
```
|
```
|
||||||
|
|
||||||
<details>
|
<details>
|
||||||
|
|
@ -173,7 +189,7 @@ TradingAgents mirrors the structure of real-world trading firms by decomposing c
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Clone the repository
|
# Clone the repository
|
||||||
git clone https://github.com/hjlabs/TradingAgents.git
|
git clone https://github.com/hemangjoshi37a/TradingAgents.git
|
||||||
cd TradingAgents
|
cd TradingAgents
|
||||||
|
|
||||||
# Create virtual environment
|
# Create virtual environment
|
||||||
|
|
@ -207,7 +223,7 @@ python -m cli.main
|
||||||
Select your tickers, date, LLMs, and research depth from the interactive interface.
|
Select your tickers, date, LLMs, and research depth from the interactive interface.
|
||||||
|
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="assets/cli/cli_init.png" width="100%" alt="TradingAgents CLI interface" />
|
<img src="assets/cli/cli_init.png" width="100%" alt="TradingAgents CLI interface showing ticker selection, date picker, and LLM configuration" />
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
@ -247,7 +263,7 @@ npm run dev # http://localhost:5173
|
||||||
|
|
||||||
| Layer | Technology |
|
| Layer | Technology |
|
||||||
|-------|-----------|
|
|-------|-----------|
|
||||||
| Frontend | React 18 + TypeScript, Vite, Tailwind CSS |
|
| Frontend | React 18 + TypeScript, Vite, Tailwind CSS 4 |
|
||||||
| Charts | Recharts |
|
| Charts | Recharts |
|
||||||
| Icons | Lucide React |
|
| Icons | Lucide React |
|
||||||
| Backend | FastAPI (Python) |
|
| Backend | FastAPI (Python) |
|
||||||
|
|
|
||||||
|
Before Width: | Height: | Size: 62 KiB |
|
Before Width: | Height: | Size: 216 KiB |
|
Before Width: | Height: | Size: 256 KiB |
|
Before Width: | Height: | Size: 72 KiB After Width: | Height: | Size: 72 KiB |
|
Before Width: | Height: | Size: 208 KiB After Width: | Height: | Size: 208 KiB |
|
Before Width: | Height: | Size: 64 KiB After Width: | Height: | Size: 65 KiB |
|
Before Width: | Height: | Size: 381 KiB After Width: | Height: | Size: 381 KiB |
|
Before Width: | Height: | Size: 284 KiB After Width: | Height: | Size: 288 KiB |
|
Before Width: | Height: | Size: 77 KiB After Width: | Height: | Size: 81 KiB |
25
package.json
|
|
@ -1,22 +1,33 @@
|
||||||
{
|
{
|
||||||
"name": "tradingagents",
|
"name": "tradingagents",
|
||||||
"version": "1.0.0",
|
"version": "1.0.0",
|
||||||
"description": "Multi-Agent LLM Financial Trading Framework",
|
"description": "Multi-Agent LLM Financial Trading Framework with AI-powered stock analysis, structured debates, and backtesting",
|
||||||
"main": "index.js",
|
"main": "index.js",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"test": "echo \"Error: no test specified\" && exit 1"
|
"test": "echo \"Error: no test specified\" && exit 1"
|
||||||
},
|
},
|
||||||
"repository": {
|
"repository": {
|
||||||
"type": "git",
|
"type": "git",
|
||||||
"url": "git+https://github.com/hjlabs/TradingAgents.git"
|
"url": "git+https://github.com/hemangjoshi37a/TradingAgents.git"
|
||||||
},
|
},
|
||||||
"keywords": [],
|
"keywords": [
|
||||||
"author": "",
|
"trading",
|
||||||
"license": "ISC",
|
"ai",
|
||||||
|
"multi-agent",
|
||||||
|
"llm",
|
||||||
|
"stock-analysis",
|
||||||
|
"nifty50",
|
||||||
|
"backtesting",
|
||||||
|
"fastapi",
|
||||||
|
"react",
|
||||||
|
"financial-trading"
|
||||||
|
],
|
||||||
|
"author": "hjlabs.in",
|
||||||
|
"license": "Apache-2.0",
|
||||||
"bugs": {
|
"bugs": {
|
||||||
"url": "https://github.com/hjlabs/TradingAgents/issues"
|
"url": "https://github.com/hemangjoshi37a/TradingAgents/issues"
|
||||||
},
|
},
|
||||||
"homepage": "https://github.com/hjlabs/TradingAgents#readme",
|
"homepage": "https://github.com/hemangjoshi37a/TradingAgents#readme",
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"playwright": "^1.58.1"
|
"playwright": "^1.58.1"
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
[project]
|
[project]
|
||||||
name = "tradingagents"
|
name = "tradingagents"
|
||||||
version = "0.1.0"
|
version = "0.1.0"
|
||||||
description = "Add your description here"
|
description = "Multi-Agent LLM Financial Trading Framework with AI-powered stock analysis, structured debates, and backtesting"
|
||||||
readme = "README.md"
|
readme = "README.md"
|
||||||
requires-python = ">=3.10"
|
requires-python = ">=3.10"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
|
|
|
||||||
2
setup.py
|
|
@ -10,7 +10,7 @@ setup(
|
||||||
description="Multi-Agents LLM Financial Trading Framework",
|
description="Multi-Agents LLM Financial Trading Framework",
|
||||||
author="TradingAgents Team",
|
author="TradingAgents Team",
|
||||||
author_email="yijia.xiao@cs.ucla.edu",
|
author_email="yijia.xiao@cs.ucla.edu",
|
||||||
url="https://github.com/hjlabs/TradingAgents",
|
url="https://github.com/hemangjoshi37a/TradingAgents",
|
||||||
packages=find_packages(),
|
packages=find_packages(),
|
||||||
install_requires=[
|
install_requires=[
|
||||||
"langchain>=0.1.0",
|
"langchain>=0.1.0",
|
||||||
|
|
|
||||||