TradingAgents Install & Setup Guide

Deploy specialized AI agents for fundamental, sentiment, and technical trading analysis.

What is TradingAgents?

Your personal AI trading firm

[TradingAgents](https://github.com/TauricResearch/TradingAgents) is a multi-agent trading framework that mirrors the dynamics of real-world trading firms. It features specialized roles including a Fundamentals Analyst, Sentiment Analyst, News Analyst, Technical Analyst, a Researcher Team, and a Trader Agent.

Disclaimer This framework is designed for research purposes only. It is not intended as financial, investment, or trading advice.

One-Shot AI Setup Prompt

Have Claude Code or Codex do the entire setup for you

If you are an admin running an AI assistant like **Claude Code**, **Codex**, or **Cursor**, you can copy and paste the prompt below. The AI will handle cloning, environment creation, and dependency installation automatically.

Set up the TradingAgents framework for me.

Repo: https://github.com/tauricresearch/tradingagents

Do this:
1. Clone the repo:
   git clone https://github.com/TauricResearch/TradingAgents.git
2. cd into TradingAgents
3. Create a python 3.12 virtual environment (e.g. using venv or conda) and activate it.
4. Run `pip install .` to install the dependencies.
5. Create a .env file from .env.example and prompt me to add my LLM API keys (e.g., OPENAI_API_KEY, ANTHROPIC_API_KEY).
6. Let me know when it's done and how to launch it using `python -m cli.main`.

undefined. Manual Installation

First, clone the repository and set up a Python 3.12 virtual environment.

git clone https://github.com/TauricResearch/TradingAgents.git
cd TradingAgents

conda create -n tradingagents python=3.12
conda activate tradingagents

pip install .

undefined. Docker Setup

If you prefer Docker, you can run the application seamlessly using Docker Compose.

cp .env.example .env
docker compose run --rm tradingagents

For local models with Ollama, use the `ollama` profile:

docker compose --profile ollama run --rm tradingagents-ollama

API Keys and Environment

Connecting to LLM Providers

TradingAgents supports multiple LLM providers. Create a `.env` file by copying the example:

cp .env.example .env

Open `.env` and add the API keys for the providers you intend to use. For example:

OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-...
GOOGLE_API_KEY=...

Running the CLI

Interacting with your agents

Launch the interactive CLI to begin evaluating market conditions:

tradingagents
# OR run directly:
python -m cli.main

From here, you can select your desired tickers (e.g., `AAPL`, `BTC-USD`, `0700.HK`), analysis date, LLM provider, and research depth.