Getting Started

インストールガイド

AlphaForge CLI をインストールしてライセンス認証するまでの手順です。所要時間は約5分です。

前提条件

インストール

macOS / Linux
Windows
手動インストール

ターミナルで以下のコマンドを実行してください。インストーラーが最新バイナリをダウンロードし、/usr/local/bin に配置します。

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

インストール先を変更したい場合は INSTALL_DIR 環境変数で指定できます。例: INSTALL_DIR=~/.local/bin curl -sSL ... | bash

PowerShell（管理者権限不要）で以下を実行してください。バイナリを %USERPROFILE%\.forge\bin にインストールし、PATH を自動設定します。

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

インストール後、新しいターミナルウィンドウを開いてから次の手順に進んでください。

  1. GitHub Releases から使用するプラットフォームのバイナリをダウンロードします。
  2. macOS / Linux: 実行権限を付与して PATH の通ったディレクトリに配置します。
    chmod +x forge-macos-arm64
sudo mv forge-macos-arm64 /usr/local/bin/forge
  3. Windows: バイナリを任意のフォルダに配置し、そのフォルダを PATH に追加します。

ライセンス認証

  1. インストール確認

    インストールが成功したことを確認します。

    forge --version
  2. ライセンスキーを認証

    購入完了メールに記載されているライセンスキーで認証します。

    forge license activate <YOUR_LICENSE_KEY>

    認証情報は ~/.forge/license.json に保存されます。オンライン接続が必要です。

  3. 動作確認

    バックテストコマンドが利用可能なことを確認します。

    forge backtest --help

アンインストール

# macOS / Linux
sudo rm /usr/local/bin/forge
rm -rf ~/.forge

トラブルシューティング

症状対処
command not found: forge新しいターミナルを開くか、source ~/.bashrc を実行してください。
ライセンス認証エラーネットワーク接続を確認し、キーに余分なスペースがないか確認してください。
macOS セキュリティ警告システム設定 → プライバシーとセキュリティ → 「forge を開く」を許可してください。

問題が解決しない場合は support@alforgelabs.com までお問い合わせください。

Getting Started

Installation Guide

Install AlphaForge CLI and activate your license in about five minutes.

Requirements

Install

macOS / Linux
Windows
Manual

Run the following command in your terminal. The installer downloads the latest binary and places it in /usr/local/bin.

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

Set INSTALL_DIR if you want to install elsewhere. Example: INSTALL_DIR=~/.local/bin curl -sSL ... | bash

Run this in PowerShell. It installs the binary into %USERPROFILE%\.forge\bin and updates PATH.

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

Open a new terminal window after installation before continuing.

  1. Download the binary for your platform from GitHub Releases.
  2. macOS / Linux: make it executable and move it to a directory on your PATH.
    chmod +x forge-macos-arm64
sudo mv forge-macos-arm64 /usr/local/bin/forge
  3. Windows: place the binary in any folder and add that folder to PATH.

License Activation

  1. Check installation

    Confirm that the binary is available.

    forge --version
  2. Activate your license

    Use the license key from your purchase email.

    forge license activate <YOUR_LICENSE_KEY>

    Activation data is cached at ~/.forge/license.json. Internet access is required.

  3. Verify commands

    Confirm that backtest commands are available.

    forge backtest --help

Uninstall

# macOS / Linux
sudo rm /usr/local/bin/forge
rm -rf ~/.forge

Troubleshooting

IssueFix
command not found: forgeOpen a new terminal or run source ~/.bashrc.
License activation errorCheck your network connection and make sure the key has no extra spaces.
macOS security warningOpen System Settings → Privacy & Security and allow forge.

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