Skip to main content
IBM Quantum Platform

Qiskit installieren

Egal, ob Sie lokal oder in einer Cloud-Umgebung arbeiten, der erste Schritt für alle Benutzer ist die Installation von Qiskit.

Installieren Sie den „ Qiskit SDK “

  1. Installieren Sie Python. Informieren Sie sich im Abschnitt „Programmiersprache“ auf der Qiskit-Projektseite unter PyPI, welche Versionen von „ Python “ von der neuesten Version unterstützt werden. Anweisungen zum Herunterladen finden Sie im Einsteigerhandbuch zu „ Python “.

    Es wird empfohlen, dass Sie Python virtuelle Umgebungen verwenden, um Qiskit von anderen Anwendungen zu trennen.

    Note

    Diese Anleitung verwendet die Standardverteilung Python von pypi.org. Sie können jedoch auch andere Python -Distributionen wie Anaconda oder miniconda zusammen mit anderen Abhängigkeitsmanagement-Workflows wie Poetry verwenden.

    • Eine virtuelle Python Umgebung ist ein isolierter Bereich, um mit Python für einen bestimmten Zweck zu arbeiten - so können Sie beliebige Pakete installieren und Bibliotheken, Abhängigkeiten usw. einrichten, ohne die "Basis"-Umgebung Python auf Ihrem Rechner zu beeinflussen.

      Ein wichtiger Vorteil einer virtuellen Umgebung ist, dass Sie die virtuelle Umgebung einfach löschen und neu beginnen können, wenn Ihre Python Umgebung irgendwann beschädigt wird!

      Wählen Sie einen bevorzugten Speicherort für die Informationen über Ihre virtuellen Umgebungen. Normalerweise werden sie in einem Verzeichnis namens .venv in jedem Projektverzeichnis gespeichert, in dem Sie arbeiten.

    Navigieren Sie zunächst zu Ihrem Projektverzeichnis und erstellen Sie eine minimale Umgebung, in der nur Python installiert ist.

    python3 -m venv .venv

    Als nächstes aktivieren Sie Ihre neue Umgebung.

    source .venv/bin/activate

  2. Installieren Sie pip, wenn es nicht bereits in Ihrer Umgebung installiert ist. Pip ist ein Python Paketmanager, mit dem Sie Qiskit und andere Python Pakete installieren können. Verwenden Sie pip list , um zu sehen, was sich in Ihrer virtuellen Umgebung befindet. In den meisten Umgebungen von Python ist pip bereits installiert.

  3. Installieren Sie das „ Qiskit SDK “.

    pip install qiskit
    Visualisierungsunterstützung hinzufügen

    Wenn Sie Visualisierungsfunktionen oder Jupyter-Notebooks verwenden möchten, installieren Sie auch das qiskit.visualization Modul. Weitere Informationen finden Sie in der Referenz zur Visualisierungs-API.

  1. Wenn Sie ein Jupyter-Notebook mit den soeben installierten Qiskit-Paketen ausführen möchten, müssen Sie Jupyter in Ihrer Umgebung installieren.

    pip install jupyter

    Öffnen Sie dann Ihr Notizbuch wie folgt:

    jupyter notebook <path/to/notebook.ipynb>

Wenn Sie vorhaben, lokal zu arbeiten und die in Qiskit integrierten Simulatoren zu nutzen, ist Ihre Installation abgeschlossen. Wenn Sie Jobs auf den QPUs von „ IBM® “ ausführen möchten, fahren Sie fort, um Ihr „ IBM Cloud® “-Konto einzurichten.

Bleiben Sie mit den neuesten Versionen auf dem Laufenden

Schauen Sie regelmäßig in den Qiskit-Versionshinweisen nach, um sich über neue Versionen zu informieren. Wir empfehlen, Ihre Anforderungen regelmäßig zu aktualisieren, qiskit indem Sie das Programm ausführen pip install -U qiskit.

