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

Via Homebrew (optional)

On macOS (Apple Silicon) you can also install with Homebrew. Updates flow through brew upgrade.

brew install alforge-labs/tap/alpha-forge

Via uv / PyPI (optional)

If you have uv / Python, you can install from PyPI too (currently macOS Apple Silicon; more platforms coming). It provides the alpha-forge command.

# Try without installing
uvx alpha-forge-launcher demo
# Persistent install (the alpha-forge command becomes available)
uv tool install alpha-forge-launcher   # or: pip install alpha-forge-launcher
alpha-forge --version

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: one-shot backtest on bundled DEMO data (Trial plan, no Whop registration, no data fetch)
alpha-forge demo                        # init + DEMO backtest + result + visualization hint, all at once
# To try real data:
alpha-forge data fetch SPY --period 5y  # auto-fetch data up to 2023-12-31
alpha-forge backtest run SPY --strategy sma_crossover_v1

Hand it to an AI agent (paste-ready prompt)

Paste the following prompt into an AI agent (Claude Code / Cursor / Codex, ...) and it will install and run your first backtest automatically (free Trial, no login).

Install AlphaForge (a backtesting CLI) and run my first backtest:
1. Run the installer (mac/Linux): curl -sSL https://alforge-labs.github.io/install.sh | bash
   (Windows PowerShell: irm https://alforge-labs.github.io/install.ps1 | iex)
2. Run `alpha-forge demo` (initializes and runs a backtest on bundled DEMO data in one shot)
3. Summarize the printed result (Sharpe, total return, number of trades)
AlphaForge runs on the free Trial (no login). If anything fails, run `alpha-forge system doctor`.

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