Installation

1. Install Julia

Install Julia language. 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

The open-source solver packages (e.g., Cbc, GLPK, Clp, etc.) will be automatically installed in step 2. While the commercial solver packages (e.g., Gurobi and CPLEX) should be installed by users (if needed) by following their instructions.

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