Installation

1. Install Julia

Install Julia language. Julia 1.9 or later is required for the current HOPE package setup. A short video tutorial on how to download and install Julia is provided here.

2. Download HOPE repository

Clone or download the HOPE repository to your local directory - click the green "Code" button on the HOPE main page and choose "Download ZIP" (remember to change the folder name to HOPE after you decompress the zip file). You need to save the HOPE project in your home directory like: /yourpath/home/HOPE. image

3. Get model cases

Model cases are maintained in a separate repository: HOPEModelCases. Clone it into the ModelCases/ folder inside your HOPE directory:

git clone https://github.com/HOPE-Model-Project/HOPEModelCases /yourpath/home/HOPE/ModelCases

This is the recommended setup — HOPE will find the cases automatically with no extra configuration.

Alternative: If you prefer to store model cases in a different location, clone HOPEModelCases anywhere and set the HOPE_MODELCASES_PATH environment variable to that path before running HOPE:

  • Linux / macOS: export HOPE_MODELCASES_PATH=/path/to/HOPEModelCases
  • Windows (PowerShell): $env:HOPE_MODELCASES_PATH = "C:\path\to\HOPEModelCases"

4. Solver Packages

After cloning the repo, activate the HOPE project and install the default dependencies:

import Pkg
Pkg.activate(".")
Pkg.instantiate()

This installs HOPE together with the bundled open-source solvers, including HiGHS, Cbc, GLPK, and Clp.

Commercial solver packages such as Gurobi, SCIP, and CPLEX are not installed by Pkg.instantiate() by default. If needed, add them manually while the HOPE project is active:

import Pkg
Pkg.activate(".")
Pkg.add("Gurobi")   # or "SCIP" / "CPLEX"

When you do this from an active HOPE environment, the commercial solver package is added to the HOPE project environment, not just Julia's global default environment.

pkg> add https://github.com/HOPE-Model-Project/HOPE