Install getML on macOS

This installation guide explains all necessary steps to install getML on macOS. To download the getML suite, go to

https://getml.com/product

and click the download button. This will download a disk image containing everything you need to use getML: The getML engine, the getML monitor, and the Python API.

System requirements

Your Mac should meet at least the following requirements to successfully install getML

  • macOS must be version 10.14 or newer. You can check your macOS version by running the following command in a terminal: sw_vers

  • Python 3.5 or above must be installed on your machine. Furthermore, numpy and pandas are required dependencies for the getML Python API.


Install and run the getML engine and monitor

The getML engine is the C++ backend of getML. It comes with a graphical user interface - the getML monitor - that runs in your browser. To install these components

  1. Double-click the dmg-file to open the installer, then drag the getML Icon into the Applications folder.

../../_images/install_mac.png
  1. Double-click getML.app in the Applications folder to start getML. A security feature in macOS will ask you to confirm that you want to open getML when launching it for the first time. After confirmation the getML icon in your status bar indicates that the getML engine is running.

../../_images/install_mac2.png
  1. Open a browser and visit http://localhost:1709/ (if opening the getML.app did not point you there automatically). You will see the login screen below. When installing getML for the first time select ‘Create a new account’.

    You will be forwarded to a registration form. Fill all required fields and hit the check button at the bottom to create a new account. By doing so you accept our terms of service, which can be found here.

../../_images/monitor_screen1.png
  1. Confirm your account using the confirmation e-mail that has been sent to you. Check the e-mail address you provided during registration and hit the orange button. Now, you should be able to log into the getML monitor. If this is not the case, please contact our support.

Install the getML Python API

The Python API is a convenient way to interact with and to control the getML engine. There are two options to install the getML Python API

From source

The source code of the Python API is shipped with the .dmg-file you downloaded too. Double-click it again and copy the Python folder to any location on your computer. Open a terminal, cd into that folder and run

python setup.py install

Install the getML-CLI

getML comes with a command-line interface (CLI) that lets you configure the most important parameters on startup. The CLI is a standalone Golang-binary. The CLI is optional. If you are fine with launching getML from your Launchpad, you can stop reading.

Before you can use the CLI, you have to have launched getML from your Launchpad at least once. This is because when you launch getML for the first time, it creates a hidden folder in your home directory (called .getML) into which it copies the binaries and all necessary resources. Said hidden folder is then accessed by the CLI.

After launching getML for the first time, you can find the CLI in $HOME/.getML/getml-VERSION.

./getml-cli

You can move getml-cli anywhere you want. We recommend moving the getml-cli to a location included in the PATH environment variable, such as /usr/local/bin. You can inspect the content of the aforementioned variable in a shell using

echo $PATH

and check if it can be properly found by executing

which getml-cli

If you see the location you moved the binary to as output, you are ready to go.

For further help on how to use the CLI, just use getml-cli -h or getml-cli -help:

Uninstall getML

To uninstall getML from your Mac

  1. Drag getml.app from your applications folder into the trash.

  2. Remove the folder .getML from your home directory. To do so, open your Finder and go to your home directory (Cmd + Shift + H). Hit Cmd + Shift + . to show the hidden files. Identify .getML and move it to the trash.

  3. Delete getml-cli from wherever you have put it (if you have decided to install getml-cli).

Where to go next

The Getting started guide provides an overview of the functionality of getML and a basic example of how to use the Python API. In order to get help or provide feedback, please contact our support.