Pasang Qiskit

Sama ada anda bekerja secara tempatan atau dalam persekitaran awan, langkah pertama bagi semua pengguna ialah memasang Qiskit.

Naik taraf dari Qiskit 0.x ke Qiskit 1.0 dan ke atas

(Jika anda memasang Qiskit buat kali pertama, langkau ke bahagian Pasang dan sediakan. Notis ini hanya berkaitan untuk pengguna yang telah memasang Qiskit sebelum ini.)

Bagi mereka yang menaik taraf dari versi 0.x ke 1.0 atau lebih baru: perhatikan bahawa kerana Qiskit v1.0 menggunakan struktur pembungkusan baharu, anda tidak boleh menggunakan pip install -U qiskit untuk menaik taraf dari mana-mana versi Qiskit 0.x ke 1.0.

Lihat panduan migrasi Qiskit 1.0 untuk butiran dan arahan.

Kemas kini masa hadapan bermula dengan Qiskit 1.0 akan membenarkan naik taraf secara langsung.

Pasang Qiskit SDK dan klien Qiskit Runtime

1. Pasang Python. Semak bahagian "Programming Language" di halaman projek Qiskit PyPI untuk menentukan versi Python yang disokong oleh keluaran terkini. Untuk arahan muat turun, lihat Panduan Pemula Python.

   Adalah disyorkan anda menggunakan persekitaran maya Python untuk mengasingkan Qiskit daripada aplikasi lain.

   nota

   Arahan ini menggunakan pengedaran Python standard dari pypi.org. Walau bagaimanapun, anda boleh menggunakan pengedaran Python lain, seperti Anaconda atau miniconda, bersama aliran kerja pengurusan pergantungan lain seperti Poetry.

   Jika anda baharu kepada persekitaran maya, klik di sini untuk maklumat lanjut.

   Persekitaran Python maya ialah ruang terpencil untuk bekerja dengan Python bagi tujuan tertentu — jadi anda boleh memasang apa sahaja pakej yang anda mahu, dan menyediakan pustaka, pergantungan, dan sebagainya, tanpa menjejaskan persekitaran Python "asas" pada mesin anda.

   Satu kelebihan penting persekitaran maya ialah jika persekitaran Python anda rosak di suatu ketika, anda boleh dengan mudah memadam persekitaran maya dan bermula semula!

   Pilih lokasi pilihan untuk menyimpan maklumat tentang persekitaran maya anda. Biasanya ia disimpan dalam direktori bernama .venv dalam setiap direktori projek yang anda kerjakan.

   Pertama, navigasi ke direktori projek anda dan cipta persekitaran minimal yang hanya mengandungi Python.

   macOS

   python3 -m venv .venv

   Linux

   python3 -m venv .venv

   Windows

   python -m venv .venv

   Seterusnya, aktifkan persekitaran baharu anda.

   macOS

   source .venv/bin/activate

   Linux

   source .venv/bin/activate

   Windows

   Jika menggunakan PowerShell:

   .venv\Scripts\Activate.ps1

   Jika menggunakan Git Bash:

   source .venv/scripts/activate

   Jika menggunakan command prompt:

   .venv\Scripts\activate

2. Pasang pip jika ia belum dipasang dalam persekitaran anda. Pip ialah pengurus pakej Python yang anda gunakan untuk memasang Qiskit dan pakej Python lain. Gunakan pip list untuk melihat apa yang ada dalam persekitaran maya anda. Dalam kebanyakan persekitaran Python, pip sudah dipasang.

3. Pasang Qiskit SDK. Jika anda merancang untuk menjalankan kerja pada perkakasan kuantum, pasang juga Qiskit Runtime.

   pip install qiskit

   pip install qiskit-ibm-runtime

   Tambah sokongan visualisasi

   Jika anda ingin menggunakan fungsi visualisasi atau buku nota Jupyter, pasang juga modul qiskit.visualization. Lihat rujukan API Visualisasi untuk maklumat lanjut.

1. Jika anda ingin menjalankan buku nota Jupyter dengan pakej Qiskit yang baru dipasang, anda perlu memasang Jupyter dalam persekitaran anda.

   pip install jupyter

   Kemudian buka buku nota anda seperti berikut:

   jupyter notebook <path/to/notebook.ipynb>

Jika anda merancang untuk bekerja secara tempatan dan menggunakan simulator yang dibina dalam Qiskit, maka pemasangan anda sudah selesai. Jika anda ingin menjalankan kerja pada QPU IBM, teruskan ke sediakan akaun IBM Cloud anda.

Kekal terkini dengan versi terbaharu

