I-install ang Qiskit

Kahit magtatrabaho ka nang lokal o sa cloud environment, ang unang hakbang para sa lahat ng mga user ay ang pag-install ng Qiskit.

Pag-upgrade mula sa Qiskit 0.x patungong Qiskit 1.0 at mas bago

(Kung ito ang unang beses mong nag-i-install ng Qiskit, laktawan ang seksyong I-install at i-set up. Ang abisong ito ay para lamang sa mga user na nakaraang nag-install ng Qiskit.)

Para sa mga nag-a-upgrade mula sa bersyon 0.x patungong 1.0 o mas bago: tandaan na dahil gumagamit ang Qiskit v1.0 ng bagong packaging structure, hindi mo magagamit ang pip install -U qiskit para mag-upgrade mula sa anumang Qiskit 0.x na bersyon patungong 1.0.

Tingnan ang Qiskit 1.0 migration guide para sa mga detalye at tagubilin.

Ang mga susunod na update simula sa Qiskit 1.0 ay magbibigay-daan sa in-place na mga upgrade.

I-install ang Qiskit SDK at ang Qiskit Runtime client

Mag-install ng Python. Tingnan ang seksyong "Programming Language" sa Qiskit PyPI project page para malaman kung aling mga bersyon ng Python ang sinusuportahan ng pinakabagong release. Para sa mga tagubilin sa pag-download, tingnan ang Python Beginners Guide.

Inirerekomenda na gumamit ka ng Python virtual environments para ihiwalay ang Qiskit mula sa ibang mga application.

tala
Gumagamit ang mga tagubiling ito ng standard na Python distribution mula sa pypi.org. Gayunpaman, maaari kang gumamit ng ibang mga Python distribution, tulad ng Anaconda o miniconda, kasama ang ibang mga dependency management workflow tulad ng Poetry.

Kung bago ka sa virtual environments, i-click dito para sa karagdagang impormasyon.
Ang isang virtual Python environment ay isang isolated na espasyo para magtrabaho kasama ang Python para sa isang tiyak na layunin — kaya maaari kang mag-install ng kahit anong mga pakete, at mag-set up ng mga library, dependency, at iba pa, nang hindi naaapektuhan ang "base" na Python environment sa iyong makina.
Isang mahalagang kalamangan ng virtual environment ay kung masira ang iyong Python environment sa pagbabago, madali mo itong ma-delete at magsimula ulit!
Pumili ng gustong lokasyon kung saan iiimbak ang impormasyon tungkol sa iyong mga virtual environment. Kadalasan, ini-imbak ang mga ito sa isang direktoryo na pinangalanang .venv sa loob ng bawat project directory na pinagtatrabahuhan mo.

Una, pumunta sa iyong project directory at gumawa ng minimal na environment na may Python lamang na naka-install dito.
- macOS
- Linux
- Windows
python3 -m venv .venv
python3 -m venv .venv
python -m venv .venv
Susunod, i-activate ang iyong bagong environment.
- macOS
- Linux
- Windows
source .venv/bin/activate
source .venv/bin/activate
Kung gumagamit ng PowerShell:
.venv\Scripts\Activate.ps1
Kung gumagamit ng Git Bash:
source .venv/scripts/activate
Kung gumagamit ng command prompt:
.venv\Scripts\activate
Mag-install ng pip kung hindi pa ito naka-install sa iyong environment. Ang pip ay isang Python package manager na ginagamit mo para mag-install ng Qiskit at ibang mga Python package. Gamitin ang pip list para makita kung ano ang nasa iyong virtual environment. Sa karamihan ng mga Python environment, naka-install na ang pip.
I-install ang Qiskit SDK. Kung plano mong magpatakbo ng mga job sa quantum hardware, i-install din ang Qiskit Runtime.
```
pip install qiskit
```
```
pip install qiskit-ibm-runtime
```
Magdagdag ng suporta sa visualization
Kung balak mong gumamit ng visualization functionality o Jupyter notebooks, i-install din ang qiskit.visualization module. Tingnan ang Visualizations API reference para sa karagdagang impormasyon.

Kung gusto mong magpatakbo ng Jupyter notebook kasama ang mga Qiskit package na na-install mo lang, kailangan mong mag-install ng Jupyter sa iyong environment.
```
pip install jupyter
```
Pagkatapos, buksan ang iyong notebook tulad nito:
```
jupyter notebook <path/to/notebook.ipynb>
```