Fehlerbehebung

  • Wenn Sie pip install qiskit verwendet und Ihre virtuelle Umgebung in Anaconda eingerichtet haben, erhalten Sie möglicherweise die Fehlermeldung No Module 'qiskit' , wenn Sie ein Lernprogramm in Jupyter Notebook ausführen. Wenn Sie Qiskit noch nicht installiert haben oder Ihre virtuelle Umgebung eingerichtet haben, können Sie den Installationsschritten folgen.

    Der Fehler tritt auf, wenn Sie versuchen, das Qiskit-Paket in einer Umgebung zu importieren umgebung zu importieren, in der Qiskit nicht installiert ist. Wenn Sie das Programm Jupyter Notebook von der Anaconda- Navigator gestartet haben, ist es möglich, dass Jupyter Notebook in der Basisumgebung (root) läuft, anstatt in Ihrer virtuellen umgebung. Wählen Sie eine virtuelle Umgebung in der Anaconda- Navigator aus dem Anwendungen auf Dropdown-Menü. In diesem Menü sehen Sie alle virtuellen Umgebungen innerhalb von Anaconda, und Sie können die Umgebung auswählen, in der Sie Qiskit installiert haben, um Jupyter Notebook zu starten.

  • Qiskit hängt von einer Reihe anderer Open-Source-Pakete Python ab, die automatisch installiert werden, wenn Sie pip install qiskit ausführen. Abhängig von der Plattform Ihres Systems und der Version Python ist es möglich, dass ein bestimmtes paket keine vorkompilierten Binärdateien für Ihr System bereitstellt. Sie können unter betriebssystemunterstützung finden Sie eine Liste der von Qiskit unterstützten Plattformen, von denen einige von denen einige möglicherweise einen zusätzlichen Compiler benötigen. In den Fällen, in denen es keine vorkompilierten Binärdateien verfügbar sind, wird pip versuchen, das Paket aus dem Quellcode zu kompilieren aus dem Quellcode zu kompilieren, was wiederum einige zusätzliche Abhängigkeiten erfordern kann, die manuell installiert werden müssen.

    Wenn die Ausgabe von pip install qiskit ähnliche Zeilen wie diese enthält:

    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

    sehen Sie bitte in der Dokumentation des Pakets nach, das nicht installiert werden konnte (im beispielcode, SOME_PACKAGE), um zu erfahren, wie Sie die Bibliotheken installieren die für die Kompilierung aus dem Quellcode benötigt werden.

Betriebssystemunterstützung

Qiskit ist bestrebt, so viele Betriebssysteme wie möglich zu unterstützen, aber aufgrund von Einschränkungen bei den verfügbaren Testressourcen und der Verfügbarkeit von Betriebssystemen können nicht alle Betriebssysteme unterstützt werden. Die Betriebssystemunterstützung für Qiskit ist in drei Stufen unterteilt, wobei jede Stufe unterschiedlich gut unterstützt wird. Für andere Plattformen, wie z.B. FreeBSD oder WebAssembly (WASI), kann Qiskit zwar installiert werden, aber es ist nicht getestet und Sie müssen Qiskit (und wahrscheinlich auch die Abhängigkeiten von Qiskit) aus dem Quellcode erstellen.

Außerdem unterstützt Qiskit nur die CPython-Implementierung der Sprache Python. Die Ausführung mit anderen Python Interpretern wie PyPy wird nicht unterstützt.

Qiskit- v2.x

In der Versionsreihe Qiskit v2.x werden die folgenden Plattformen unterstützt:

  • Tier-1-Betriebssysteme werden im Rahmen der Entwicklungsprozesse umfassend getestet, um sicherzustellen, dass alle vorgeschlagenen Änderungen korrekt funktionieren. Vorkompilierte Binärdateien werden erstellt, getestet und als Teil des Veröffentlichungsprozesses auf PyPI veröffentlicht. Solange eine funktionierende Python Umgebung installiert ist, kann Qiskit in der Regel auf diesen Betriebssystemen installiert werden, ohne dass weitere Abhängigkeiten installiert werden müssen.

    Tier-1-Betriebssysteme:

  • Tier-2-Betriebssysteme werden im Rahmen des Entwicklungsprozesses nicht getestet. Vorkompilierte Binärdateien werden jedoch im Rahmen des Release-Prozesses erstellt, getestet und unter PyPI veröffentlicht. Diese Pakete können voraussichtlich mit einer funktionierenden Python -Umgebung installiert werden. Es kann zu Verzögerungen bei der Veröffentlichung von Paketen für diese Systeme kommen, da Testfehler möglicherweise erst viel später erkannt werden und Fehler während der Veröffentlichung die Veröffentlichung des Pakets für Tier-1-Systeme nicht blockieren.

    Tier-2-Betriebssysteme:

    • macOS x86_64 ( 10.12 oder später)

  • Tier-3-Betriebssysteme werden nicht im Rahmen des Entwicklungsprozesses getestet. Vorkompilierte Binärdateien werden als Teil des Veröffentlichungsprozesses erstellt und auf PyPI veröffentlicht, aber nicht getestet. Sie können möglicherweise nicht nur mit einer funktionierenden Python Umgebung installiert werden und erfordern möglicherweise einen C/C++ Compiler oder zusätzliche Programme, um die Abhängigkeiten als Teil des Installationsprozesses aus dem Quellcode zu erstellen. Die Unterstützung für diese Betriebssysteme erfolgt nur nach bestem Wissen und Gewissen.

    Tier 3 Betriebssysteme:

Ab Qiskit v2.0.0 werden nur 64-Bit-Plattformen unterstützt, 32-Bit-Plattformen werden nicht unterstützt. Sie werden nicht in der Lage sein, aus dem Quellcode zu bauen auf 32-Bit-Plattformen zu erstellen, da der Qiskit-Rust-Code intern von einer 64-Bit-Zeigerbreite ausgeht.

Nächste Schritte

Empfehlungen
War diese Seite hilfreich?
Melden Sie auf GitHub einen Fehler, einen Tippfehler oder fordern Sie Inhalte an.