Instalación

QiliSDK y sus extras opcionales se distribuyen a través de PyPI. Use pip para instalar el paquete principal, más cualquier módulo adicional que necesite.

Paquete base

pip install qilisdk

Extras opcionales

  • 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 (envío a la nube a través de speqtrum):

    pip install qilisdk[speqtrum]

Puede combinar extras:

pip install qilisdk[cuda,qutip,speqtrum]

Nota

QiliSDK requiere una versión 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 desde el código fuente

El método anterior instalará los binarios precompilados de QiliSDK de la versión más reciente. Si desea obtener las características más nuevas (aquellas en las que aún estamos trabajando), puede compilar la biblioteca desde el código fuente, pero tenga en cuenta que esto no se recomienda para la mayoría de los usuarios, y no garantizamos que el código más reciente sea 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).

Primero, asegúrese de tener instalados Python, pip, git, cmake y un compilador de C++:

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

Instale uv globalmente con:

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

Luego, clone (es decir, descargue) y acceda al repositorio:

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

Cree un nuevo entorno virtual usando uv:

uv venv

Luego active el entorno:

source .venv/bin/activate

Para instalar QiliSDK en este nuevo entorno, ejecute:

uv sync

Si desea instalar con extras, puede ejecutar lo siguiente, ajustando según sea necesario:

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

Entonces tendrá un entorno con la última versión de QiliSDK instalada. Si desea instalar otras cosas en el entorno, necesitará usar pip con uv:

uv pip install <package_name>

Y para ejecutar un script de Python dentro del entorno, puede usar:

uv run python3 <script_name.py>