Semak secara berkala nota keluaran Qiskit dan nota keluaran Qiskit Runtime untuk melihat keluaran baharu. Kami mengesyorkan anda kerap mengemaskini keperluan untuk qiskit dan qiskit-ibm-runtime, contohnya dengan menukar versi dalam requirements.txt kepada versi terbaharu, kemudian jalankan pip install -r requirements.txt atau arahan yang sesuai untuk aliran kerja pengurusan pergantungan anda.

Perlukan bantuan? Cuba tanya Qiskit Code Assistant.

Penyelesaian masalah

Ralat "No Module 'qiskit'" dengan Jupyter Notebook

Jika anda menggunakan pip install qiskit dan menyediakan persekitaran maya anda dalam Anaconda, anda mungkin mendapat ralat No Module 'qiskit' apabila menjalankan tutorial dalam Jupyter Notebook. Jika anda belum memasang Qiskit atau menyediakan persekitaran maya, anda boleh mengikuti langkah pemasangan.

Ralat ini disebabkan apabila cuba mengimport pakej Qiskit dalam persekitaran di mana Qiskit tidak dipasang. Jika anda melancarkan Jupyter Notebook dari Anaconda-Navigator, ada kemungkinan Jupyter Notebook sedang berjalan dalam persekitaran asas (root), bukannya dalam persekitaran maya anda. Pilih persekitaran maya dalam Anaconda-Navigator dari menu lungsur Applications on. Dalam menu ini, anda boleh melihat semua persekitaran maya dalam Anaconda, dan anda boleh memilih persekitaran di mana Qiskit dipasang untuk melancarkan Jupyter Notebook.

Ralat penyusunan semasa pemasangan

Qiskit bergantung pada beberapa pakej Python sumber terbuka lain, yang dipasang secara automatik apabila melakukan pip install qiskit. Bergantung pada platform dan versi Python sistem anda, ada kemungkinan pakej tertentu tidak menyediakan binari pra-bina untuk sistem anda. Anda boleh merujuk Sokongan sistem pengendalian untuk senarai platform yang disokong oleh Qiskit, yang sesetengahnya mungkin memerlukan pengkompil tambahan. Dalam kes di mana tiada binari pra-kompil tersedia, pip akan cuba mengkompil pakej dari sumber, yang seterusnya mungkin memerlukan beberapa pergantungan tambahan yang perlu dipasang secara manual.

Jika output pip install qiskit mengandungi baris yang serupa dengan:

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

sila semak dokumentasi pakej yang gagal dipasang (dalam kod contoh, SOME_PACKAGE) untuk maklumat tentang cara memasang pustaka yang diperlukan untuk penyusunan dari sumber.

Sokongan sistem pengendalian

Qiskit berusaha untuk menyokong sebanyak mungkin sistem pengendalian, tetapi disebabkan keterbatasan dalam sumber ujian yang tersedia dan ketersediaan sistem pengendalian, tidak semua sistem pengendalian boleh disokong. Sokongan sistem pengendalian untuk Qiskit dibahagikan kepada tiga peringkat dengan tahap sokongan yang berbeza untuk setiap peringkat. Untuk platform di luar ini, seperti FreeBSD atau WebAssembly (WASI), Qiskit mungkin masih boleh dipasang, tetapi ia tidak diuji dan anda perlu membina Qiskit (dan kemungkinan pergantungan Qiskit) dari sumber.

Selain itu, Qiskit hanya menyokong implementasi CPython bahasa Python. Menjalankan dengan penterjemah Python lain seperti PyPy tidak disokong.

Qiskit v2.x

Dalam siri keluaran Qiskit v2.x, platform yang disokong adalah:

Peringkat 1

Sistem pengendalian Peringkat 1 diuji sepenuhnya sebagai sebahagian daripada proses pembangunan untuk memastikan sebarang perubahan yang dicadangkan akan berfungsi dengan betul. Binari pra-kompil dibina, diuji, dan diterbitkan ke PyPI sebagai sebahagian daripada proses keluaran. Biasanya, selagi ada persekitaran Python yang berfungsi dipasang, Qiskit boleh dipasang pada sistem pengendalian ini tanpa perlu memasang pergantungan lanjutan.

Sistem pengendalian Peringkat 1:

• Linux x86_64 (pengedaran yang serasi dengan spesifikasi pembungkusan manylinux 2014).
• macOS ARM64 (11.0 atau lebih baharu)
• Windows 64-bit (Windows 10 dan ke atas disokong)
• Linux AArch64 (pengedaran yang serasi dengan spesifikasi pembungkusan manylinux 2014)

Peringkat 2

