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 tradingagentsFor local models with Ollama, use the `ollama` profile:
docker compose --profile ollama run --rm tradingagents-ollamaAPI Keys and Environment
Connecting to LLM Providers
TradingAgents supports multiple LLM providers. Create a `.env` file by copying the example:
cp .env.example .envOpen `.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.mainFrom here, you can select your desired tickers (e.g., `AAPL`, `BTC-USD`, `0700.HK`), analysis date, LLM provider, and research depth.