2.8 KiB

Raw Blame History

TradingAgents Reports Module

This module provides comprehensive report generation capabilities for TradingAgents analysis results.

Structure

tradingagents/reports/
├── __init__.py                 # Main module interface
├── README.md                   # This documentation
├── generators/                 # Report generators
│   ├── __init__.py
│   └── pdf_generator.py       # PDF generation with Playwright/WeasyPrint
├── formatters/                 # Content formatters
│   ├── __init__.py
│   └── report_formatter.py    # Structures analysis data for reports
└── converters/                 # Content converters
    ├── __init__.py
    └── html_converter.py       # Rich console to HTML conversion

Features

🎯 Automatic PDF Generation

Generates PDF reports automatically after each analysis
Uses Playwright as primary engine (cross-platform, no system dependencies)
WeasyPrint fallback for compatibility
Professional styling with proper sections and formatting

📋 Structured Reports

Reports follow the exact terminal structure:

I. Analyst Team Reports - Market/Social/News/Fundamentals analysts
II. Research Team Decision - Bull/Bear/Research Manager analysis
III. Trading Team Plan - Trader's strategic recommendations
IV. Risk Management Team Decision - Risk analysts' perspectives
V. Portfolio Manager Decision - Final investment decision

🎨 Rich Formatting

Color-coded sections matching terminal output
Professional panels and styling
Markdown content conversion
Responsive layout for different content types

Usage

The reports module is automatically integrated into the main CLI workflow. No manual intervention required.

from tradingagents.reports import TradingReportPDFGenerator

# Used automatically in cli/main.py
generator = TradingReportPDFGenerator()
pdf_path = generator.generate_pdf(analysis_data, ticker, date)

Configuration

PDF generation can be configured in tradingagents/default_config.py:

"pdf_generation": {
    "enabled": True,
    "output_dir": "results",
    "page_format": "A4",
    "margin": "2cm",
    "font_family": "Arial, sans-serif",
    "font_size": "12pt",
    "auto_generate": True,
}

Dependencies

playwright: Primary PDF generation engine
weasyprint: Fallback PDF generation (optional)
rich: Terminal styling and content formatting
jinja2: HTML templating

Output

Generated files are saved to:

results/{ticker}/{date}/analysis_report.pdf - Main PDF report
results/{ticker}/{date}/analysis_report.html - HTML backup

Example file sizes:

PDF: ~900KB (comprehensive analysis with all sections)
HTML: ~45KB (structured content backup)

2.8 KiB Raw Blame History