Sistem pengendalian Peringkat 2 tidak diuji sebagai sebahagian daripada proses pembangunan. Walau bagaimanapun, binari pra-kompil dibina, diuji, dan diterbitkan ke PyPI sebagai sebahagian daripada proses keluaran, dan pakej ini boleh dijangka dipasang dengan hanya persekitaran Python yang berfungsi. Mungkin ada kelewatan dalam mengeluarkan pakej untuk sistem ini, kerana kegagalan ujian mungkin tidak dikesan sehingga jauh kemudian, dan kegagalan semasa penerbitan tidak akan menghalang penerbitan pakej untuk sistem Peringkat 1.

Sistem pengendalian Peringkat 2:

• macOS x86_64 (10.12 atau lebih baru)

Peringkat 3

Sistem pengendalian Peringkat 3 tidak diuji sebagai sebahagian daripada proses pembangunan. Binari pra-kompil dibina dan diterbitkan ke PyPI sebagai sebahagian daripada proses keluaran tetapi tidak diuji. Mereka mungkin tidak boleh dipasang dengan hanya persekitaran Python yang berfungsi dan mungkin memerlukan pengkompil C/C++ atau program tambahan untuk membina pergantungan dari sumber sebagai sebahagian daripada proses pemasangan. Sokongan untuk sistem pengendalian ini adalah atas dasar usaha terbaik sahaja.

Sistem pengendalian Peringkat 3:

• Linux ppc64le (pengedaran yang serasi dengan spesifikasi pembungkusan manylinux 2014)
• Linux s390x (pengedaran yang serasi dengan spesifikasi pembungkusan manylinux 2014)

Bermula dalam Qiskit v2.0.0, hanya platform 64-bit yang disokong dan platform 32-bit tidak disokong. Anda juga tidak akan dapat membina dari sumber pada platform 32-bit, kerana secara dalaman kod Rust Qiskit mengandaikan lebar penunjuk 64-bit.

Qiskit v1.x

Dalam siri keluaran Qiskit v1.x, platform yang disokong adalah:

Peringkat 1

Sistem pengendalian Peringkat 1 diuji sepenuhnya sebagai sebahagian daripada proses pembangunan untuk memastikan sebarang perubahan yang dicadangkan akan berfungsi dengan betul. Binari pra-kompil dibina, diuji, dan diterbitkan ke PyPI sebagai sebahagian daripada proses keluaran. Biasanya, selagi ada persekitaran Python yang berfungsi dipasang, Qiskit boleh dipasang pada sistem pengendalian ini tanpa perlu memasang pergantungan lanjutan.

Sistem pengendalian Peringkat 1:

• Linux x86_64 (pengedaran yang serasi dengan spesifikasi pembungkusan manylinux 2014).
• macOS x86_64 (10.12 atau lebih baru)
• macOS ARM64 (11.0 atau lebih baharu)
• Windows 64-bit (Windows 10 dan ke atas disokong)

Peringkat 2

Sistem pengendalian Peringkat 2 tidak diuji sebagai sebahagian daripada proses pembangunan. Walau bagaimanapun, binari pra-kompil dibina, diuji, dan diterbitkan ke PyPI sebagai sebahagian daripada proses keluaran dan pakej ini boleh dijangka dipasang dengan hanya persekitaran Python yang berfungsi.

Sistem pengendalian Peringkat 2:

• Linux AArch64 (pengedaran yang serasi dengan spesifikasi pembungkusan manylinux 2014)

Peringkat 3

Sistem pengendalian Peringkat 3 tidak diuji sebagai sebahagian daripada proses pembangunan. Binari pra-kompil dibina dan diterbitkan ke PyPI sebagai sebahagian daripada proses keluaran tetapi tidak diuji. Mereka mungkin tidak boleh dipasang dengan hanya persekitaran Python yang berfungsi dan mungkin memerlukan pengkompil C/C++ atau program tambahan untuk membina pergantungan dari sumber sebagai sebahagian daripada proses pemasangan. Sokongan untuk sistem pengendalian ini adalah atas dasar usaha terbaik sahaja.

Sistem pengendalian Peringkat 3:

• Linux ppc64le (pengedaran yang serasi dengan spesifikasi pembungkusan manylinux 2014)
• Linux s390x (pengedaran yang serasi dengan spesifikasi pembungkusan manylinux 2014)
• Linux i686 (pengedaran yang serasi dengan spesifikasi pembungkusan manylinux 2014)
• Windows 10 32-bit

Langkah seterusnya

Cadangan

• Sediakan akaun IBM Cloud anda.

• Konfigurasikan Qiskit secara tempatan.

• Ikut langkah-langkah dalam Hello world untuk menulis dan menjalankan program kuantum.

• Cuba tutorial IBM Quantum Learning.