Skip to content
CAI
Software that uses CAICheck a score

TauricResearch/TradingAgents

55.8

Adequate · 14 November 2026

11.2k

lines of production code

Python

primary language

7

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Docker support for cross-platform deployment

Users can now deploy TradingAgents using Docker, with a multi-stage Dockerfile and a docker-compose.yml that includes profiles for running with a local Ollama instance. The setup creates a dedicated non-root user and pre-creates the \~/.tradingagents directory to resolve permission issues, while .env.example and .env.enterprise.example files provide templates for configuring API keys and environment variables.

(repo-wide) · high confidence

Initial public release of TradingAgents with structured decision-making agents

This release introduces the core trading agent framework, including the Sentiment Analyst (now integrated with StockTwits and Reddit, featuring social-post screening via TypeSafe's Jev), the Research Manager, the Trader, and the Portfolio Manager. These decision-making agents produce structured outputs (Pydantic schemas) for investment plans, transaction proposals, and final ratings, while falling back to free-text generation if the LLM provider does not support structured output. The system enforces a consistent 5-tier rating scale (Buy, Overweight, Hold, Underweight, Sell) and deterministic instrument identity resolution to prevent hallucination. Additionally, the framework supports localized output reports, parallel execution of analysts, and persistent decision logging.

tradingagents/agents · high confidence

Introduce Alpha Vantage vendor with safer error handling and backtest data isolation

This change adds the Alpha Vantage data provider to the trading agents, exposing functions for stock prices, fundamentals, technical indicators, news, and insider transactions. It improves reliability by scrubbing API keys from error messages and correctly classifying API rejections as unavailable rather than configuration errors. For backtesting, it ensures data integrity by withholding live-only profiles and undated financial statements when a past analysis date is specified, and by filtering historical stock data to the requested date range.

_tradingagents/dataflows/vendors/alpha\vantage · high confidence

Introduce TradingAgents CLI with interactive analysis, backtesting, and checkpoint resume

The CLI module is now a fully functional entry point for the framework. Users can run interactive multi-agent financial analyses with a live Rich-based display, select LLM providers and analysts, and configure research depth. A new backtest command allows scoring past decisions over a grid of tickers and dates. The CLI supports checkpointing to resume crashed runs, saves reports and logs to a results directory, and remembers previous run selections as defaults. It also handles announcements from a remote endpoint and respects environment variable overrides for configuration.

cli · high confidence

Introduce append-only memory log with decision settlement and reflection

The trading agents now maintain a persistent memory log that records each trading decision as pending, then settles it once the holding window has traded. Settlement calculates the raw and alpha returns against a benchmark (defaulting to SPY, with support for exchange-specific mappings), and uses an LLM to generate a concise reflection on the outcome. These reflections are stored in the log and can be injected as context for future analyses, with a filter to ensure only past lessons (resolved before a given date) are used in backtests to prevent look-ahead bias. The implementation includes thread-safe, append-only file operations and atomic writes to ensure data integrity.

tradingagents/memory · high confidence

Introduce dataflows module with point-in-time guards, vendor error taxonomy, and symbol normalization

The new \tradingagents/dataflows\ package centralizes data access logic, introducing strict point-in-time rules that prevent historical runs from seeing future data (withholding live profiles, undated statements, and undisclosed insider trades) and clamping tool dates to the run's trade date. It adds a unified \VendorError\ hierarchy so the router can distinguish between unavailable vendors and missing data, normalizes broker symbols to Yahoo Finance conventions to avoid empty results, and secures file writes with atomic temp-file swaps and cross-platform locking.

tradingagents/dataflows · high confidence

Introduce dedicated Bull and Bear researcher agents for investment debates

The researchers module now includes distinct Bull and Bear analyst agents that engage in a structured debate. These agents construct arguments by leveraging market, sentiment, news, and fundamentals reports, while dynamically adapting their language and terminology based on whether the target is a stock or a crypto asset. They also incorporate the opponent's previous points to ensure a responsive and engaging dialogue.

tradingagents/agents/researchers · high confidence

Introduce resumable agent graph with per-ticker checkpoints and deferred outcome reflection

The trading workflow now supports crash recovery via LangGraph checkpoints stored in per-ticker SQLite databases, keyed by a signature that includes the analyst selection and portfolio state to prevent incompatible resumes. Additionally, the system implements deferred outcome reflection: after a trade decision is made, the graph waits for the holding window to close, then automatically fetches price data, calculates alpha against a benchmark, and generates a concise lesson that is stored in the decision log for future runs.

tradingagents/graph · high confidence

Introduce structured Portfolio and Research Manager agents

New Portfolio and Research Manager agents have been added to the managers package to synthesize debate outcomes into final decisions and investment plans. These agents utilize LangChain's structured output capabilities to produce typed results (PortfolioDecision and ResearchPlan) with a consistent five-tier rating scale (Buy, Overweight, Hold, Underweight, Sell), while gracefully falling back to free-text generation if the provider does not support structured output. The Portfolio Manager specifically reads the trader's proposal and research plan to make its final call, and the Research Manager converts the bull/bear debate into a structured plan for the trader.

tradingagents/agents/managers · high confidence

Introduce structured backtesting, persistent decision logging, and environment-based configuration

The tradingagents package now includes a dedicated backtest module that evaluates decisions across a grid of tickers and dates, scoring outcomes against regional benchmarks and recording results in a persistent, append-only markdown decision log. Configuration is centralized in a new default config file that supports overriding settings via TRADINGAGENTS\\ environment variables, and the package automatically loads .env files on import to ensure LLM clients and the config system have access to user keys. A new portfolio context model allows callers to pass their current holdings and cash balance into runs, enabling the agents to distinguish between opening new positions and adding to existing ones. Also in this area: 7 commits (5 fixes) fixing tradingagents; Version 0.7.0 release with ChatGPT plan support and backtest timing fix; TradingAgents 0.6.0: per-tier LLM providers and self-contained HTML reports; Backtest progress reporting, deduplication, and tool-round configuration; Portfolio Manager rating now included in memory logs and reports.

tradingagents · medium confidence · unverified

New data vendors for macro, sentiment, and filings

The dataflow layer now includes dedicated vendors for fetching FRED macroeconomic indicators (including euro-area series), Polymarket prediction-market probabilities, Reddit ticker discussions, SEC EDGAR company filings, and StockTwits social sentiment. These new sources allow the agents to ground analysis in real-time market odds, historical macro trends, social sentiment, and vintage-correct financial statements, expanding the range of data available for investment decisions.

tradingagents/dataflows/vendors · high confidence

New specialized analyst agents for fundamentals, market, news, and sentiment

The trading system now includes four distinct analyst agents that provide specialized reports to inform trading decisions. The Fundamentals Analyst examines financial statements (balance sheet, cash flow, income statement) and insider transactions. The Market Analyst selects relevant technical indicators and uses a verified market snapshot to ground price claims. The News Analyst aggregates company-specific news, global macroeconomic data from FRED, and live prediction market probabilities. The Sentiment Analyst synthesizes data from Yahoo Finance news, StockTwits, and Reddit into a structured sentiment report, optionally screening social posts for quality. Each agent is configured with specific tools and prompts to deliver focused insights.

tradingagents/agents/analysts · high confidence

Behavioural changes

Renamed risk debate agents to aggressive and conservative roles

The risk management debate module has been reorganized to rename the previously 'risky' and 'safe' agents to 'aggressive' and 'conservative' respectively. This change updates the agent prompts and state tracking to reflect these new roles, where the aggressive analyst champions high-reward opportunities and the conservative analyst focuses on asset protection and risk mitigation, while the neutral analyst maintains a balanced perspective.

_tradingagents/agents/risk\mgmt · high confidence

Trader agent now requires absolute price levels and grounds decisions in technical market reports

The Trader agent has been refactored to enforce structured output that mandates absolute price levels (e.g., 189.5) for entry and stop-loss, explicitly rejecting percentage-based or range-based inputs to prevent parsing failures. Additionally, the agent now incorporates the technical market report (including current price, support/resistance, and ATR data) into its system prompt to ground concrete price levels in real market structure, while also accepting the caller's portfolio context to inform position sizing.

tradingagents/agents/trader · high confidence

Unified multi-provider LLM client architecture with capability-aware structured output

The LLM client layer has been refactored into a modular, factory-based system that standardizes how TradingAgents connects to diverse AI providers. This change introduces a unified client interface (BaseLLMClient) and a central factory (create\_llm\_client) that lazily loads provider-specific implementations for Anthropic, Google, Azure, Amazon Bedrock, and a broad range of OpenAI-compatible endpoints (including xAI, DeepSeek, MiniMax, Qwen, GLM, Kimi, Groq, and Mistral). A key behavioral improvement is the introduction of a declarative capability table (capabilities.py) that automatically handles provider-specific API quirks—such as suppressing unsupported parameters like tool\_choice for DeepSeek V4 or routing reasoning blocks for MiniMax—ensuring structured output works reliably across different models. Additionally, the system now normalizes response content to plain strings for consistent downstream handling, supports configurable output-token caps and sampling temperature, and provides a single source of truth for API key environment variables to streamline CLI authentication flows.

_tradingagents/llm\clients · high confidence

Fixes

Yahoo Finance vendor integration with improved error handling and data formatting

The Yahoo Finance data provider has been refactored into a modular structure (common, fundamentals, market, news, ohlcv, snapshot) to improve reliability and data accuracy. Key changes include: 1) Better error reporting: failed requests, rate limits, and unreachable vendors are now correctly distinguished from 'no data' scenarios, preventing agents from fabricating prices. 2) Enhanced data formatting: financial fundamentals now display currency units and percentages with their proper symbols (e.g., '0.41%' for dividend yield, 'GBP' for currency). 3) Robust news handling: news articles with null fields are handled gracefully, and when the primary quote feed is empty, Yahoo search is used as a fallback to find relevant articles. 4) Improved OHLCV data processing: stale data is rejected, date normalization is more robust across timezones, and cache files are written atomically. 5) New verified market snapshot: a deterministic ground-truth snapshot of OHLCV data and technical indicators is now available for LLM verification, reducing hallucinations.

