Skip to main content


Hyper API is available for Python, C++, Java and .NET supporting Windows, Mac and Linux each. Depending on the language, the installation can be complex. This page contains the detailed requirements and installation instructions for all languages.

Hardware requirements

The Hyper API only supports 64-bit platforms. It has the following minimum hardware requirements:

  • Intel Nehalem or AMD Bulldozer processor or newer
  • 2 GB memory
  • 1.5 GB minimum free disk space
Apple Silicon Support
If you are on Apple Silicon (Apple M1, Apple M2, ...), you will currently need workarounds, as described below.
Apple Silicon Workarounds

Hyper API runs on Apple Silicon only with [Rosetta 2]( instead of natively. You will have to install Rosetta 2 before installing Hyper API.

Furthermore, this means that Hyper API can only be used from within other x86 programs, running under Rosetta. In particular for Python and Java, this means that the Python interpreter/Java runtime needs to run with Rosetta, too.

To do so, either install the Intel-only version of the Python/Java interpreter, or prefix your call with arch -x86_64. E.g., for Python, you can use:

arch -x86_64 /usr/bin/python3 -m pip install tableauhyperapi
arch -x86_64 /usr/bin/python3

Supported platforms

  • macOS 10.13 or newer
  • Microsoft Windows 8 or newer (64-bit)
  • Microsoft Windows Server 2016, 2012, 2012 R2, 2008 R2, 2019
  • Ubuntu 18.04 LTS, 20.04 LTS and 22.04 LTS
  • Amazon Linux 2, Red Hat Enterprise Linux (RHEL) 7.3+ and 8.3+, CentOS 7.9+, Oracle Linux 7.3+

Language-specific Requirements

  • Python 3.8 (or newer) is required.
    • Install the 64-bit version (for example, for Windows, the download is listed as Windows x86-64).
    • On Windows, we recommend to select the option Add Python 3.x to PATH during installation.



The following instructions assume that you have set up a virtual environment for Python. For more information on creating virtual environments, see venv - Creation of virtual environments in the Python Standard Library.

  1. Open a terminal and navigate to the venv directory.

  2. Install the tableauhyperapi module using pip.

    pip install tableauhyperapi

    If you previously installed the tableauhyperapi, you can upgrade to the latest version using the following command.

    pip install --upgrade tableauhyperapi

    Linux installations require pip version 19.3 or newer. Note that pip versions 20.0 and 20.1 are not working because of issues with pip.

    Alternatively, you can download the Python Hyper API wheel package (.whl file) for your operating system. Use pip to install the .whl file you downloaded.

    • On Windows: Scripts\pip install [*path_to_whl_file*]
    • On Linux/macOS: bin/pip install [*path_to_whl_file*]
  3. Try out the examples:

    • Download the samples from Github.
    • Run the Python examples (for example, try
      • On Windows: [venv_directory]\Scripts\python hyper-api-samples\Tableau-Supported\Python\
      • On Linux/macOS: [venv_directory]/bin/python hyper-api-samples/Tableau-Supported/Python/