Getting Started with TradAI¶

Complete guide to setting up your TradAI development environment.

Prerequisites¶

Install these tools before proceeding:

Verify Prerequisites¶

uv --version    # Should show 0.5.x or higher
just --version  # Should show 1.x or higher
docker --version

Quick Setup¶

Option 1: Dev Container (Recommended)¶

Open the repository in VS Code and accept "Reopen in Container". All tools are pre-installed.

Option 2: Manual Setup¶

# Clone the repository
git clone <repository-url>
cd tradai-uv

# Run setup (installs Python, syncs deps, configures pre-commit)
just setup

Watch for progress messages:

🚀 TradAI Setup (Step 1/4): Installing Python 3.11...
📦 TradAI Setup (Step 2/4): Syncing dependencies...
🔧 TradAI Setup (Step 3/4): Installing pre-commit hooks...
📋 TradAI Setup (Step 4/4): Checking environment files...
✅ Setup complete!

Verify Environment¶

Run the environment doctor to check everything is configured correctly:

just doctor

Expected output:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🩺 TradAI Environment Doctor
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔧 Checking required tools...
   ✓ Python:  Python 3.11.x
   ✓ UV:      uv 0.5.x
   ✓ Just:    just 1.x

📦 Checking Python packages...
   ✓ tradai-common
   ✓ tradai-data
   ✓ tradai-strategy

🔒 Checking pre-commit...
   ✓ Pre-commit hooks installed

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Legend: ✓ OK  ⚠ Warning  ✗ Error (fix required)

Fix any items marked with ✗ before continuing.

Start Services¶

Start all TradAI services with Docker:

# Start services
just up

# Verify services are running
just ps

You should see: - Backend (port 8000) - API gateway - Data Collection (port 8002) - Market data sync - Strategy Service (port 8003) - Backtesting engine - MLflow (port 5001) - Experiment tracking

Verify CLI¶

Test the TradAI CLI:

tradai --help

You should see commands for: - tradai up/down/logs/ps - Docker management - tradai strategy - Strategy management - tradai indicator - Indicator testing - tradai backtest - Backtest visualization - tradai data - Data collection

Environment Configuration¶

Copy the example environment file:

cp .env.example .env

Key settings in .env:

# Exchange API (optional for paper trading)
BINANCE_API_KEY=your_api_key
BINANCE_SECRET_KEY=your_secret_key

# Services
BACKEND_URL=http://localhost:8000
TRADAI_UI_URL=http://localhost:3000

Troubleshooting¶

"UV not found"¶

# Reinstall UV
curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc  # or restart terminal

"Docker service connection refused"¶

# Restart services
just down
just up

# Check logs for errors
just logs backend

"Pre-commit not installed"¶

uv run pre-commit install

Next Steps¶

1. Create Your First Strategy - Build a custom trading strategy
2. Run Your First Backtest - Test with historical data
3. Explore Indicators - Test indicator expressions

Quick Reference¶