tradingagents/dataflows/vendors/yahoo · high confidence

Test coverage

Comprehensive test suite for core platform capabilities

The test suite now covers critical platform areas including Alpha Vantage data hardening (request timeouts, rate-limit detection, and look-ahead filters), Anthropic effort-parameter gating for model compatibility, and secure API key management (ensuring owner-only file permissions and correct environment variable mapping). It also validates the backtesting engine's grid iteration and decision scoring, the checkpoint lifecycle for crash recovery and resume logic, and the CLI command routing for both standard analysis and backtest modes. Also in this area: 18 commits adding/updating tests in tests; Added tests for ChatGPT plan authentication, provider behavior, CLI update notices, and memory settlement logic; Test coverage for hardening, reporting, and memory settlement; Test suite isolation and coverage expansion; Added tests for parallel analyst execution and atomic cache writes; and 1 more.

tests · high confidence · unverified

Dependencies

Introduce pyproject.toml and consolidate dependencies

The project now uses pyproject.toml as the primary configuration file, consolidating build system settings, project metadata, and dependency declarations. This change introduces a structured dependency list including langchain-core, langchain-anthropic, langchain-google-genai, langchain-openai, langgraph, and others, while also defining optional dependencies for development (ruff, pytest) and Amazon Bedrock support (langchain-aws). The requirements.txt file is retained but appears to be a minimal placeholder or generated artifact, with the authoritative dependency definitions now residing in pyproject.toml.

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 54 → 56 (+1.4)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 78 → 75 (-3.0)
  • Architecture 85 → 86 (+1.2)
  • Maturity 57 → 63 (+5.9)
  • Readiness 42 → 42 (+0.0)
  • Security 69 → 69 (+0.0)

