Instalasi Qiskit

Baik kamu bekerja secara lokal maupun di lingkungan cloud, langkah pertama untuk semua pengguna adalah menginstal Qiskit.

Upgrade dari Qiskit 0.x ke Qiskit 1.0 dan seterusnya

(Jika kamu menginstal Qiskit untuk pertama kali, langsung loncat ke bagian Instalasi dan pengaturan. Catatan ini hanya relevan bagi pengguna yang sebelumnya sudah menginstal Qiskit.)

Bagi yang upgrade dari versi 0.x ke 1.0 atau lebih baru: perlu diketahui bahwa karena Qiskit v1.0 menggunakan struktur paket baru, kamu tidak bisa menggunakan pip install -U qiskit untuk upgrade dari versi Qiskit 0.x mana pun ke 1.0.

Lihat panduan migrasi Qiskit 1.0 untuk detail dan instruksinya.

Pembaruan di masa mendatang mulai dari Qiskit 1.0 akan memungkinkan upgrade langsung (in-place).

Instal Qiskit SDK dan klien Qiskit Runtime

1. Instal Python. Cek bagian "Programming Language" di halaman proyek Qiskit di PyPI untuk mengetahui versi Python mana yang didukung oleh rilis terbaru. Untuk instruksi unduhan, lihat Panduan Pemula Python.

   Disarankan untuk menggunakan virtual environment Python agar Qiskit terpisah dari aplikasi lain.

   catatan

   Instruksi ini menggunakan distribusi Python standar dari pypi.org. Namun, kamu bisa menggunakan distribusi Python lain, seperti Anaconda atau miniconda, bersama workflow manajemen dependensi lain seperti Poetry.

   Jika kamu belum familiar dengan virtual environment, klik di sini untuk informasi lebih lanjut.

   Virtual environment Python adalah ruang terisolasi untuk bekerja dengan Python untuk tujuan tertentu — sehingga kamu bisa menginstal paket apa pun yang kamu mau, serta mengatur library, dependensi, dan lain-lain, tanpa memengaruhi lingkungan Python "dasar" di mesinmu.

   Salah satu keuntungan penting dari virtual environment adalah jika lingkungan Python-mu rusak di suatu titik, kamu bisa dengan mudah menghapus virtual environment tersebut dan mulai dari awal!

   Pilih lokasi yang kamu inginkan untuk menyimpan informasi tentang virtual environment-mu. Biasanya disimpan di direktori bernama .venv di dalam setiap direktori proyek yang sedang kamu kerjakan.

   Pertama, navigasikan ke direktori proyekmu dan buat environment minimal yang hanya berisi Python.

   macOS

   python3 -m venv .venv

   Linux

   python3 -m venv .venv

   Windows

   python -m venv .venv

   Selanjutnya, aktifkan environment baru-mu.

   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. Instal pip jika belum terinstal di lingkunganmu. Pip adalah manajer paket Python yang kamu gunakan untuk menginstal Qiskit dan paket Python lainnya. Gunakan pip list untuk melihat apa yang ada di virtual environment-mu. Di sebagian besar lingkungan Python, pip sudah terinstal.

3. Instal Qiskit SDK. Jika kamu berencana menjalankan job di hardware kuantum, instal juga Qiskit Runtime.

   pip install qiskit

   pip install qiskit-ibm-runtime

   Tambahkan dukungan visualisasi

   Jika kamu berniat menggunakan fungsionalitas visualisasi atau Jupyter notebook, instal juga modul qiskit.visualization. Lihat referensi API Visualizations untuk informasi lebih lanjut.

1. Jika kamu ingin menjalankan Jupyter notebook dengan paket Qiskit yang baru saja kamu instal, kamu perlu menginstal Jupyter di lingkunganmu.

   pip install jupyter

   Lalu buka notebook-mu seperti berikut:

   jupyter notebook <path/to/notebook.ipynb>

Jika kamu berencana bekerja secara lokal dan menggunakan simulator bawaan Qiskit, maka instalasimu sudah selesai. Jika kamu ingin menjalankan job di IBM QPU, lanjutkan ke pengaturan akun IBM Cloud.

Tetap terkini dengan versi terbaru

