Installer Qiskit

Que tu travailles en local ou dans un environnement cloud, la première étape pour tous les utilisateurs est d'installer Qiskit.

Installer le SDK Qiskit

1. Installe Python. Consulte la section « Programming Language » sur la page du projet Qiskit sur PyPI pour savoir quelles versions de Python sont prises en charge par la version la plus récente. Pour les instructions de téléchargement, consulte le Guide de démarrage Python.

   Il est recommandé d'utiliser des environnements virtuels Python pour isoler Qiskit des autres applications.

   remarque

   Ces instructions utilisent la distribution Python standard de pypi.org. Tu peux toutefois utiliser d'autres distributions Python, comme Anaconda ou miniconda, ainsi que d'autres gestionnaires de dépendances tels que Poetry.

   Si tu débutes avec les environnements virtuels, clique ici pour en savoir plus.

   Un environnement virtuel Python est un espace isolé pour travailler avec Python dans un but précis — tu peux y installer les paquets que tu souhaites, configurer des bibliothèques, des dépendances, etc., sans affecter l'environnement Python « de base » de ta machine.

   Un avantage important d'un environnement virtuel est que si ton environnement Python se retrouve corrompu, tu peux simplement supprimer l'environnement virtuel et repartir de zéro !

   Choisis un emplacement où stocker les informations relatives à tes environnements virtuels. En général, ils sont stockés dans un répertoire nommé .venv à l'intérieur de chaque répertoire de projet.

   D'abord, navigue vers le répertoire de ton projet et crée un environnement minimal avec uniquement Python d'installé.

   macOS

   python3 -m venv .venv

   Linux

   python3 -m venv .venv

   Windows

   python -m venv .venv

   Ensuite, active ton nouvel environnement.

   macOS

   source .venv/bin/activate

   Linux

   source .venv/bin/activate

   Windows

   Si tu utilises PowerShell :

   .venv\Scripts\Activate.ps1

   Si tu utilises Git Bash :

   source .venv/scripts/activate

   Si tu utilises l'invite de commandes :

   .venv\Scripts\activate

2. Installe pip s'il n'est pas déjà installé dans ton environnement. Pip est un gestionnaire de paquets Python que tu utilises pour installer Qiskit et d'autres paquets Python. Utilise pip list pour voir ce qui se trouve dans ton environnement virtuel. Dans la plupart des environnements Python, pip est déjà installé.

3. Installe le SDK Qiskit.

   pip install qiskit

   Ajouter la prise en charge de la visualisation

   Si tu comptes utiliser les fonctionnalités de visualisation ou des notebooks Jupyter, installe également le module qiskit.visualization. Consulte la référence de l'API Visualizations pour plus d'informations.

1. Si tu veux exécuter un notebook Jupyter avec les paquets Qiskit que tu viens d'installer, tu dois installer Jupyter dans ton environnement.

   pip install jupyter

   Puis ouvre ton notebook comme suit :

   jupyter notebook <path/to/notebook.ipynb>

Si tu prévois de travailler en local et d'utiliser les simulateurs intégrés à Qiskit, ton installation est terminée. Si tu veux exécuter des tâches sur des QPU IBM®, continue vers la configuration de ton compte IBM Cloud®.

Rester à jour avec les dernières versions

Consulte régulièrement les notes de version de Qiskit pour découvrir les nouvelles versions. Nous recommandons de mettre fréquemment à jour tes dépendances pour qiskit en exécutant pip install -U qiskit.

Dépannage

Erreur No Module 'qiskit' dans Jupyter Notebook

Si tu as utilisé pip install qiskit et configuré ton environnement virtuel dans Anaconda, tu pourrais obtenir l'erreur No Module 'qiskit' quand tu lances un tutoriel dans Jupyter Notebook. Si tu n'as pas encore installé Qiskit ou configuré ton environnement virtuel, tu peux suivre les étapes d'installation.

Cette erreur survient quand on essaie d'importer le paquet Qiskit dans un environnement où Qiskit n'est pas installé. Si tu as lancé Jupyter Notebook depuis Anaconda-Navigator, il est possible que Jupyter Notebook s'exécute dans l'environnement de base (root) plutôt que dans ton environnement virtuel. Choisis un environnement virtuel dans Anaconda-Navigator via le menu déroulant Applications on. Dans ce menu, tu peux voir tous les environnements virtuels disponibles dans Anaconda, et tu peux sélectionner l'environnement où Qiskit est installé pour lancer Jupyter Notebook.

Erreurs de compilation pendant l'installation

