Installation Procedure for CPU only Mode

Select this procedure if your system does not have a compatible NVIDIA GPU or if you do not intend to use the GPU. If you are using the NVIDIA GB10 Grace Blackwell Superchip, you can install the SDK in CPU or GPU mode. If you choose to install in the GPU-enabled mode, please refer to the installation procedure for GPUs Installation Procedure for GPU Enabled Mode

Microsoft Windows

The Quantum Rings SDK can be installed directly using pip. Many users find Anaconda (https://www.anaconda.com/) a good way to install the Quantum Rings SDK and use the Python environment efficiently on Windows. From Anaconda, select Python 3.11 or a later channel of your choice and launch CMD.exe Prompt to go to the Command prompt and execute the following command.

pip install QuantumRingsLib

or

pip install quantumrings[cpu]

If you do not have a Python channel, select Environments from the left panel, + Create button from the menu bar at the bottom and select Python 3.11, 3.12, 3.13, or 3.14 from the Create New Environment dialog.

Quantum Rings SDK requires a 64-bit version of Python 3.11, 3,12, 3,13, or 3.14.

After installation of the SDK, launch the Python environment by selecting the installed channel, before running your code.

Note

If, in case, pip is not able to find the latest version, please try the following command instead:

pip install –extra-index-url https://pypi.python.org/pypi QuantumRingsLib

You may have to restart the system in some installations for the SDK to be recognized.

macOS Sequoia or later

Install Python 3.13 (or Python 3.11, 3.12, 3.14) by downloading it from the Python Organization (https://www.python.org/downloads/macos/). Other methods of installing Python are not supported at this time. From the terminal, create a Python 3.13 virtual environment by executing the following command. Activate the environment.

python3.13 -m venv myenv
source myenv/bin/activate

Then execute the following command to install the SDK.

pip install QuantumRingsLib

or

pip install quantumrings[cpu]

You may also refer to https://docs.python.org/3/using/mac.html for further help. If you have a Python version that came with a previous version of macOS and uninstalled it, you may have broken symlinks. Refer to section 5.5.1 on this webpage for hints on fixing the symlinks.

Note

Currently, we do not support Conda based Python installations or other methods of installing Python due to ABI incompatibility. Support may be added in the future. At this time, Python downloaded from the official site http://www.python.org is only supported.

Google Colab

Open a notebook and execute the following command from a code cell.

pip install QuantumRingsLib

or

pip install quantumrings[cpu]

Restart the kernel. You are ready to go!

Linux or GB10

Checking whether your Linux platform is supported

There are several variants of the Linux OS, with varying levels of inbuilt libraries. At present, we are supporting manylinux_2_34_x86_64 platforms based on 64 bit x86 processors. Older platforms and other CPUs are not supported at the moment. If you have a specific requirement, please contact our technical support.

To check whether your platform is supported, execute the following command from Python command line:

import platform
platform.platform()

Watch for the glibc signature at the end. glibc2.34 and above are only supported.

Installing Python and creating the virtual environment

Note

Update all packages in your system using the following commands. Note that, this may cause incompatibilities in some installations due to variances in packages and their mutual dependencies. Besides, this step might break existing software packages and make your system unusable. You may refer to your operating system’s manual or seek help from your system adminstrator. Alternatively, you can also use the Software Updater GUI tool, if that was packaged along with your system distribution.

sudo apt update        # Fetches the list of available updates
sudo apt upgrade       # Installs some updates; does not remove packages

Note

Note that apt command is not available in some Linux variants. You may have to use dnf on Oracle Linux distributions and zypper on Open SUSE distributions.

Check whether your system has Python installed by executing python from the terminal. If not, you can install Python using the following command.

sudo apt install python3.13

Create a virtual Python 3.13 environment and activate the environment using the following steps.

virtualenv --python=/usr/bin/python3.13 myenv
source myenv/bin/activate

You may have to install virtualenv package if it is not already installed. When not required, you can deactivate the environment using deactivate command.

Note that, virtualenv package is not available on Oracle Linux and Open SUSE Linux. You can use the following command equivalently on these distributions:

python3.11 -m venv myenv
source myenv/bin/activate

Installing Jupyter notebook

Note

Jupyter notebook requires GUI support and an internet browser. Some platforms do not support them readily.

Now, launch the virtual environment, and execute the following command:

sudo su
source myenv/bin/activate
pip install notebook

Ensuring that jupyter notebook launches the correct python version

Check whether your virtual environment launches the correct python version by executing the command python –version. On some installations you may have to execute the following commands to ensure that the Jupyter notebook launches the correct python version.

python -m pip install ipykernel
python -m ipykernel install --user

Now, you can launch the Jupyter notebook using the command jupyter-notebook or jupyter notebook. If you are logged in as root, then you may have to append –allow-root to the command. Once the notebook server starts, you can click the local-host link to launch the notebook on the browser.

Installing Curl

On some installations, we found that curl is not installed. You can check whether curl is installed on your system by executing the command curl from the terminal. If curl is not installed, you may use the following command:

sudo apt install curl

Installing gcc

On some installations, we got libgomp.so not found error and it required installation of gcc, as follows:

zypper install gcc

Finally, installing the Quantum Rings SDK

Now, you can install the Quantum Rings SDK as follows:

pip install QuantumRingsLib

or

pip install quantumrings[cpu]