Installation

Supported Environment

QUBO++ runs on Linux-based systems with the following CPUs:

• amd64: 64-bit Intel and AMD processors
• arm64: 64-bit ARM processors

Ubuntu 20.04 or later is recommended. For Windows users, QUBO++ can be used through WSL (Windows Subsystem for Linux).

Installation

There are two ways to install QUBO++:

• Method 1: apt (recommended) — Simple installation with automatic path configuration. Requires sudo privileges.
• Method 2: tar.gz — Manual installation without requiring apt repository setup. No sudo privileges needed.

Method 1: Install via apt (recommended)

Step 1: Add the QUBO++ repository

Download the signing key and add the repository:

curl -fsSL https://qubo-plus.github.io/qbpp-apt/qbpp.gpg \
  | sudo tee /usr/share/keyrings/qbpp.gpg > /dev/null
echo "deb [signed-by=/usr/share/keyrings/qbpp.gpg] https://qubo-plus.github.io/qbpp-apt stable main" \
  | sudo tee /etc/apt/sources.list.d/qbpp.list > /dev/null

Step 2: Install QUBO++

sudo apt update
sudo apt install qbpp

This automatically installs headers to /usr/local/include/qbpp/, shared libraries to /usr/local/lib/, and the qbpp-license command to /usr/local/bin/. No environment variable configuration is needed.

Upgrading

sudo apt update
sudo apt install --only-upgrade qbpp

Uninstalling

sudo apt remove qbpp

Method 2: Install via tar.gz

Download the .tar.gz file of the latest QUBO++ release from the Latest Releases page. Extract the archive as follows:

tar xf qbpp_<arch>_<version>.tar.gz

Setting Environment Variables

To compile and run QUBO++ programs, set the following environment variables. Add these lines to the end of your ~/.bashrc so that they are automatically set when a shell starts:

export QBPP_PATH=[QUBO++ install directory]

export CPLUS_INCLUDE_PATH=$QBPP_PATH/include:$CPLUS_INCLUDE_PATH
export LIBRARY_PATH=$QBPP_PATH/lib:$LIBRARY_PATH
export LD_LIBRARY_PATH=$QBPP_PATH/lib:$LD_LIBRARY_PATH
export PATH=$QBPP_PATH/bin:$PATH

License Activation

After installation, activate the license to start using QUBO++:

qbpp-license -k XXXXXX-XXXXXX-XXXXXX-XXXXXX -a

If no license key is set, an Anonymous Trial (7 days, 1,000 variables) is activated.

For details on license types, deactivation, troubleshooting, and more, see License Management.

インストール

対応環境

QUBO++ は以下の CPU を搭載した Linux ベースのシステムで動作します：

• amd64: 64ビット Intel および AMD プロセッサ
• arm64: 64ビット ARM プロセッサ

Ubuntu 20.04 以降を推奨します。 Windows ユーザーは WSL (Windows Subsystem for Linux) を通じて QUBO++ を使用できます。

インストール

QUBO++ のインストール方法は2つあります：

• 方法1: apt（推奨） — パスの自動設定を含むシンプルなインストール。sudo 権限が必要です。
• 方法2: tar.gz — apt リポジトリの設定が不要な手動インストール。sudo 権限は不要です。

方法1: apt によるインストール（推奨）

ステップ1: QUBO++ リポジトリの追加

署名鍵をダウンロードし、リポジトリを追加します：

curl -fsSL https://qubo-plus.github.io/qbpp-apt/qbpp.gpg \
  | sudo tee /usr/share/keyrings/qbpp.gpg > /dev/null
echo "deb [signed-by=/usr/share/keyrings/qbpp.gpg] https://qubo-plus.github.io/qbpp-apt stable main" \
  | sudo tee /etc/apt/sources.list.d/qbpp.list > /dev/null

ステップ2: QUBO++ のインストール

sudo apt update
sudo apt install qbpp

これにより、ヘッダファイルが /usr/local/include/qbpp/ に、共有ライブラリが /usr/local/lib/ に、qbpp-license コマンドが /usr/local/bin/ に自動的にインストールされます。 環境変数の設定は不要です。

アップグレード

sudo apt update
sudo apt install --only-upgrade qbpp

アンインストール

sudo apt remove qbpp

方法2: tar.gz によるインストール

Latest Releases ページから最新の QUBO++ リリースの .tar.gz ファイルをダウンロードします。 以下のようにアーカイブを展開します：

tar xf qbpp_<arch>_<version>.tar.gz

環境変数の設定

QUBO++ プログラムをコンパイル・実行するには、以下の環境変数を設定します。 シェル起動時に自動的に設定されるよう、~/.bashrc の末尾に以下の行を追加してください：

export QBPP_PATH=[QUBO++ インストールディレクトリ]

export CPLUS_INCLUDE_PATH=$QBPP_PATH/include:$CPLUS_INCLUDE_PATH
export LIBRARY_PATH=$QBPP_PATH/lib:$LIBRARY_PATH
export LD_LIBRARY_PATH=$QBPP_PATH/lib:$LD_LIBRARY_PATH
export PATH=$QBPP_PATH/bin:$PATH

ライセンスのアクティベーション

インストール後、ライセンスをアクティベートして QUBO++ の使用を開始します：

qbpp-license -k XXXXXX-XXXXXX-XXXXXX-XXXXXX -a

ライセンスキーが設定されていない場合、Anonymous Trial（7日間、1,000変数）がアクティベートされます。

ライセンスの種類、ディアクティベーション、トラブルシューティングなどの詳細は ライセンス管理 をご覧ください。