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
|
||||
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://www.python.org/)
|
||||
[](LICENSE)
|
||||
[](LICENSE)
|
||||
[](https://react.dev/)
|
||||
[](https://fastapi.tiangolo.com/)
|
||||
[](https://tailwindcss.com/)
|
||||
|
|
@ -19,7 +19,7 @@ An open-source framework that deploys **specialized AI agents** — analysts
|
|||
|
||||
<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 />
|
||||
|
||||
|
|
@ -56,7 +56,7 @@ An open-source framework that deploys **specialized AI agents** — analysts
|
|||
<summary><b>Dashboard — AI Recommendations at a Glance</b></summary>
|
||||
<br />
|
||||
<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>
|
||||
</details>
|
||||
|
||||
|
|
@ -64,7 +64,7 @@ An open-source framework that deploys **specialized AI agents** — analysts
|
|||
<summary><b>History — Backtesting & Portfolio Simulation</b></summary>
|
||||
<br />
|
||||
<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>
|
||||
</details>
|
||||
|
||||
|
|
@ -72,7 +72,23 @@ An open-source framework that deploys **specialized AI agents** — analysts
|
|||
<summary><b>Stock Detail — Deep Analysis View</b></summary>
|
||||
<br />
|
||||
<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>
|
||||
</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>
|
||||
<br />
|
||||
<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>
|
||||
</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>
|
||||
<br />
|
||||
<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>
|
||||
</details>
|
||||
|
||||
|
|
@ -96,7 +112,7 @@ An open-source framework that deploys **specialized AI agents** — analysts
|
|||
<summary><b>Settings — Configurable AI Models</b></summary>
|
||||
<br />
|
||||
<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>
|
||||
</details>
|
||||
|
||||
|
|
@ -104,7 +120,7 @@ An open-source framework that deploys **specialized AI agents** — analysts
|
|||
<summary><b>Dark Mode</b></summary>
|
||||
<br />
|
||||
<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>
|
||||
</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:
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────┐
|
||||
│ Data Collection │
|
||||
│ (Market, News, Social, Financials) │
|
||||
└──────────────┬──────────────────────┘
|
||||
│
|
||||
┌──────────────▼──────────────────────┐
|
||||
│ Analyst Team │
|
||||
│ Technical ┃ Fundamental ┃ Sentiment │
|
||||
│ ┃ News ┃ │
|
||||
└──────────────┬──────────────────────┘
|
||||
│
|
||||
┌──────────────▼──────────────────────┐
|
||||
│ Researcher Team │
|
||||
│ Bull Researcher ⚔ Bear Researcher │
|
||||
│ (Structured AI Debate) │
|
||||
└──────────────┬──────────────────────┘
|
||||
│
|
||||
┌──────────────▼──────────────────────┐
|
||||
│ Trader Agent │
|
||||
│ Synthesizes reports → Decision │
|
||||
└──────────────┬──────────────────────┘
|
||||
│
|
||||
┌──────────────▼──────────────────────┐
|
||||
│ Risk Management & Portfolio Mgr │
|
||||
│ Evaluates risk → Approves/Rejects │
|
||||
└─────────────────────────────────────┘
|
||||
+-------------------------------------+
|
||||
| Data Collection |
|
||||
| (Market, News, Social, Financials) |
|
||||
+-----------------+-------------------+
|
||||
|
|
||||
+-----------------v-------------------+
|
||||
| Analyst Team |
|
||||
| Technical | Fundamental | Sentiment |
|
||||
| | News | |
|
||||
+-----------------+-------------------+
|
||||
|
|
||||
+-----------------v-------------------+
|
||||
| Researcher Team |
|
||||
| Bull Researcher vs Bear Researcher |
|
||||
| (Structured AI Debate) |
|
||||
+-----------------+-------------------+
|
||||
|
|
||||
+-----------------v-------------------+
|
||||
| Trader Agent |
|
||||
| Synthesizes reports -> Decision |
|
||||
+-----------------+-------------------+
|
||||
|
|
||||
+-----------------v-------------------+
|
||||
| Risk Management & Portfolio Mgr |
|
||||
| Evaluates risk -> Approves/Rejects |
|
||||
+-------------------------------------+
|
||||
```
|
||||
|
||||
<details>
|
||||
|
|
@ -173,7 +189,7 @@ TradingAgents mirrors the structure of real-world trading firms by decomposing c
|
|||
|
||||
```bash
|
||||
# Clone the repository
|
||||
git clone https://github.com/hjlabs/TradingAgents.git
|
||||
git clone https://github.com/hemangjoshi37a/TradingAgents.git
|
||||
cd TradingAgents
|
||||
|
||||
# Create virtual environment
|
||||
|
|
@ -207,7 +223,7 @@ python -m cli.main
|
|||
Select your tickers, date, LLMs, and research depth from the interactive interface.
|
||||
|
||||
<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>
|
||||
|
||||
---
|
||||
|
|
@ -247,7 +263,7 @@ npm run dev # http://localhost:5173
|
|||
|
||||
| Layer | Technology |
|
||||
|-------|-----------|
|
||||
| Frontend | React 18 + TypeScript, Vite, Tailwind CSS |
|
||||
| Frontend | React 18 + TypeScript, Vite, Tailwind CSS 4 |
|
||||
| Charts | Recharts |
|
||||
| Icons | Lucide React |
|
||||
| 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",
|
||||
"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",
|
||||
"scripts": {
|
||||
"test": "echo \"Error: no test specified\" && exit 1"
|
||||
},
|
||||
"repository": {
|
||||
"type": "git",
|
||||
"url": "git+https://github.com/hjlabs/TradingAgents.git"
|
||||
"url": "git+https://github.com/hemangjoshi37a/TradingAgents.git"
|
||||
},
|
||||
"keywords": [],
|
||||
"author": "",
|
||||
"license": "ISC",
|
||||
"keywords": [
|
||||
"trading",
|
||||
"ai",
|
||||
"multi-agent",
|
||||
"llm",
|
||||
"stock-analysis",
|
||||
"nifty50",
|
||||
"backtesting",
|
||||
"fastapi",
|
||||
"react",
|
||||
"financial-trading"
|
||||
],
|
||||
"author": "hjlabs.in",
|
||||
"license": "Apache-2.0",
|
||||
"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": {
|
||||
"playwright": "^1.58.1"
|
||||
}
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
[project]
|
||||
name = "tradingagents"
|
||||
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"
|
||||
requires-python = ">=3.10"
|
||||
dependencies = [
|
||||
|
|
|
|||
2
setup.py
|
|
@ -10,7 +10,7 @@ setup(
|
|||
description="Multi-Agents LLM Financial Trading Framework",
|
||||
author="TradingAgents Team",
|
||||
author_email="yijia.xiao@cs.ucla.edu",
|
||||
url="https://github.com/hjlabs/TradingAgents",
|
||||
url="https://github.com/hemangjoshi37a/TradingAgents",
|
||||
packages=find_packages(),
|
||||
install_requires=[
|
||||
"langchain>=0.1.0",
|
||||
|
|
|
|||