diff --git a/.gitignore b/.gitignore index d3aca358..b4734bff 100644 --- a/.gitignore +++ b/.gitignore @@ -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 diff --git a/README.md b/README.md index 84cd4002..484c8236 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ [![arXiv](https://img.shields.io/badge/arXiv-2412.20138-B31B1B?logo=arxiv)](https://arxiv.org/abs/2412.20138) [![Python 3.13+](https://img.shields.io/badge/Python-3.13+-3776AB?logo=python&logoColor=white)](https://www.python.org/) -[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) +[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE) [![React](https://img.shields.io/badge/React_18-TypeScript-61DAFB?logo=react&logoColor=white)](https://react.dev/) [![FastAPI](https://img.shields.io/badge/FastAPI-Backend-009688?logo=fastapi&logoColor=white)](https://fastapi.tiangolo.com/) [![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-4.0-06B6D4?logo=tailwindcss&logoColor=white)](https://tailwindcss.com/) @@ -19,7 +19,7 @@ An open-source framework that deploys **specialized AI agents** — analysts
-[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)
@@ -56,7 +56,7 @@ An open-source framework that deploys **specialized AI agents** — analysts Dashboard — AI Recommendations at a Glance

- TradingAgents Dashboard showing all 50 Nifty stocks with AI recommendations, rank badges, and decision filters + TradingAgents Dashboard showing all 50 Nifty stocks with AI-powered BUY, SELL, HOLD recommendations, rank badges, confidence levels, and decision filters

@@ -64,7 +64,7 @@ An open-source framework that deploys **specialized AI agents** — analysts History — Backtesting & Portfolio Simulation

- Historical analysis page with prediction accuracy, risk metrics, portfolio simulator, and AI vs Nifty50 comparison + 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

@@ -72,7 +72,23 @@ An open-source framework that deploys **specialized AI agents** — analysts Stock Detail — Deep Analysis View

- Stock detail page showing SBIN analysis with rank badge, recommendation history, and prediction accuracy + Individual stock analysis page showing AI recommendation with confidence level, risk assessment, recommendation history timeline, and detailed analysis summary +

+ + +
+Analysis Pipeline — 12-Step AI Decision Process +
+

+ 12-step analysis pipeline visualization showing data collection, technical analysis, fundamental analysis, sentiment analysis, bull vs bear debate, and final trading decision +

+
+ +
+Investment Debates — Bull vs Bear AI Agents +
+

+ AI-powered investment debate between bull and bear researcher agents with research manager synthesis and final judgment

@@ -80,7 +96,7 @@ An open-source framework that deploys **specialized AI agents** — analysts Historical Date View — Ranked Stock Lists

- History page with date cards showing buy/sell/hold breakdown and expanded ranked stock list + History page with date cards showing buy/sell/hold breakdown, return percentages, and expanded ranked stock list with hold periods

@@ -88,7 +104,7 @@ An open-source framework that deploys **specialized AI agents** — analysts How It Works — Multi-Agent AI System

- Educational page explaining the multi-agent AI system with agent cards and debate process + Educational page explaining the multi-agent AI system architecture with agent role cards and structured debate process flow

@@ -96,7 +112,7 @@ An open-source framework that deploys **specialized AI agents** — analysts Settings — Configurable AI Models

- Settings panel for configuring LLM provider, model selection, and analysis parameters + Settings panel for configuring LLM provider selection between Claude and OpenAI, model tier selection, API key management, and debate round configuration

@@ -104,7 +120,7 @@ An open-source framework that deploys **specialized AI agents** — analysts Dark Mode

- Dashboard in dark mode with glassmorphic cards and premium styling + Dashboard in dark mode with glassmorphic card design, premium styling, and automatic system theme detection

@@ -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 | + +-------------------------------------+ ```
@@ -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.

- TradingAgents CLI interface + TradingAgents CLI interface showing ticker selection, date picker, and LLM configuration

--- @@ -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) | diff --git a/assets/TauricResearch.png b/assets/TauricResearch.png deleted file mode 100644 index 3e88994d..00000000 Binary files a/assets/TauricResearch.png and /dev/null differ diff --git a/assets/wechat.png b/assets/wechat.png deleted file mode 100644 index 94355680..00000000 Binary files a/assets/wechat.png and /dev/null differ diff --git a/frontend/docs/screenshots/01-dashboard-light.png b/frontend/docs/screenshots/01-dashboard-light.png deleted file mode 100644 index e1e95fdf..00000000 Binary files a/frontend/docs/screenshots/01-dashboard-light.png and /dev/null differ diff --git a/frontend/docs/screenshots/02-settings-modal.png b/frontend/docs/screenshots/02-settings-modal.png index 92275525..539c50f2 100644 Binary files a/frontend/docs/screenshots/02-settings-modal.png and b/frontend/docs/screenshots/02-settings-modal.png differ diff --git a/frontend/docs/screenshots/03-stock-detail-overview.png b/frontend/docs/screenshots/03-stock-detail-overview.png index 30943d29..5cf6321a 100644 Binary files a/frontend/docs/screenshots/03-stock-detail-overview.png and b/frontend/docs/screenshots/03-stock-detail-overview.png differ diff --git a/frontend/docs/screenshots/08-dashboard-dark-mode.png b/frontend/docs/screenshots/08-dashboard-dark-mode.png index 131e69fe..f6019fcf 100644 Binary files a/frontend/docs/screenshots/08-dashboard-dark-mode.png and b/frontend/docs/screenshots/08-dashboard-dark-mode.png differ diff --git a/frontend/docs/screenshots/09-how-it-works.png b/frontend/docs/screenshots/09-how-it-works.png index eea55595..b9fe7e96 100644 Binary files a/frontend/docs/screenshots/09-how-it-works.png and b/frontend/docs/screenshots/09-how-it-works.png differ diff --git a/frontend/docs/screenshots/10-history-page.png b/frontend/docs/screenshots/10-history-page.png index cce0b712..094e1bcd 100644 Binary files a/frontend/docs/screenshots/10-history-page.png and b/frontend/docs/screenshots/10-history-page.png differ diff --git a/frontend/docs/screenshots/11-history-stocks-expanded.png b/frontend/docs/screenshots/11-history-stocks-expanded.png index 5833d96b..22ad3a21 100644 Binary files a/frontend/docs/screenshots/11-history-stocks-expanded.png and b/frontend/docs/screenshots/11-history-stocks-expanded.png differ diff --git a/package.json b/package.json index da802f2e..cd26ffc6 100644 --- a/package.json +++ b/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" } diff --git a/pyproject.toml b/pyproject.toml index 63af4721..3574961f 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -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 = [ diff --git a/setup.py b/setup.py index ba5c224b..3e70273c 100644 --- a/setup.py +++ b/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",