System Requirements¶

A system with a configuration better than the minimum requirements is advised. Lower configurations may limit the number of supported qubits and reduce performance.

Supported Platforms¶

Operating Systems¶

The Quantum Rings SDK supports the following operating systems:

Windows 11 Pro
Windows 11 Pro with WSL2-based Linux installations
Debian GNU/Linux 12 (bookworm)
Ubuntu 22.04.4 LTS
OpenSUSE Tumbleweed
Oracle Linux 9.3
macOS Sequoia (CPU-only mode; official Python builds required)
Google Colab

Linux platforms must be compatible with manylinux_2_34_x86_64 and require glibc 2.34 or later.

CPU Architecture¶

64-bit x86 processors (Windows and Linux)
Intel or Apple Silicon CPUs (macOS)
NVIDIA GB10 Grace Blackwell Superchip

Python Versions¶

The SDK requires a 64-bit Python installation:

Python 3.11
Python 3.12
Python 3.13
Python 3.14

Minimum Requirements (CPU Mode)¶

32 GB installed physical memory
18 GB available physical memory (Actual memory usage depends on circuit size and operations.)
64-bit Python 3.11–3.14

macOS supports CPU-only mode using official Python builds from python.org.

NVIDIA GPU Requirements (GPU Mode)¶

Supported GPU architectures:

Ampere — compute capabilities 8.0, 8.6
Hopper — compute capability 9.0
Blackwell — compute capability 10.0 or later

Minimum GPU requirements:

Compute capability 8.0 or higher
At least 4 GB of GPU memory

Actual GPU memory requirements depend on the number of qubits and gate operations.

CUDA Runtime Requirements¶

Windows and Linux: CUDA Runtime 12.9 or 13.0
NVIDIA GB10 Grace Blackwell Superchip: CUDA Runtime 13.0

Performance Recommendations¶

For improved performance:

14 cores / 20 logical processors (or better)
32 GB or more system RAM
Higher-memory GPUs for larger circuits

For systems with limited GPU memory, hybrid execution modes (e.g., CPU + GPU backends such as serin_quantum_rings) may provide better results.