#32: KaraboGui installation: Miniforge

In order to use Conda, three basic steps are needed:

  1. Install Conda (recommended conda installer). We use Miniforge, here.

  2. Configure channels.

  3. Install the KaraboGUI.

Install Conda

Download and install Miniforge (Python version >= 3)

  1. Download the installer script/executable.

    • Linux:

      Download and install by running

      curl -L -O "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname -m).sh"
      bash Miniforge3-$(uname)-$(uname -m).sh
      
    • Mac :

      Download the script and install by running

      bash Miniforge3-MacOSX-x86_64.sh
      
    • Windows:

      Download the installer

      Double-click on Miniforge3-Windows-x86_64.exe to run the installer.

  2. Follow the installation prompt. On Windows, remember to keep the “Create start menu shortcuts” option selected (by default, selected), in the final step.

  3. Open your terminal (Miniforge3 PowerShell on Windows or Bash on Linux and MacOS)

  4. If conda is in your path, you should be able to run

    conda –-version
    

    If it is not, you need to activate conda first

    • Linux/MacOS:

      source <miniforge_path>/etc/profile.d/conda.sh
      
    • Win:

      CALL <miniforge_path_path>/condabin/activate.bat
      

By default miniforge_path is on your home directory - ~/miniforge3 on Linux/Mac and on C:\Users\<YourUsername>\miniforge3 (or C:\Users\<YourUsername>\AppData\Local\miniforge3) on Windows.

Channel Configuration

If you have already installed karabogui on your machine using conda before, you could skip to the next step, as you may have already configured your channels correctly. Please ensure to remove the defaults channels.

conda config --remove channels defaults

Also ensure that karabo channels are added.

conda config --add channels http://exflctrl01.desy.de/karabo/channel
conda config --add channels http://exflctrl01.desy.de/karabo/channel/mirror/conda-forge

You can verify that the channels are added correctly, by running

conda config --show channels

and you will get

channels:
   - http://exflctrl01.desy.de/karabo/channel/mirror/conda-forge
   - http://exflctrl01.desy.de/karabo/channel
   - conda-forge

For more details for Karabo channels, refer to karabo documentation

Install KaraboGUI

To install the latest karabogui (recommended)

conda create -n karabogui_latest karabogui --yes

or install a specific version

conda create -n karabogui<version> karabogui=<version> --yes

For example:

conda create -n karabogui_2_20_7 karabogui=2.20.7 --yes