Installer Qiskit

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

Mise à niveau de Qiskit 0.x vers Qiskit 1.0 et au-delà

(Si tu installes Qiskit pour la première fois, passe directement à la section Installer et configurer. Cette remarque ne concerne que les utilisateurs ayant déjà installé Qiskit.)

Pour ceux qui mettent à niveau de la version 0.x vers 1.0 ou ultérieure : note que Qiskit v1.0 utilise une nouvelle structure de paquets, donc tu ne peux pas utiliser pip install -U qiskit pour passer de n'importe quelle version Qiskit 0.x à 1.0.

Consulte le guide de migration Qiskit 1.0 pour les détails et les instructions.

Les futures mises à jour à partir de Qiskit 1.0 permettront des mises à niveau en place.

Installer le SDK Qiskit et le client Qiskit Runtime

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, voir 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écouvres les environnements virtuels, clique ici pour plus d'informations.
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 le supprimer et recommencer !
Choisis un emplacement pour stocker 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
- Linux
- Windows
python3 -m venv .venv
python3 -m venv .venv
python -m venv .venv
Ensuite, active ton nouvel environnement.
- macOS
- Linux
- Windows
source .venv/bin/activate
source .venv/bin/activate
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
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é.
Installe le SDK Qiskit. Si tu prévois d'exécuter des tâches sur du matériel quantique, installe aussi Qiskit Runtime.
```
pip install qiskit
```
```
pip install qiskit-ibm-runtime
```
Ajouter le support de 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.

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 et les notes de version de Qiskit Runtime pour découvrir les nouvelles versions. Nous recommandons de mettre fréquemment à jour tes dépendances pour qiskit et qiskit-ibm-runtime, par exemple en modifiant les versions dans requirements.txt vers les dernières versions, puis en exécutant pip install -r requirements.txt ou la commande appropriée à ton gestionnaire de dépendances.

Besoin d'aide ? Essaie de demander à Qiskit Code Assistant.

Dépannage

Erreur « No Module 'qiskit' » avec 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 lors de 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 Support des systèmes d'exploitation 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.

Support des systèmes d'exploitation

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. Le support des systèmes d'exploitation pour Qiskit est divisé en trois niveaux avec différents degrés de support pour chaque niveau. Pour les plateformes hors de ces niveaux, comme FreeBSD ou WebAssembly (WASI), Qiskit peut être installable, mais n'est pas testé et tu devras compiler Qiskit (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 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 peuvent ne pas être détectés avant 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 seul 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. Le support de ces systèmes d'exploitation est fourni sur la base du meilleur effort.

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.

Qiskit v1.x

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

Niveau 1

Systèmes d'exploitation de niveau 1 :

Linux x86_64 (distributions compatibles avec la spécification de packaging manylinux 2014).
macOS x86_64 (10.12 ou version ultérieure)
macOS ARM64 (11.0 ou version ultérieure)
Windows 64 bits (Windows 10 et versions ultérieures prises en charge)

Niveau 2

Systèmes d'exploitation de niveau 2 :

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

Niveau 3

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)
Linux i686 (distributions compatibles avec la spécification de packaging manylinux 2014)
Windows 10 32 bits

Prochaines étapes

Recommandations

Configure ton compte IBM Cloud.
Configure Qiskit en local.
Suis les étapes dans Hello world pour écrire et exécuter un programme quantique.
Essaie un tutoriel IBM Quantum Learning.

Installer le SDK Qiskit et le client Qiskit Runtime​

Dépannage​

Support des systèmes d'exploitation​

Qiskit v2.x​

Qiskit v1.x​

Prochaines étapes​