Resolved (4)

  • Duplicated block (7 lines × 3) (cli/display.py)
  • Duplicated block (8 lines × 2) (cli/display.py)
  • Hotspot: tradingagents/agents/context.py (tradingagents/agents/context.py)
  • No ADRs found

New (8)

  • Edited copy of a member (10 corresponding lines) (tradingagents/llm_clients/factory.py)
  • Edited copy of a member (41 corresponding lines) (tradingagents/agents/analysts/fundamentals_analyst.py)
  • Edited copy of a member (51 corresponding lines) (tradingagents/memory/log.py)
  • Hotspot: tradingagents/memory/log.py (tradingagents/memory/log.py)
  • No ADRs found (pyproject.toml)
  • Repeated repair: tradingagents/dataflows/files.py (tradingagents/dataflows/files.py)
  • Repeated repair: tradingagents/memory/settlement.py (tradingagents/memory/settlement.py)
  • Scattered collaborators

Changes since last survey

  • 23 commits — 5 feature/other, 18 fixes

By area

  • (root) — 3 commits
  • tests/test_tool_date_enforcement.py — 3 commits
  • tests/test_backtest.py — 2 commits
  • tests/test_memory_log.py — 2 commits
  • tests/test_portfolio_context.py — 2 commits
  • tests/test_sec_edgar.py — 2 commits
  • (repo) — 1 commit
  • cli/prompts.py — 1 commit
  • tests/test_anthropic_effort.py — 1 commit
  • tests/test_azure_client.py — 1 commit
  • tests/test_cache_writes.py — 1 commit
  • tests/test_polymarket.py — 1 commit
  • tests/test_reporting.py — 1 commit
  • tradingagents/init.py — 1 commit
  • tradingagents/dataflows — 1 commit

