Download & installation

    Install GAMS MIRO Desktop

    Note:

    To be able to solve models in GAMS MIRO, GAMS 30.2 or later is required. You can download the latest GAMS version here.

    GAMS MIRO Desktop itself is open source software. In order for GAMS to interact with MIRO, the MIRO connector is required, which is included in the GAMS system from GAMS version 30.2. Without a valid license, the connector has limitations on the number of indexed symbols that can be communicated with MIRO. A maximum of 10 indexed symbols can be included in $on/offExternalInput and $on/offExternalOutput.

    Note:

    To be able to solve models in GAMS MIRO, GAMSPy 0.12 or later is required.

    Both GAMS MIRO Desktop and GAMSPy are open source software.

    Please check the release notes.

    Download for Windows
    SHA-256 hash: e66107fec8351ffc387938ee1026136842ba37be2528caa0b0570976ad7fa953

    By downloading this software, you agree to the License Agreement.

    Installation

    To install GAMS MIRO and its components, download the latest version and run the setup, which will guide you through the installation process. Make sure that no MIRO application is running during this time.

    Download for macOS (Apple silicon)
    SHA-256 hash: 4f3808501244f901783c70c661add4dd2449504b4f0fafbc6757da2de6efcc5c
    Download for macOS (x86_64)
    SHA-256 hash: 52b84447ecd3e2e27f790bed8fce2ada7b35d54d856a26f0112ca53d52e815a0

    By downloading this software, you agree to the License Agreement.

    Installation

    To install GAMS MIRO and its components, download the latest version.

    Download for Linux
    SHA-256 hash: e690cd6bd1507d3f113f7c63680a35189df6e9cf325ccc21c4a21d26b71db51a

    By downloading this software, you agree to the License Agreement.

    Installation

    1. In case a current R version (4.0 or later) is not yet installed on your system, you need to do this first. You can download R here.
    2. For MIRO to work, compilers as well as the system libraries libpng and libcurl need to be installed. On Debian / Ubuntu you need libcurl4-gnutls-dev and libpng-dev, on Fedora use libcurl-devel and libpng-devel. For example, to install both libraries on Ubuntu, run:
      > sudo apt install libcurl4-gnutls-dev libpng-dev
      If there are no compilers installed on your system yet, we recommend installing build tools via: > sudo apt install build-essential on Ubuntu or: > sudo dnf groupinstall "Development Tools" on Fedora.
    3. The first time you launch the GAMS MIRO AppImage, some R packages need to be installed. They are installed either at the R installation path: rPath/miro-library or in the user's home directory ($XDG_CONFIG_HOME/miro-library or ~/.config/miro-library) depending on whether MIRO was installed for all users or only for the current user. You will be guided through this installation process.
    Note:

    For a complete system integration of the MIRO AppImage (e.g. file associations and custom URL schemes), please install the AppImage via the AppImageLauncher.

    GAMS MIRO workspace

    The workspace is the place where deployed apps are stored and cached and logs are written. The MIRO database with all user scenarios is also located there. Furthermore all user settings and additional R packages are kept in the workspace.

    On all platforms, the MIRO workspace is located at ~/.miro. On MacOS and Linux, ~ is resolved to: $HOME, on Windows to %USERPROFILE%.

    Uninstall GAMS MIRO

    To uninstall the software, please follow the default procedure of your operating system. The uninstaller only deletes the data in the directory where GAMS MIRO was installed. On Windows you will be asked if you also want to permanently delete the MIRO database with all your settings. This refers to data in the MIRO workspace. If you agree, the entire directory will be deleted. On both MacOS and Linux systems, the MIRO workspace is not deleted. To remove the data permanently, you have to do this manually.

    Demo applications

    We provide some GAMS MIRO demo applications. You can use these to get to know some of MIRO's basic features. To run the sample applications, you must first extract them. More about this here.

    GAMS MIRO Server

    Note:

    Currently, GAMS MIRO Server is only available for MIRO applications based on GAMS models, not for GAMSPy models.

    Like GAMS MIRO Desktop, GAMS MIRO Server is open source software. However, the setup requires the use of GAMS Engine for the model calculations, which must be purchased separately.

    Detailed installation instructions and further information on administrative aspects can be found here.

    GAMS MIRO Server