Technical Requirements

If you are installing the SDV Enterprise edition for the first time in a new environment, it's important to check that your environment can support the software.

Supported Platforms

You can install and use SDV Enterprise on your Linux, Windows, or MacOS machine provided that it supports the requirements listed below.

Linux

✅ Linux is supported on any combination of the variants

Requirement	Supported Variants
Operating System	Linux
Linux Kernel Version	5.10+
Linux Distribution	Debian GNU/Linux (11 "Bullseye" or 12 "Bookworm") Ubuntu (22.04 "Jammy Jellyfish" or 24.04 "Noble Numbat")
Architecture	x86_64 (Intel), or aarch64*
Python Version	3.8-3.13
System Bit	64-bit
Pip Version	22.3+

A + indicates that higher versions are also acceptable *Due to an ongoing issue with GitHub, we are not able to support the aarch64 architecture until later in 2025.

Windows

✅ Windows is supported on any combination of the variants

Requirement	Supported Variants
Operating System	Windows
Windows Version	10.0.10240+ (aka Windows 10 or Windows 11)
Architecture	win-amd64 (64bit Windows on AMD64, aka x86_64, Intel64, and EM64T)
Python Version	3.8.6+, 3.9-3.13
System Bit	64-bit
Pip Version	22.3+

A + indicates that higher versions are also acceptable

macOS

✅ macOS (aka darwin) is supported on any combination of the variants

Requirement	Supported Variants
Operating System	macOS
macOS Version	11, 12, 13, 14, or 15 (AKA Big Sur, Monterey, Ventura, Sonoma or Sequoia)
Architecture	arm64 (M-chips) or x86_64 (Intel)*
Python Version	3.8-3.13
System Bit	64-bit
Pip Version	22.3+

A + indicates that higher versions are also acceptable

*Older Macs with Intel chips may run into trouble when running neural network-based synthesizers such as CTGAN. For more info, see Troubleshooting.

Verifying your requirements

Not sure if your environments meets the requirements? Open Python and run the code below to print out details about your environment.

import pip
import platform
import sys
import subprocess
import sysconfig
import re

os_version = platform.version()
os_system = platform.system()
linux_distro = None
is_linux = sys.platform == 'linux'

if sys.platform == 'darwin':
    os_version = subprocess.check_output(['sw_vers', '-productVersion']).strip().decode('utf-8')
    os_system = 'macOS'
if is_linux:
    os_version = platform.release()

    linux_distro = subprocess.run("cat /etc/*-release", shell=True, capture_output=True, text=True)
    linux_distro = linux_distro.stdout.strip()
    distro_name_match = re.search(r'PRETTY_NAME="(.*)"', linux_distro)
    if distro_name_match:
        linux_distro = distro_name_match.group(1)

is_64bits = sys.maxsize > 2**32
bit = "64-bit" if is_64bits else "32-bit"

if platform.system().lower() == "windows":
    arch = sysconfig.get_platform()
else:
    arch = subprocess.check_output(['uname', '-m'], text=True).strip().lower()
print(f'Operating System: {os_system}')

if is_linux:
    os_system += ' Kernel'
print(f'{os_system} Version: {os_version}')

if is_linux:
    print(f'Linux Distribution: {linux_distro}')

print(f'Architecture: {arch}')
print(f'Python Version: {platform.python_version()}')
print(f'System Bit: {bit}')
print(f'pip Version: {pip.__version__}')

print(f'\nAdditional Information For Troubleshooting')
platform_tag = sysconfig.get_platform()
platform_tag = platform_tag.replace('-', '_').replace('.', '_')
print(f'Processor: {platform.processor()}')
print(f'Platform Tag: {platform_tag}')

This will print out your system's configuration, plus some additional information that may help with troubleshooting. For example:

Operating System: macOS
macOS Version: 13.5.2
Architecture: arm64
Python Version: 3.11.11
System Bit: 64-bit
pip Version: 24.2

Additional information for troubleshooting:
Processor: arm
Platform Tag: macosx_11_1_arm64

Check these items with the requirements listed above.

FAQ

What can I do if my environment doesn't meet the technical requirements?

We have aimed to keep our requirements broad, covering a vast majority of environments while still providing a great experience. If your native environment does not support the requirements, we recommend setting up a new virtual environment that meets them.

Unfortunately, the SDV Enterprise cannot be installed in custom environments. Our requirements are designed to support synthetic data features in a way that is secure, efficient, and easy to debug. Since the SDV software is built within the broader Python ecosystem, we must also adhere to certain industry standards –

• Python Version: The Python organization determines which versions of Python are active. Older versions of Python are not maintained, which can lead to bugs and security vulnerabilities over time. For more information, see the official status of Python versions.
• Architecture: A 64-bit architecture provides fast processing speeds, which is important for software that analyzes large quantities of data. Older, 32-bit processors are no longer supported by popular data science libraries such as PyTorch. The SDV relies on these libraries for the latest deep learning models.
• Pip Version: Pip is used to check the versions and compatibility of all the Python packages in your environment. Its algorithm for resolving dependencies is consistently improving. If you have an older version of pip, it may not be possible to check for compatibility and install new libraries.

If you have any follow up questions, please start a discussion in Discourse.