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

{% tabs %}
{% tab title="Linux" %}
:white\_check\_mark: Linux is supported on any combination of the variants

<table><thead><tr><th width="219.5">Requirement</th><th width="411.5">Supported Variants</th></tr></thead><tbody><tr><td>Operating System</td><td><code>Linux</code></td></tr><tr><td>Linux Kernel Version</td><td><code>5.10+</code></td></tr><tr><td>Linux Distribution</td><td><p>Debian GNU/Linux (11 "Bullseye" or 12 "Bookworm")</p><p>Ubuntu (22.04 "Jammy Jellyfish" or 24.04 "Noble Numbat")</p></td></tr><tr><td>Architecture</td><td><code>x86_64</code> (Intel), or <code>aarch64</code>*</td></tr><tr><td>Python Version**</td><td><code>3.9-3.14</code><br></td></tr><tr><td>System Bit</td><td><code>64-bit</code></td></tr><tr><td>Pip Version</td><td><code>22.3+</code> </td></tr></tbody></table>

&#x20;*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.*\
*\*\*Python 3.14 is not currently available for the AI Connectors and SDV Agent bundles. Support for these bundles is coming soon.*
{% endtab %}

{% tab title="Windows" %}
:white\_check\_mark: Windows is supported on any combination of the variants

<table><thead><tr><th width="217.5">Requirement</th><th width="400.5">Supported Variants</th></tr></thead><tbody><tr><td>Operating System</td><td><code>Windows</code></td></tr><tr><td>Windows Version</td><td><code>10.0.10240+</code> (aka Windows 10 or Windows 11)</td></tr><tr><td>Architecture</td><td><code>win-amd64</code> (64bit Windows on AMD64, aka x86_64, Intel64, and EM64T) </td></tr><tr><td>Python Version**</td><td><code>3.9-3.14</code></td></tr><tr><td>System Bit</td><td><code>64-bit</code></td></tr><tr><td>Pip Version</td><td><code>22.3+</code></td></tr></tbody></table>

*A `+` indicates that higher versions are also acceptable*\
*\*\*Python 3.14 is not currently available for the AI Connectors and SDV Agent bundles. Support for these bundles is coming soon.*
{% endtab %}

{% tab title="macOS" %}
:white\_check\_mark: macOS (aka `darwin`) is supported on any combination of the variants

<table><thead><tr><th width="212.5">Requirement</th><th width="364.5">Supported Variants</th></tr></thead><tbody><tr><td>Operating System</td><td><code>macOS</code></td></tr><tr><td>macOS Version</td><td><code>11+</code><br>(AKA Big Sur or anything after that)</td></tr><tr><td>Architecture</td><td><code>arm64</code> (M-chips) or <code>x86_64</code> (Intel)*</td></tr><tr><td>Python Version**</td><td><code>3.9-3.14</code></td></tr><tr><td>System Bit</td><td><code>64-bit</code></td></tr><tr><td>Pip Version</td><td><code>22.3+</code></td></tr></tbody></table>

*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***](https://docs.sdv.dev/sdv-enterprise/installation/troubleshooting)*.* \
*\*\*Python 3.14 is not currently available for the AI Connectors and SDV Agent bundles. Support for these bundles is coming soon.*
{% endtab %}
{% endtabs %}

## Verifying your requirements

{% hint style="info" %}
**Use the SDV Installer**: 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.*
{% endhint %}

Using the SDV Installer, run the `check-requirements` command to verify whether your current environment meets the technical requirements.&#x20;

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

<details>

<summary>Code for checking requirements</summary>

Open Python and run the code below.

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

</details>

## FAQ

<details>

<summary>What can I do if my environment doesn't meet the technical requirements?</summary>

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.&#x20;

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](https://devguide.python.org/versions/#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](https://pytorch.org/docs/stable/notes/windows.html#package-not-found-in-win-32-channel). 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](https://discourse.sdv.dev/).

</details>