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

  • Aceleración CUDA (soporte de GPU NVIDIA con CudaBackend):

    pip install qilisdk[cuda]

Nota

El backend CUDA requiere una GPU con aceleración CUDA disponible en su sistema y los controladores adecuados instalados. Puede encontrar más información en su sitio web oficial: https://nvidia.github.io/cuda-quantum/latest/using/quick_start.html#install-cuda-q

  • Backend CPU de Qutip (simulación por CPU con 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.

Requisitos mínimos del sistema operativo:

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

El soporte para Windows es limitado, por lo que recomendamos usar WSL, que se puede instalar según esta guía. Con esto, debería seguir las instrucciones de Linux a continuación. Si debe usar Windows puro, las instrucciones de Windows a continuación deberían funcionar, aunque deshabilitan ciertas funciones del código (especialmente algunos bucles paralelizados).

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>