Instal·lació

QiliSDK i els seus extras opcionals es distribueixen a través de PyPI. Useu pip per instal·lar el paquet principal, més qualsevol mòdul addicional que necessiteu.

Paquet base

pip install qilisdk

Extres opcionals

  • CUDA acceleration (NVIDIA GPU support with CudaBackend):

    pip install qilisdk[cuda]

Nota

The CUDA backend requires a CUDA accelerated GPU to be available on your system and proper drivers to be installed. More information can be found on their official website: https://nvidia.github.io/cuda-quantum/latest/using/quick_start.html#install-cuda-q

  • Qutip CPU backend (CPU simulation with QutipBackend):

    pip install qilisdk[qutip]

  • SpeQtrum (enviament al núvol via speqtrum):

    pip install qilisdk[speqtrum]

Podeu combinar extres:

pip install qilisdk[cuda,qutip,speqtrum]

Nota

QiliSDK requereix una versió de Python 3.11 o superior.

Minimum OS requiremnets:

  • Linux: Ubuntu 22.04 o superior

  • Windows: Windows 11 o superior

  • MacOS: MacOS 14 o superior

Compilar des del codi font

El mètode anterior instal·larà els binaris precompilats de QiliSDK de la versió més recent. Si voleu obtenir les característiques més noves (aquelles en les quals encara estem treballant), podeu compilar la biblioteca des del codi font, però tingueu en compte que això no es recomana per a la majoria d’usuaris, i no garantim que el codi més recent sigui estable.

Support for Windows is limited, so we recommend using WSL, which can be installed as per this guide. With this you should then following the Linux instructions below. If you must use pure Windows, the Windows instructions below should work, although they disable certain code features (notably some parallelized loops).

Primer, assegureu-vos de tenir instal·lats Python, pip, git, cmake i un compilador de C++:

sudo apt update
sudo apt install python3 python3-pip git build-essential

Instal·leu uv globalment amb:

curl -LsSf https://astral.sh/uv/install.sh | sh

Després, cloneu (és a dir, descarregueu) i accediu al repositori:

git clone https://github.com/qilimanjaro-tech/qilisdk
cd qilisdk

Creeu un nou entorn virtual usant uv:

uv venv

Després activeu l’entorn:

source .venv/bin/activate

Per instal·lar QiliSDK en aquest nou entorn, executeu:

uv sync

Si voleu instal·lar amb extras, podeu executar el següent, ajustant segons calgui:

uv sync --extra cuda13 --extra qutip --extra speqtrum

Llavors tindreu un entorn amb la darrera versió de QiliSDK instal·lada. Si voleu instal·lar altres coses a l’entorn, haureu d’usar pip amb uv:

uv pip install <package_name>

I per executar un script de Python dins de l’entorn, podeu usar:

uv run python3 <script_name.py>