Kung plano kang magtrabaho nang lokal at gumamit ng mga simulator na built into Qiskit, tapos na ang iyong pag-install. Kung gusto mong magpatakbo ng mga job sa IBM QPUs, magpatuloy sa pag-set up ng iyong IBM Cloud account.

Manatiling updated sa pinakabagong mga bersyon

Pana-panahon, tingnan ang Qiskit release notes at ang Qiskit Runtime release notes para makita ang mga bagong release. Inirerekomenda namin na madalas mong i-update ang iyong mga requirement para sa qiskit at qiskit-ibm-runtime sa pamamagitan ng, halimbawa, pagpapalit ng mga bersyon sa requirements.txt sa pinakabagong mga bersyon, pagkatapos ay pagpapatakbo ng pip install -r requirements.txt o ang angkop na command para sa iyong dependency management workflow.

Kailangan ng tulong? Subukang tanungin ang Qiskit Code Assistant.

Pag-troubleshoot

Error na "No Module 'qiskit'" sa Jupyter Notebook

Kung ginamit mo ang pip install qiskit at nag-set up ng iyong virtual environment sa Anaconda, maaari kang makakuha ng error na No Module 'qiskit' kapag nagpatakbo ka ng tutorial sa Jupyter Notebook. Kung hindi pa naka-install ang Qiskit o hindi pa na-set up ang iyong virtual environment, maaari mong sundin ang mga hakbang sa pag-install.

Ang error ay sanhi ng pagsubok na mag-import ng Qiskit package sa isang environment kung saan hindi naka-install ang Qiskit. Kung inilunsad mo ang Jupyter Notebook mula sa Anaconda-Navigator, posible na tumatakbo ang Jupyter Notebook sa base (root) environment, sa halip na sa iyong virtual environment. Pumili ng virtual environment sa Anaconda-Navigator mula sa dropdown menu na Applications on. Sa menu na ito, makikita mo ang lahat ng virtual environment sa loob ng Anaconda, at maaari kang pumili ng environment kung saan naka-install ang Qiskit para ilunsad ang Jupyter Notebook.

Mga error sa compilation habang nag-iinstall

Umaasa ang Qiskit sa ilang ibang open-source na Python package, na awtomatikong ina-install kapag ginawa ang pip install qiskit. Depende sa platform at bersyon ng Python ng iyong system, posible na ang isang partikular na pakete ay walang pre-built na mga binary para sa iyong system. Maaari kang sumangguni sa Operating system support para sa listahan ng mga platform na sinusuportahan ng Qiskit, na ilan sa mga ito ay maaaring mangailangan ng karagdagang compiler. Sa mga kaso kung saan walang available na precompiled na mga binary, susubukan ng pip na i-compile ang pakete mula sa source, na nangangailangan naman ng ilang karagdagang dependency na kailangang i-install nang manu-mano.

Kung ang output ng pip install qiskit ay naglalaman ng mga linya na katulad ng:

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

pakitingnan ang dokumentasyon ng paketeng nabigo sa pag-install (sa halimbawang code, SOME_PACKAGE) para sa impormasyon kung paano i-install ang mga library na kailangan para sa pag-compile mula sa source.

Suporta sa operating system

Nagsisikap ang Qiskit na suportahan ang mas maraming operating system hangga't maaari, ngunit dahil sa mga limitasyon sa available na testing resources at availability ng operating system, hindi lahat ng operating system ay maaaring suportahan. Ang suporta sa operating system para sa Qiskit ay nahahati sa tatlong tier na may iba't ibang antas ng suporta para sa bawat tier. Para sa mga platform na wala sa mga ito, tulad ng FreeBSD o WebAssembly (WASI), maaaring mai-install pa rin ang Qiskit, ngunit hindi ito tinotest at kailangan mong buuin ang Qiskit (at malamang ang mga dependency ng Qiskit) mula sa source.

Bukod dito, sinusuportahan lamang ng Qiskit ang CPython na implementasyon ng wikang Python. Hindi sinusuportahan ang pagpapatakbo gamit ang ibang mga Python interpreter tulad ng PyPy.

Qiskit v2.x

