Open Source

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 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.

Verifying your requirements

[New!] Use the SDV Installer: Starting from August 2025, we recommend using the SDV Installer to verify technical requirements, check your credentials, and easily download all the packages you have access to.

Start by installing the SDV Installer:

pip install sdv-installer --upgrade

If you have previously installed the SDV Installer, this same command will also update it.

Using the SDV Installer, run the check-requirements command to verify whether your current environment meets the technical requirements. 

sdv-installer check-requirements

This command prints whether your current environment passes or fails the check, as well as more information about your particular machine.

Verifying system requirements for SDV Enterprise ...

Operating system: macOS
OS Version: 14
Architecture: arm64
Python Version: 3.11.13
System bit: 64-bit
Pip version: 24.2

Result: Passed
Your system meets the technical requirements for SDV Enterprise.

If you are not able to install and use the SDV Installer on your machine, you can instead open up Python and manually run the code below.

Code for checking requirements

Open Python and run the code below.

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.

PreviousTechnical SupportNextInstallation Instructions

Last updated