ai-trader

[](https://www.python.org/downloads/) [](LICENSE)

中文版說明 (Chinese Subpage)

A professional, config-driven backtesting framework for algorithmic trading, built on Backtrader. Seamlessly test, optimize, and integrate trading strategies with Large Language Models (LLMs) across stocks, crypto, and forex markets.

• Config-Driven Workflows: Define and manage backtests with version-controllable YAML files for reproducible results.
• Seamless LLM Integration: Built-in MCP (Model Context Protocol) server allows AI assistants like Claude to run backtests, fetch data, and analyze strategies.
• Multi-Market Support: Test strategies on US stocks, Taiwan stocks, cryptocurrencies, and forex.
• Extensive Strategy Library: Comes with over 20 built-in strategies, from classic indicators to advanced adaptive models.
• Powerful CLI: A rich command-line interface to run backtests, fetch market data, and list strategies.
• Developer Friendly: Easily create and test custom strategies with simple helpers and a clear structure.

1. Installation

Option A: Install from PyPI (Recommended for using the CLI)

pip install ai-trader

Use this if you want to:

• Use the CLI commands: ai-trader run, ai-trader fetch, ai-trader quick
• Run backtests on your own data files
• Use as a library in your Python projects

Option B: Install from Source (Recommended for examples and config templates)

git clone https://github.com/whchien/ai-trader.git
cd ai-trader
pip install -e .

Use this if you want to:

• Run the config-based examples in config/backtest/
• Use the example data files in data/
• Run the example scripts in scripts/examples/
• Contribute or customize strategies

*(Poetry users can run poetry install)*

**2. Ru