Sa Qiskit v2.x na release series, ang mga sinusuportahang platform ay:

Tier 1

Ang mga Tier 1 na operating system ay ganap na tinotest bilang bahagi ng mga proseso ng development para matiyak na ang anumang iminungkahing pagbabago ay gagana nang tama. Ang mga pre-compiled na binary ay binubuo, tinotest, at nila-publish sa PyPI bilang bahagi ng proseso ng release. Kadalasan, basta't may gumaganang Python environment na naka-install, maaaring i-install ang Qiskit sa mga operating system na ito nang hindi na kailangang mag-install ng karagdagang dependency.

Mga Tier 1 na operating system:

Linux x86_64 (mga distribution na compatible sa manylinux 2014 packaging specification).
macOS ARM64 (11.0 o mas bago)
Windows 64-bit (sinusuportahan ang Windows 10 at mas bago)
Linux AArch64 (mga distribution na compatible sa manylinux 2014 packaging specification)

Tier 2

Ang mga Tier 2 na operating system ay hindi tinotest bilang bahagi ng proseso ng development. Gayunpaman, ang mga pre-compiled na binary ay binubuo, tinotest, at nila-publish sa PyPI bilang bahagi ng proseso ng release, at ang mga paketeng ito ay maaaring i-install nang may gumaganang Python environment lamang. Maaaring magkaroon ng pagkaantala sa pag-release ng mga pakete para sa mga system na ito, dahil ang mga test failure ay maaaring hindi matukoy hanggang sa mas matagal, at ang mga failure sa pag-publish ay hindi hahadlang sa pag-publish ng pakete para sa mga Tier 1 na system.

Mga Tier 2 na operating system:

macOS x86_64 (10.12 o mas bago)

Tier 3

Ang mga Tier 3 na operating system ay hindi tinotest bilang bahagi ng proseso ng development. Ang mga pre-compiled na binary ay binubuo at nila-publish sa PyPI bilang bahagi ng proseso ng release ngunit hindi tinotest. Maaaring hindi mai-install ang mga ito nang may gumaganang Python environment lamang at maaaring mangailangan ng C/C++ compiler o karagdagang programa para buuin ang mga dependency mula sa source bilang bahagi ng proseso ng pag-install. Ang suporta para sa mga operating system na ito ay best effort lamang.

Mga Tier 3 na operating system:

Linux ppc64le (mga distribution na compatible sa manylinux 2014packaging specification)
Linux s390x (mga distribution na compatible sa manylinux 2014 packaging specification)

Simula sa Qiskit v2.0.0, ang mga 64-bit na platform lamang ang sinusuportahan at hindi sinusuportahan ang mga 32-bit na platform. Hindi ka rin makakabuo mula sa source sa mga 32-bit na platform, dahil ang Qiskit Rust code sa loob ay nag-aasume ng 64-bit na luwang ng pointer.

Qiskit v1.x

Sa Qiskit v1.x na release series, ang mga sinusuportahang platform ay:

Tier 1

Mga Tier 1 na operating system:

Linux x86_64 (mga distribution na compatible sa manylinux 2014 packaging specification).
macOS x86_64 (10.12 o mas bago)
macOS ARM64 (11.0 o mas bago)
Windows 64-bit (sinusuportahan ang Windows 10 at mas bago)

Tier 2

Mga Tier 2 na operating system:

Linux AArch64 (mga distribution na compatible sa manylinux 2014 packaging specification)

Tier 3

Mga Tier 3 na operating system:

Linux ppc64le (mga distribution na compatible sa manylinux 2014packaging specification)
Linux s390x (mga distribution na compatible sa manylinux 2014 packaging specification)
Linux i686 (mga distribution na compatible sa manylinux 2014 packaging specification)
Windows 10 32-bit

Mga susunod na hakbang

Mga Rekomendasyon

I-set up ang iyong IBM Cloud account.
I-configure ang Qiskit nang lokal.
Sundin ang mga hakbang sa Hello world para magsulat at magpatakbo ng quantum program.
Subukan ang isang IBM Quantum Learning tutorial.

I-install ang Qiskit SDK at ang Qiskit Runtime client​

Pag-troubleshoot​

Suporta sa operating system​

Qiskit v2.x​

Qiskit v1.x​

Mga susunod na hakbang​