Skip to main content
IBM Quantum Platform

Installer Qiskit

Que vous travailliez localement ou dans un environnement cloud, la première étape pour tous les utilisateurs est d'installer Qiskit.

Installez l' Qiskit SDK

  1. Installez python. Consultez la section « Langage de programmation » sur la page du projet Qiskit PyPI pour savoir quelles versions d' Python s sont prises en charge par la dernière version. Pour savoir comment télécharger le logiciel, consultez le guide du débutant d' Python.

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

    Note

    Ces instructions utilisent la distribution standard Python de pypi.org. Cependant, vous pouvez utiliser d'autres distributions Python, telles qu' Anaconda ou miniconda, ainsi que d'autres flux de gestion des dépendances comme Poetry.

    • Un environnement virtuel Python est un espace isolé permettant de travailler avec Python dans un but spécifique. Vous pouvez ainsi installer tous les paquets que vous souhaitez et configurer les bibliothèques, les dépendances, etc. sans affecter l'environnement Python "de base" sur votre machine.

      L'un des principaux avantages d'un environnement virtuel est que si votre environnement Python est corrompu en cours de route, vous pouvez facilement supprimer l'environnement virtuel et recommencer!

      Choisissez un emplacement privilégié pour stocker les informations relatives à vos environnements virtuels. En général, ils sont stockés dans un répertoire nommé .venv dans chaque répertoire de projet dans lequel vous travaillez.

    Tout d'abord, accédez au répertoire de votre projet et créez un environnement minimal dans lequel seul Python est installé.

    python3 -m venv .venv

    Ensuite, activez votre nouvel environnement.

    source .venv/bin/activate

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

  3. Installez l' Qiskit SDK

    pip install qiskit
    Ajouter la prise en charge de la visualisation

    Si vous avez l'intention d'utiliser la fonctionnalité de visualisation ou les notebooks Jupyter, installez également le qiskit.visualization module. Pour plus d'informations, consultez la référence API Visualisations.

  1. Si vous souhaitez exécuter un carnet Jupyter avec les paquets Qiskit que vous venez d'installer, vous devez installer Jupyter dans votre environnement.

    pip install jupyter

    Ouvrez ensuite votre carnet de notes comme suit :

    jupyter notebook <path/to/notebook.ipynb>

Si vous prévoyez de travailler en local et d'utiliser les simulateurs intégrés à Qiskit, votre installation est terminée. Si vous souhaitez exécuter des tâches sur les QPU d' IBM®, poursuivez la procédure pour configurer votre compte IBM Cloud®.

Rester à jour avec les dernières versions

Consultez régulièrement les notes de mise à jour de Qiskit pour découvrir les nouvelles versions. Nous vous recommandons de mettre régulièrement à jour vos paramètres en qiskit exécutant pip install -U qiskit.