Secara berkala cek catatan rilis Qiskit dan catatan rilis Qiskit Runtime untuk melihat rilis baru. Kami merekomendasikan agar kamu sering memperbarui kebutuhan qiskit dan qiskit-ibm-runtime, misalnya dengan mengubah versi di requirements.txt ke versi terbaru, lalu menjalankan pip install -r requirements.txt atau perintah yang sesuai untuk workflow manajemen dependensi-mu.

Butuh bantuan? Coba tanya Qiskit Code Assistant.

Pemecahan masalah

Error "No Module 'qiskit'" di Jupyter Notebook

Jika kamu menggunakan pip install qiskit dan menyiapkan virtual environment di Anaconda, kamu mungkin mendapatkan error No Module 'qiskit' saat menjalankan tutorial di Jupyter Notebook. Jika kamu belum menginstal Qiskit atau menyiapkan virtual environment-mu, kamu bisa mengikuti langkah instalasi.

Error ini disebabkan saat mencoba mengimpor paket Qiskit di lingkungan yang tidak memiliki Qiskit terinstal. Jika kamu membuka Jupyter Notebook dari Anaconda-Navigator, kemungkinan Jupyter Notebook berjalan di lingkungan dasar (root), bukan di virtual environment-mu. Pilih virtual environment di Anaconda-Navigator dari menu dropdown Applications on. Di menu ini, kamu bisa melihat semua virtual environment di dalam Anaconda, dan kamu bisa memilih lingkungan tempat Qiskit terinstal untuk membuka Jupyter Notebook.

Error kompilasi saat instalasi

Qiskit bergantung pada sejumlah paket Python open-source lainnya, yang otomatis terinstal saat melakukan pip install qiskit. Tergantung pada platform dan versi Python di sistemmu, ada kemungkinan paket tertentu tidak menyediakan binary yang sudah dikompilasi untuk sistemmu. Kamu bisa merujuk ke Dukungan sistem operasi untuk daftar platform yang didukung Qiskit, beberapa di antaranya mungkin memerlukan compiler tambahan. Dalam kasus di mana tidak tersedia binary yang sudah dikompilasi, pip akan mencoba mengompilasi paket dari source, yang pada gilirannya mungkin membutuhkan beberapa dependensi tambahan yang perlu diinstal secara manual.

Jika output dari pip install qiskit mengandung baris yang mirip 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

silakan cek dokumentasi paket yang gagal diinstal (dalam contoh kode, SOME_PACKAGE) untuk informasi tentang cara menginstal library yang dibutuhkan untuk kompilasi dari source.

Dukungan sistem operasi

Qiskit berusaha mendukung sebanyak mungkin sistem operasi, tetapi karena keterbatasan sumber daya pengujian yang tersedia dan ketersediaan sistem operasi, tidak semua sistem operasi bisa didukung. Dukungan sistem operasi untuk Qiskit dibagi menjadi tiga tingkat dengan berbagai tingkat dukungan untuk masing-masing tingkat. Untuk platform di luar ini, seperti FreeBSD atau WebAssembly (WASI), Qiskit mungkin masih bisa diinstal, tetapi tidak diuji dan kamu harus membangun Qiskit (dan kemungkinan dependensi Qiskit) dari source.

Selain itu, Qiskit hanya mendukung implementasi CPython dari bahasa Python. Menjalankan dengan interpreter Python lain seperti PyPy tidak didukung.

Qiskit v2.x

Dalam seri rilis Qiskit v2.x, platform yang didukung adalah:

Tier 1

Sistem operasi Tier 1 diuji sepenuhnya sebagai bagian dari proses pengembangan untuk memastikan setiap perubahan yang diusulkan akan berfungsi dengan benar. Binary yang sudah dikompilasi dibangun, diuji, dan diterbitkan ke PyPI sebagai bagian dari proses rilis. Biasanya, selama ada lingkungan Python yang berfungsi, Qiskit bisa diinstal di sistem operasi ini tanpa perlu menginstal dependensi tambahan.

Sistem operasi Tier 1:

• Linux x86_64 (distribusi yang kompatibel dengan spesifikasi paket manylinux 2014).
• macOS ARM64 (11.0 atau lebih baru)
• Windows 64-bit (Windows 10 dan yang lebih baru didukung)
• Linux AArch64 (distribusi yang kompatibel dengan spesifikasi paket manylinux 2014)

Tier 2

