LightGBMのGPU版をインストール時に pip コマンドでエラーが発生する場合の解決策

はじめに

LightGBM（cuda版）をインストールする際に、つまづいた点に関する解決策を書き残しておきます。

エラー内容

下記の pip コマンドで LightGBM のインストールを試みた。

pip install lightgbm 
    --no-binary lightgbm 
    --no-cache lightgbm 
    --config-settings=cmake.define.USE_CUDA=ON

すると、下記が出力されてインストールが進まない状態になった。

Usage:   
  pip install [options] <requirement specifier> [package-index-options] ...
  pip install [options] -r <requirements file> [package-index-options] ...
  pip install [options] [-e] <vcs project url> ...
  pip install [options] [-e] <local project path> ...
  pip install [options] <archive url/path> ...

no such option: --config-settings

解決策

Pip 23.1以降で--install-optionフラグが--config-settingsに置き換えられたため発生しています。 引用元：https://www.perplexity.ai/

どうやら、こちらの変更がなされているよう。
- pip の version が 23.1 以前： --install-option
- pip の version が 23.1 以後： --config-settings

なので、実行するインストールコマンドを、下記のように変更して実行すればOK。

pip install lightgbm 
    --no-binary lightgbm 
    --no-cache lightgbm 
    --install-option=cmake.define.USE_CUDA=ON

【追記】 こちらのインストールコマンドは依存関係により実行が失敗することがあるため、pip のバージョンを上げて --config-settings の方でインストールを試みることをオススメします。

おわりに

自分の開発環境下で使用している pip の version が古いため発生していた。