Traitement des incidents

  • Si vous avez utilisé pip install qiskit et configuré votre environnement virtuel dans Anaconda, il se peut que vous obteniez l'erreur No Module 'qiskit' lorsque vous exécutez un didacticiel dans Jupyter Notebook. Si vous n'avez pas installé Qiskit ou configuré votre environnement virtuel, vous pouvez suivre les étapes d'installation environnement virtuel, vous pouvez suivre les étapes d' installation.

    L'erreur se produit lorsque l'on essaie d'importer le paquet Qiskit dans un environnement où Qiskit n'est pas installé dans un environnement où Qiskit n'est pas installé. Si vous avez lancé Jupyter Notebook à partir de l'Anaconda Navigator, il est possible que Jupyter Notebook s'exécute dans l'environnement de base (root) au lieu de s'exécuter dans votre environnement virtuel dans l'environnement de base (root), au lieu de votre environnement virtuel virtuel. Choisissez un environnement virtuel dans Anaconda- Navigator à partir du menu déroulant Applications sur le menu déroulant. Dans ce menu, vous pouvez voir tous les environnements virtuels au sein d'Anaconda, et vous pouvez sélectionner l'environnement dans lequel Qiskit est installé pour lancer Jupyter Notebook.

  • Qiskit dépend d'un certain nombre d'autres paquets open-source Python, qui sont automatiquement installés lorsque l'on fait sont automatiquement installés lors de l'installation de pip install qiskit. En fonction de la plate-forme et de la version de votre système la plate-forme de votre système et la version de Python, il est possible qu'un paquet particulier ne fournisse pas de binaires préconstruits pour votre système ne fournisse pas de binaires préconstruits pour votre système. Vous pouvez vous référer au support du système d'exploitation pour une liste des plateformes supportées par Qiskit, dont certaines peuvent nécessiter un compilateur supplémentaire dont certaines peuvent nécessiter un compilateur supplémentaire. Dans les cas où il n'y a pas de binaires précompilés disponibles, tentera de compiler le paquet pas de binaires précompilés disponibles, pip tentera de compiler le paquet à partir des sources, ce qui peut nécessiter des dépendances supplémentaires à partir des sources, ce qui peut nécessiter des dépendances supplémentaires à installer manuellement être installées 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

    veuillez consulter la documentation du paquetage dont l'installation a échoué (dans l'exemple de code, ) pour savoir comment installer les bibliothèques exemple, SOME_PACKAGE) pour obtenir des informations sur l'installation des bibliothèques nécessaires à la compilation à partir des 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 les systèmes d'exploitation ne peuvent pas être pris en charge. Le support des systèmes d'exploitation pour Qiskit est divisé en trois niveaux avec différents niveaux de support pour chaque niveau. Pour les plates-formes autres que celles-ci, telles que FreeBSD ou WebAssembly (WASI), Qiskit peut encore être installé, mais il n'est pas testé et vous devrez construire Qiskit (et probablement les dépendances de Qiskit) à partir des sources.

En outre, Qiskit ne prend en charge que l'implémentation CPython du langage Python. L'exécution avec d'autres interprètes Python tels que PyPy n'est pas possible.

Qiskit v2.x

Dans la série de versions de Qiskit v2.x, les plates-formes prises en charge sont les suivantes :

  • Les systèmes d'exploitation de niveau 1 sont entièrement testés dans le cadre des processus de développement afin de garantir que tout changement proposé fonctionnera correctement. Les binaires précompilés sont construits, testés et publiés sur PyPI dans le cadre du processus de publication. Généralement, tant qu'un environnement Python fonctionne, Qiskit peut être installé sur ces systèmes d'exploitation sans qu'il soit nécessaire d'installer d'autres dépendances.

    Systèmes d'exploitation de niveau 1 :

    • Linux x86_64 (distributions compatibles avec la spécification d'empaquetage manylinux 2014 ).
    • macOS ARM64 ( 11.0 ou plus récent)
    • Windows 64 bits (Windows 10 et versions ultérieures prises en charge)
    • Linux AArch64 (distributions compatibles avec la spécification d'empaquetage manylinux 2014 )

  • Les systèmes d'exploitation de niveau 2 ne sont pas testés dans le cadre du processus de développement. Cependant, les binaires précompilés sont créés, testés et publiés sur PyPI dans le cadre du processus de publication, et ces paquets peuvent être installés avec un environnement Python fonctionnel. La publication des paquets pour ces systèmes pourrait être retardée, car les échecs des tests pourraient ne pas être détectés avant longtemps, et les échecs lors de la publication n'empêcheront pas la publication du paquet pour les systèmes de niveau 1.

    Systèmes d'exploitation de niveau 2 :

    • macOS x86_64 ( 10.12 ou plus récent)

  • Les systèmes d'exploitation de niveau 3 ne sont pas testés dans le cadre du processus de développement. Les 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 seulement un environnement Python fonctionnel et peuvent nécessiter un compilateur C/C++ ou des programmes supplémentaires pour construire les dépendances à partir des sources dans le cadre du processus d'installation. La prise en charge de ces systèmes d'exploitation n'est possible que dans la mesure du possible.

    Systèmes d'exploitation de niveau 3 :

A partir de Qiskit v2.0.0, seules les plateformes 64-bit sont supportées et les plateformes 32-bit ne sont pas supportées. Vous ne pourrez pas non plus construire à partir des sources sur les plateformes 32 bits, car le code Qiskit Rust suppose une largeur de pointeur de 64 bits.

Etapes suivantes

Recommandations
Cette page a-t-elle été utile ?
Signaler un bogue, une coquille ou proposer du contenu sur GitHub.