Installation instructions#

This guide will help you set up Tumult Analytics Pro on your local machine.

Prerequisites#

Tumult Analytics Pro is built in Python, so a Python installation is required to use it. It is compatible with Python 3.9 through 3.11, and has experimental support for Python 3.12. Because Tumult Analytics uses PySpark for computation, it also requires Java 8 or 11, or Java 17 if PySpark 3.4 or later is used. Java 21 is not currently supported.

Tumult Analytics supports the x86_64 processor architecture, as well as Apple silicon.

Below are instructions for installing these prerequisites on several common platforms. If none of these apply to you, install Python 3 and Java from your OS package manager or manually, then proceed with the pip installation. If you encounter any issues during the installation process, please let us know!

Linux (Debian-based)

Python and pip, Python’s package manager, are likely already installed. If they are not, install them with:

apt install python3.11 python3-pip

Java may already be installed as well. If it is not, install the Java Runtime Environment with:

apt install openjdk-17-jre-headless

Note that some newer releases, for example Ubuntu 24.04, default to Java 21. Java 21 is not supported by Spark or by Tumult Analytics, so on such systems you may need to explicitly install an older Java version and configure it to be the default using update-alternatives.

Linux (Red Hat-based)

Python and pip, Python’s package manager, may already be installed. On some releases, Python 2 may be installed by default, but not Python 3. To install Python 3, run:

yum install python3.11 python3-pip

To install Java, run:

yum install java-1.8.0-openjdk-headless

Note that despite the package name, this will install Java 8.

macOS

The below instructions assume the use of Homebrew for managing packages. If you do not already have Homebrew, it can be installed with:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Python may be installed with:

brew install python@3.11

And Java may be installed with:

brew install openjdk@11

For the system Java wrappers to find this JDK you may need to symlink it by following the instructions that Homebrew provides upon installation. The command will look similar to the following, but will differ depending on your CPU architecture:

sudo ln -sfn /opt/homebrew/opt/openjdk@11/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-11.jdk

If you have more than one Java version installed on your system, use Java 11 by setting JAVA_HOME to $(/usr/libexec/java_home -v11). This can be done by, for example, adding export JAVA_HOME=$(/usr/libexec/java_home -v11) to .bashrc and then restarting your shell.

Windows

The only supported way to install Tumult Analytics Pro on Windows is using the Windows Subsystem for Linux (WSL). Once you have installed your preferred Linux distribution with WSL, follow the corresponding Linux installation instructions to get Tumult Analytics set up.

Installation#

Once the above prerequisites are installed, Tumult Analytics Pro can be installed using pip3 with the below command.

Note

This command uses a INDEX_URL variable. Please reach out to Tumult at support@tmlt.io and we will provide you with one.

INDEX_URL=<Insert Tumult provided URL>
pip3 install tmlt.analytics-pro --index-url $INDEX_URL

This will automatically install all of its Python dependencies as well.

Note

If you already have Tumult Analytics installed on your machine, it will not interact well with Tumult Analytics Pro. We recommend you either:

Install Tumult Analytics Pro in a new virtual environment to minimize interactions with your system Python environment.
Uninstall Tumult Analytics before install Tumult Analytics Pro, using
python3 -m pip uninstall tmlt.analytics

Once installed, you will need to download the attached license file onto your machine, for example to ~/.config/tmlt/analytics-pro-license.json. Then, set your TMLT_ANALYTICS_PRO_LICENSE environment variable to the path where you saved the license file. This can be done by, for example, adding export TMLT_ANALYTICS_PRO_LICENSE="~/.config/tmlt/analytics-pro-license.json" to ~/.bashrc for Bash or to ~/.zshrc for Zsh. You will likely need to restart any IDEs or other development tools so they can pick up the environment variable.

If you are unable to set environment variables for any reason, you can instead configure the license path programmatically via the tmlt.cfg.analytics.license_file_path_override variable.

Optional: checking your installation#

Once you’ve installed Tumult Analytics Pro, you can run this command to check that basic functionality works:

python3 -c "from tmlt.analytics.utils import check_installation; check_installation()"

If Tumult Analytics Pro has been installed correctly, this command should finish successfully.