Setup

Two installs: the CLI (runs backtests in the cloud) and the Python library (write strategies with autocomplete).

New here? See Ways to use SignalAI for the web app, CLI, and Claude connector.

1. Install the CLI

curl -fsSL https://signal-ai-mu.vercel.app/install.sh | sh

This drops the signalai command in ~/.local/bin (no Python needed for the CLI itself).

2. Install the Python library

pip install signalai-quant

Gives you from signalai_quant import Strategy, … for authoring (Python ≥ 3.11).

3. Log in

signalai login

This opens your browser to sign in, then stores the credential locally (macOS Keychain; an 0600 file on Linux). For headless or CI environments where no browser is reachable, pass a token directly — signalai login --token <your-token> (from API tokens) — or set SIGNALAI_TOKEN in the environment.

4. Verify

signalai init my_strategy.py
signalai submit my_strategy.py --symbols SPY --from 2024-01-01 --to 2024-12-31

submit runs your backtest in the cloud; track it with signalai status <id> and view results at your backtests.