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

Extras opcionals

  • Acceleració CUDA (suport de GPU NVIDIA amb CudaBackend):

    pip install qilisdk[cuda]

Nota

El backend CUDA requereix una GPU amb acceleració CUDA disponible al vostre sistema i els controladors adequats instal·lats. Podeu trobar més informació al seu lloc web oficial: https://nvidia.github.io/cuda-quantum/latest/using/quick_start.html#install-cuda-q

  • Backend CPU de Qutip (simulació per CPU amb QutipBackend):

    pip install qilisdk[qutip]

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

    pip install qilisdk[speqtrum]

Podeu combinar extras:

pip install qilisdk[cuda,qutip,speqtrum]

Nota

QiliSDK requereix una versió de Python 3.11 o superior.

Requisits mínims del sistema operatiu:

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

El suport per a Windows és limitat, per la qual cosa recomanem usar WSL, que es pot instal·lar seguint aquesta guia. Amb això, hauríeu de seguir les instruccions de Linux a continuació. Si heu d’usar Windows pur, les instruccions de Windows a continuació haurien de funcionar, tot i que deshabiliten certes funcions del codi (especialment alguns bucles paral·lelitzats).

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>