Getting Started

Get AlphaForge Running in 3 Steps

Register on Whop → Install → Sign in. The Free plan is free of charge (about 10 minutes total). Full instructions live in the official docs.

For complete instructions, parameters, and the full troubleshooting guide, see the official documentation.

Open Documentation →

Step 1 — Create a Whop Account

AlphaForge requires a Whop account for every plan, including Free. Start with the Free plan and upgrade to a paid plan later if you need more.

Want to start on a paid plan? Pick one from the paid plans page. See Freemium Limits for the differences.

Step 2 — Install the CLI

Run the following in your terminal. The installer downloads the latest binary into /usr/local/bin.

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

Run this in PowerShell (no admin needed). Installs into %USERPROFILE%\.forge\bin and updates PATH.

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 3 — Sign in with Whop

Sign in with the Whop account you registered in Step 1 via OAuth 2.0 PKCE — your browser opens automatically. Authentication data is cached at ~/.forge/credentials.json.

forge system auth login

Verify the activated membership with:

forge system auth status

Visualize Results — alpha-visualizer (optional)

alpha-visualizer is an OSS Python package (PyPI, MIT-licensed) that renders the backtest results produced by forge in your browser. It runs standalone — no dependency on 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

Troubleshooting

Issue	Fix
`command not found: forge`	Open a new terminal or run `source ~/.bashrc`.
Authentication error	Check your network connection and re-run `forge system auth login`. Make sure your Whop membership is active.
macOS security warning	Open System Settings → Privacy & Security and allow `forge`.

For uninstall steps, environment variable customization, and the complete troubleshooting matrix, see the documentation.

Open Documentation →

Command Quick Reference

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

For detailed parameters, output examples, and error codes across every subcommand, see the official documentation.

Open CLI Reference →

Top Commands

forge backtest run

Run a backtest applying a strategy to a single symbol.

forge backtest run SYMBOL --strategy ID

--strategy--start--json

See cli-reference →

forge optimize run

Parameter optimization with Optuna (TPE). Multi-objective also supported.

forge optimize run SYMBOL --strategy ID

--metric--trials--apply

See cli-reference →

forge optimize walk-forward

Split time series into windows; IS optimization → OOS evaluation for overfitting resistance.

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

--windows--metric

See cli-reference →

forge data fetch

Fetch OHLCV from a provider and store as Parquet.

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

--period--interval--watchlist

See cli-reference →

forge strategy save

forge strategy save FILE_PATH

--force

See cli-reference →

forge journal show

Show the full history of a strategy (snapshots, runs, tags, live summary).

forge journal show STRATEGY_ID

See cli-reference →

All Command Groups

Group	Description	Subcommands
`forge backtest`	Backtest execution, scanning, custom experiments	11
`forge optimize`	Parameter optimization (grid / bayes / wfa)	9
`forge strategy`	Strategy JSON save / validate / apply	9
`forge data`	Historical data fetch / update	4
`forge journal`	Trading journal and trade analysis	8
`forge live`	Live trading and broker integration	9
Other commands	`system` / `pine` / `idea` / `analyze` / `explore` and more	10 groups

For complete subcommand listings, options, return values, and sample output for each group, see the CLI Reference in the official docs.

Open CLI Reference →

If the issue persists, contact support@alforgelabs.com.