Install BRAHMS

Go to the download page, select your platform, and download the setup for the latest version. Double-click the downloaded file, or run it from the shell prompt (you may need to make it executable on some platforms). Install to the default folder.

C:\Program Files\SystemML

The installation consists of this folder, plus the single environment variable SYSTEMML_INSTALL_PATH. Where you see this variable in the documentation, you should replace it with your install path. Also, the folder SYSTEMML_INSTALL_PATH/BRAHMS/bin is placed on your machine PATH.

  • BRAHMS will run from any folder, so change the install path if you like.
  • It is recommended that you restart your machine after installing BRAHMS. However, in most case, BRAHMS will work without a restart.
  • We have seen problems on some *nix operating systems interpreting the tilde "~" if you use it to indicate your home path in SYSTEMML_INSTALL_PATH. It is recommended that you set your home path explicitly.

If that does not work...

If the setup will not run on your platform, download the binaries package, and proceed as follows:

  • Unzip to the chosen install folder
  • Set the environment variable SYSTEMML_INSTALL_PATH manually - the folder it specifies should contain the folders "BRAHMS" and "Namespace" (see Environment Variables for help)
  • Add SYSTEMML_INSTALL_PATH/BRAHMS/bin to your PATH (see Environment Variables for help)


Open a command prompt (terminal) and enter brahms. If BRAHMS is correctly installed, the output should look something like this:

OS Shell Prompt
BRAHMS Version ... Copyright (C) 2007-2011 Ben Mitchinson BRAHMS comes with ABSOLUTELY NO WARRANTY. This is free software, and you are welcome to redistribute it under certain conditions. For details, type "brahms --license", and/or visit us at Usage: brahms <exefile> [<option> ...] brahms <operation> [<option> ...] ...

If that does not work...
  • Check that your PATH is set correctly - it must include the path to SYSTEMML_INSTALL_PATH/BRAHMS/bin.
  • Restart your machine.
  • If a message indicates that some required library is missing, find the library and add its location to the Environment Variable PATH (Windows) or LD_LIBRARY_PATH (Linux).
  • If you think there is a compatibility problem with your platform, the last option is to build from source.