Quick Start

This page provides an overview of the Quick Start procedure. More detailed instructions for installing QUBO++ on WSL on Windows 11 are available in Quick Start for Windows (WSL).

Installation

There are two ways to install QUBO++:

Method 1: apt (recommended) — Simple installation with automatic path configuration
Method 2: tar.gz — Manual installation without requiring apt repository setup

Method 1: Install via apt (recommended)

First, add the QUBO++ apt repository:

curl -fsSL https://nakanocs.github.io/qbpp-apt/KEY.gpg | sudo gpg --dearmor -o /usr/share/keyrings/qbpp.gpg
echo "deb [signed-by=/usr/share/keyrings/qbpp.gpg] https://nakanocs.github.io/qbpp-apt stable main" | sudo tee /etc/apt/sources.list.d/qbpp.list

Then install QUBO++:

sudo apt update
sudo apt install qbpp

This automatically installs headers, shared libraries, and the qbpp-license command. No environment variable configuration is needed.

Method 2: Install via tar.gz

Download the latest tar.gz from Latest Releases and extract it:

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

QUBO++ will be extracted into a directory such as qbpp_<arch>_<version>.

Set the environment variables as follows:

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

These environment variables are used for license management and for compiling, linking, and executing QUBO++ programs.

Compile and execute a sample program

Create a QUBO++ sample program

Create a QUBO++ sample program below and save as file test.cpp:

#define MAXDEG 2
#include <qbpp/qbpp.hpp>
#include <qbpp/exhaustive_solver.hpp>

int main() {
  auto x = 0 <= qbpp::var_int("x") <= 10;
  auto y = 0 <= qbpp::var_int("y") <= 10;
  auto f = x + y == 10;
  auto g = 2 * x + 4 * y == 28;
  auto h = f + g;
  h.simplify_as_binary();
  auto solver = qbpp::exhaustive_solver::ExhaustiveSolver(h);
  auto sol = solver.search();
  std::cout << "sol = " << sol << std::endl;
  std::cout << "x = " << sol(x) << ", y = " << sol(y) << std::endl;
}

Compile the program

Compile test.cpp to generate the executable test:

g++ test.cpp -o test -std=c++17 -lqbpp -ltbb

This command creates an executable file named test. The compiler options mean the following:

-std=c++17: Use the C++17 standard.
-lqbpp: Link against the QUBO++ shared library.
-ltbb: Link against the oneTBB shared library.

Execute the program

Run test as follows:

./test
sol = 0:{{x[0],0},{x[1],1},{x[2],1},{x[3],0},{y[0],0},{y[1],0},{y[2],1},{y[3],0}}
x = 6, y = 4

Next steps

Activate the Anonymous Trial license or your license key. See Installation in Installation in QUBO++ Document.
Learn the basics of QUBO++. Start withBasics in QUBO++ Document.
Explore example QUBO++ programs in the Case Stidies

Windows (WSL)