Qiskit dépend d'un certain nombre d'autres paquets Python open source, qui sont automatiquement installés lors du pip install qiskit. Selon la plateforme de ton système et la version de Python, il est possible qu'un paquet particulier ne propose pas de binaires précompilés pour ton système. Tu peux consulter Systèmes d'exploitation pris en charge pour une liste des plateformes prises en charge par Qiskit, dont certaines peuvent nécessiter un compilateur supplémentaire. Dans les cas où il n'y a pas de binaires précompilés disponibles, pip tentera de compiler le paquet depuis les sources, ce qui peut nécessiter des dépendances supplémentaires à installer manuellement.

Si la sortie de pip install qiskit contient des lignes similaires à :

Failed building wheel for SOME_PACKAGE
...
build/temp.linux-x86_64-3.5/_openssl.c:498:30: fatal error
compilation terminated.
error: command 'x86_64-linux-gnu-gcc' failed with exit status 1

consulte la documentation du paquet qui a échoué à s'installer (dans l'exemple, SOME_PACKAGE) pour savoir comment installer les bibliothèques nécessaires à la compilation depuis les sources.

Systèmes d'exploitation pris en charge

Qiskit s'efforce de prendre en charge le plus grand nombre de systèmes d'exploitation possible, mais en raison des limitations des ressources de test disponibles et de la disponibilité des systèmes d'exploitation, tous ne peuvent pas être pris en charge. La prise en charge des systèmes d'exploitation pour Qiskit est répartie en trois niveaux, avec un degré de prise en charge différent pour chaque niveau. Pour les plateformes hors de ces niveaux, comme FreeBSD ou WebAssembly (WASI), Qiskit reste peut-être installable, mais il n'est pas testé et tu devras le compiler (et probablement ses dépendances) depuis les sources.

De plus, Qiskit ne prend en charge que l'implémentation CPython du langage Python. L'exécution avec d'autres interpréteurs Python tels que PyPy n'est pas prise en charge.

Qiskit v2.x

Dans la série de versions Qiskit v2.x, les plateformes prises en charge sont :

Niveau 1

Les systèmes d'exploitation de niveau 1 sont entièrement testés dans le cadre du processus de développement pour s'assurer que toute modification proposée fonctionnera correctement. Des binaires précompilés sont construits, testés et publiés sur PyPI dans le cadre du processus de publication. En règle générale, tant qu'un environnement Python fonctionnel est installé, Qiskit peut être installé sur ces systèmes sans avoir à installer de dépendances supplémentaires.

Systèmes d'exploitation de niveau 1 :

• Linux x86_64 (distributions compatibles avec la spécification de packaging manylinux 2014).

• macOS ARM64 (11.0 ou version ultérieure)

• Windows 64 bits (Windows 10 et versions ultérieures prises en charge)

• Linux AArch64 (distributions compatibles avec la spécification de packaging manylinux 2014)

Niveau 2

Les systèmes d'exploitation de niveau 2 ne sont pas testés dans le cadre du processus de développement. Cependant, des binaires précompilés sont construits, testés et publiés sur PyPI dans le cadre du processus de publication, et ces paquets peuvent normalement être installés avec seulement un environnement Python fonctionnel. Il peut y avoir un délai dans la publication des paquets pour ces systèmes, car les échecs de test risquent de n'être détectés que bien plus tard, et les échecs lors de la publication ne bloqueront pas la publication pour les systèmes de niveau 1.

Systèmes d'exploitation de niveau 2 :

• macOS x86_64 (10.12 ou version ultérieure)

Niveau 3

Les systèmes d'exploitation de niveau 3 ne sont pas testés dans le cadre du processus de développement. Des binaires précompilés sont construits et publiés sur PyPI dans le cadre du processus de publication, mais ne sont pas testés. Ils peuvent ne pas être installables avec un simple environnement Python fonctionnel et peuvent nécessiter un compilateur C/C++ ou des programmes supplémentaires pour compiler les dépendances depuis les sources lors de l'installation. La prise en charge de ces systèmes d'exploitation est assurée sans garantie (au mieux).

Systèmes d'exploitation de niveau 3 :

• Linux ppc64le (distributions compatibles avec la spécification de packaging manylinux 2014)

• Linux s390x (distributions compatibles avec la spécification de packaging manylinux 2014)

À partir de Qiskit v2.0.0, seules les plateformes 64 bits sont prises en charge ; les plateformes 32 bits ne le sont plus. Tu ne pourras pas non plus compiler depuis les sources sur des plateformes 32 bits, car le code Rust interne de Qiskit suppose une largeur de pointeur 64 bits.

Prochaines étapes

Recommandations

• Configure Qiskit en local.

• Suis les étapes du guide Exécute ton premier circuit sur du matériel pour écrire et exécuter un programme quantique.

• Essaie un tutoriel IBM Quantum Learning.

• Comprends la politique de prise en charge des versions.