Get AlphaForge Running in a Single Step

The Trial plan needs no Whop registration and has no time limit — install once and you're ready to run (about 5 minutes total). A Whop OAuth login is only required to unlock the paid plans (Lifetime / Annual / Monthly). Full instructions live in the official docs.

Step 1 — Install the CLI

curl -sSL https://alforge-labs.github.io/install.sh | bash

irm https://alforge-labs.github.io/install.ps1 | iex

Prefer a manual setup? Download the latest per-platform binaries directly from GitHub Releases (latest).

Step 2 — Run on the Trial plan right away (no Whop registration)

Once installed, the Trial plan lets you immediately run alpha-forge backtest run, alpha-forge optimize run, alpha-forge optimize walk-forward, and more. The only Trial limits are: data capped at 2023-12-31, optimization capped at 50 trials, and no Pine Script export — everything else mirrors the paid plans.

# Example: run a backtest right away (Trial plan, no Whop registration)
alpha-forge system init                 # initialize a working directory
alpha-forge data fetch SPY --period 5y  # auto-fetch data up to 2023-12-31
alpha-forge backtest run SPY --strategy sma_crossover_v1

Paid plans (optional) — Sign in with Whop

To lift the Trial limits, purchase a paid plan on Whop (Lifetime / Annual / Monthly) and then run the command below. The OAuth 2.0 PKCE flow opens your browser automatically; credentials are cached at ~/.config/forge/credentials.json.

alpha-forge system auth login

Verify the activated membership with:

alpha-forge system auth status

See Trial Limits for the full feature comparison between Trial and paid plans.

Visualize Results — alpha-visualizer (optional)

alpha-visualizer is an OSS Python package (PyPI, Apache-2.0-licensed) that renders the backtest results produced by alpha-forge in your browser. It runs standalone — no dependency on alpha-forge itself — so you can add it any time.

# uv (recommended)
uv tool install alpha-visualizer

# pip
pip install alpha-visualizer

See the alpha-visualizer installation guide for full usage and configuration. PyPI: pypi.org/project/alpha-visualizer / GitHub: alforge-labs/alpha-visualizer

Automated Order Bridge — alpha-strike (optional)

alpha-strike is a self-hosted webhook bridge that receives TradingView alerts and routes orders to moomoo (US / HK stocks, crypto) and OANDA (FX / CFD), available as an OSS Python package (PyPI, Apache-2.0-licensed). The repo ships a reference architecture for running on Oracle Cloud Always Free + Cloudflare Tunnel + WAF at zero monthly cost.

# uv (recommended)
uv tool install alpha-strike

# pipx for a global CLI
pipx install alpha-strike

# pip
pip install alpha-strike

# Run
WEBHOOK_PASSPHRASE=your-secret alpha-strike

See the alpha-strike setup guide for the full VM provisioning, Cloudflare Tunnel, WAF and systemd procedure. PyPI: pypi.org/project/alpha-strike / GitHub: alforge-labs/alpha-strike

Troubleshooting

Command Quick Reference

Cards for the six core commands plus a full command catalog. Detailed parameters and output examples live in the official docs.

Top Commands

alpha-forge backtest run SYMBOL --strategy ID

alpha-forge optimize run SYMBOL --strategy ID

alpha-forge optimize walk-forward SYMBOL --strategy ID --windows N

alpha-forge data fetch SYMBOL --period 5y --interval 1d

alpha-forge strategy save FILE_PATH

alpha-forge journal show STRATEGY_ID

All Command Groups