Sistem operasi Tier 2 tidak diuji sebagai bagian dari proses pengembangan. Namun, binary yang sudah dikompilasi dibangun, diuji, dan diterbitkan ke PyPI sebagai bagian dari proses rilis, dan paket-paket ini bisa diharapkan diinstal hanya dengan lingkungan Python yang berfungsi. Mungkin ada penundaan dalam merilis paket untuk sistem-sistem ini, karena kegagalan uji mungkin tidak terdeteksi sampai jauh kemudian, dan kegagalan saat penerbitan tidak akan menghalangi penerbitan paket untuk sistem Tier 1.

Sistem operasi Tier 2:

• macOS x86_64 (10.12 atau lebih baru)

Tier 3

Sistem operasi Tier 3 tidak diuji sebagai bagian dari proses pengembangan. Binary yang sudah dikompilasi dibangun dan diterbitkan ke PyPI sebagai bagian dari proses rilis tetapi tidak diuji. Mereka mungkin tidak bisa diinstal hanya dengan lingkungan Python yang berfungsi dan mungkin memerlukan kompiler C/C++ atau program tambahan untuk membangun dependensi dari source sebagai bagian dari proses instalasi. Dukungan untuk sistem operasi ini bersifat best effort saja.

Sistem operasi Tier 3:

• Linux ppc64le (distribusi yang kompatibel dengan spesifikasi paket manylinux 2014)
• Linux s390x (distribusi yang kompatibel dengan spesifikasi paket manylinux 2014)

Mulai dari Qiskit v2.0.0, hanya platform 64-bit yang didukung dan platform 32-bit tidak didukung. Kamu juga tidak akan bisa membangun dari source di platform 32-bit, karena secara internal kode Rust Qiskit mengasumsikan lebar pointer 64-bit.

Qiskit v1.x

Dalam seri rilis Qiskit v1.x, platform yang didukung adalah:

Tier 1

Sistem operasi Tier 1 diuji sepenuhnya sebagai bagian dari proses pengembangan untuk memastikan setiap perubahan yang diusulkan akan berfungsi dengan benar. Binary yang sudah dikompilasi dibangun, diuji, dan diterbitkan ke PyPI sebagai bagian dari proses rilis. Biasanya, selama ada lingkungan Python yang berfungsi, Qiskit bisa diinstal di sistem operasi ini tanpa perlu menginstal dependensi tambahan.

Sistem operasi Tier 1:

• Linux x86_64 (distribusi yang kompatibel dengan spesifikasi paket manylinux 2014).
• macOS x86_64 (10.12 atau lebih baru)
• macOS ARM64 (11.0 atau lebih baru)
• Windows 64-bit (Windows 10 dan yang lebih baru didukung)

Tier 2

Sistem operasi Tier 2 tidak diuji sebagai bagian dari proses pengembangan. Namun, binary yang sudah dikompilasi dibangun, diuji, dan diterbitkan ke PyPI sebagai bagian dari proses rilis dan paket-paket ini bisa diharapkan diinstal hanya dengan lingkungan Python yang berfungsi.

Sistem operasi Tier 2:

• Linux AArch64 (distribusi yang kompatibel dengan spesifikasi paket manylinux 2014)

Tier 3

Sistem operasi Tier 3 tidak diuji sebagai bagian dari proses pengembangan. Binary yang sudah dikompilasi dibangun dan diterbitkan ke PyPI sebagai bagian dari proses rilis tetapi tidak diuji. Mereka mungkin tidak bisa diinstal hanya dengan lingkungan Python yang berfungsi dan mungkin memerlukan kompiler C/C++ atau program tambahan untuk membangun dependensi dari source sebagai bagian dari proses instalasi. Dukungan untuk sistem operasi ini bersifat best effort saja.

Sistem operasi Tier 3:

• Linux ppc64le (distribusi yang kompatibel dengan spesifikasi paket manylinux 2014)
• Linux s390x (distribusi yang kompatibel dengan spesifikasi paket manylinux 2014)
• Linux i686 (distribusi yang kompatibel dengan spesifikasi paket manylinux 2014)
• Windows 10 32-bit

Langkah berikutnya

Rekomendasi

• Siapkan akun IBM Cloud-mu.

• Konfigurasi Qiskit secara lokal.

• Ikuti langkah-langkah di Hello world untuk menulis dan menjalankan program kuantum.

• Coba tutorial IBM Quantum Learning.