Notable commits

  • fix: fix(backtest): give each sweep started without a run_id its own run (#1549)
  • fix: fix(backtest): report the settlement failures a sweep's last pass records (#1557)
  • fix: fix(cli): check a ticker with the data layer's own rule (#1604)
  • fix: fix(llm): pass the output-token cap and a configured endpoint to Azure OpenAI (#1584, #1600)
  • fix: fix(llm): read a dated Claude snapshot's version without its date (#1585)
  • fix: fix(memory): settle decisions on final closes, across long market closures (#1548, #1539)
  • fix: fix(memory): take the most recent lessons by decision date (#1603)
  • fix: fix(polymarket): keep a long shot's odds from printing as 0% or 100% (#1598)
  • fix: fix(portfolio): match a holding listed under a broker alias to the analyzed instrument (#1556)
  • fix: fix(portfolio): refuse a portfolio with a number that is not finite (#1509)
  • fix: fix(reporting): remove a previous run's sections when a report is saved to the same folder (#1566)
  • fix: fix(sec_edgar): print a figure under one million instead of 0 (#1589)
  • fix: fix(sec_edgar): serve a statement one row per period (#1517, #1542)
  • fix: fix(tools): accept only the statement frequencies the vendors serve (#1593)
  • fix: fix(tools): hand vendors the model's dates as YYYY-MM-DD (#1488)
  • fix: fix(tools): send a date window that ends before it starts back to the model (#1595)
  • fix: fix(yahoo): print prices with their significant digits (#1567)
  • fix: test: fix tests that failed on Windows and macOS (#1506, #1485, #1541)
  • change: Merge pull request #1613 from TauricResearch/v0.7.1
  • change: announce Trading-R1 official release
  • …and 3 more

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

TauricResearch/TradingAgents was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 14 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit 9fa1196fffbcfd9de5146d2dd2869df84ab99838 — the exact code this score is about.
  • Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-859b6d22580d.