Instalează Qiskit

Indiferent dacă vei lucra local sau într-un mediu cloud, primul pas pentru toți utilizatorii este să instaleze Qiskit.

Actualizare de la Qiskit 0.x la Qiskit 1.0 și versiuni ulterioare

(Dacă instalezi Qiskit pentru prima dată, sari direct la secțiunea Instalare și configurare. Această notă este relevantă doar pentru utilizatorii care au instalat Qiskit anterior.)

Pentru cei care actualizează de la versiunea 0.x la 1.0 sau mai nouă: reține că, deoarece Qiskit v1.0 folosește o nouă structură de pachete, nu poți folosi pip install -U qiskit pentru a actualiza de la orice versiune Qiskit 0.x la 1.0.

Consultă ghidul de migrare Qiskit 1.0 pentru detalii și instrucțiuni.

Actualizările viitoare începând cu Qiskit 1.0 vor permite actualizări directe (in-place).

Instalează SDK-ul Qiskit și clientul Qiskit Runtime

1. Instalează Python. Verifică secțiunea „Programming Language" de pe pagina proiectului Qiskit de pe PyPI pentru a afla ce versiuni de Python sunt suportate de cea mai recentă versiune. Pentru instrucțiuni de descărcare, consultă Ghidul pentru începători Python.

   Se recomandă să folosești medii virtuale Python pentru a separa Qiskit de alte aplicații.

   notă

   Aceste instrucțiuni folosesc distribuția standard Python de pe pypi.org. Totuși, poți folosi și alte distribuții Python, cum ar fi Anaconda sau miniconda, împreună cu alte fluxuri de gestionare a dependențelor, cum ar fi Poetry.

   Dacă ești la început cu mediile virtuale, apasă aici pentru mai multe informații.

   Un mediu virtual Python este un spațiu izolat în care poți lucra cu Python pentru un scop specific — poți instala orice pachete dorești și configura biblioteci, dependențe și altele, fără a afecta mediul Python „de bază" de pe mașina ta.

   Un avantaj important al unui mediu virtual este că, dacă mediul tău Python se strică pe parcurs, poți șterge cu ușurință mediul virtual și o iei de la capăt!

   Alege o locație preferată în care să stochezi informațiile despre mediile tale virtuale. De obicei, acestea sunt stocate într-un director numit .venv în interiorul fiecărui director de proiect în care lucrezi.

   Mai întâi, navighează la directorul proiectului tău și creează un mediu minimal cu doar Python instalat în el.

   macOS

   python3 -m venv .venv

   Linux

   python3 -m venv .venv

   Windows

   python -m venv .venv

   Apoi, activează noul tău mediu.

   macOS

   source .venv/bin/activate

   Linux

   source .venv/bin/activate

   Windows

   Dacă folosești PowerShell:

   .venv\Scripts\Activate.ps1

   Dacă folosești Git Bash:

   source .venv/scripts/activate

   Dacă folosești Command Prompt:

   .venv\Scripts\activate

2. Instalează pip dacă nu este deja instalat în mediul tău. Pip este un manager de pachete Python pe care îl folosești pentru a instala Qiskit și alte pachete Python. Folosește pip list pentru a vedea ce se află în mediul tău virtual. În majoritatea mediilor Python, pip este deja instalat.

3. Instalează SDK-ul Qiskit. Dacă plănuiești să rulezi joburi pe hardware cuantic, instalează și Qiskit Runtime.

   pip install qiskit

   pip install qiskit-ibm-runtime

   Adaugă suport pentru vizualizare

   Dacă intenționezi să folosești funcționalități de vizualizare sau notebook-uri Jupyter, instalează și modulul qiskit.visualization. Consultă documentația de referință API pentru Vizualizări pentru mai multe informații.

1. Dacă vrei să rulezi un notebook Jupyter cu pachetele Qiskit pe care tocmai le-ai instalat, trebuie să instalezi Jupyter în mediul tău.

   pip install jupyter

   Apoi deschide notebook-ul astfel:

   jupyter notebook <path/to/notebook.ipynb>

Dacă plănuiești să lucrezi local și să folosești simulatoarele încorporate în Qiskit, atunci instalarea este completă. Dacă vrei să rulezi joburi pe QPU-urile IBM, continuă cu configurarea contului tău IBM Cloud.

Rămâi la curent cu cele mai recente versiuni

Verifică periodic notele de lansare Qiskit și notele de lansare Qiskit Runtime pentru a vedea noile versiuni. Recomandăm să actualizezi frecvent cerințele pentru qiskit și qiskit-ibm-runtime, de exemplu, schimbând versiunile din requirements.txt la cele mai recente, apoi rulând pip install -r requirements.txt sau comanda corespunzătoare fluxului tău de gestionare a dependențelor.

Ai nevoie de ajutor? Încearcă să întrebi Qiskit Code Assistant.

Depanare

Eroarea „No Module 'qiskit'" în Jupyter Notebook

Dacă ai folosit pip install qiskit și ai configurat mediul virtual în Anaconda, este posibil să primești eroarea No Module 'qiskit' când rulezi un tutorial în Jupyter Notebook. Dacă nu ai instalat Qiskit sau nu ai configurat mediul virtual, poți urma pașii de instalare.

Eroarea apare când se încearcă importul pachetului Qiskit într-un mediu în care Qiskit nu este instalat. Dacă ai lansat Jupyter Notebook din Anaconda-Navigator, este posibil ca Jupyter Notebook să ruleze în mediul de bază (root), în loc de mediul tău virtual. Alege un mediu virtual în Anaconda-Navigator din meniul derulant Applications on. În acest meniu poți vedea toate mediile virtuale din Anaconda și poți selecta mediul în care ai instalat Qiskit pentru a lansa Jupyter Notebook.

Erori de compilare în timpul instalării

Qiskit depinde de o serie de alte pachete Python open-source, care sunt instalate automat la rularea pip install qiskit. În funcție de platforma și versiunea de Python ale sistemului tău, este posibil ca un anumit pachet să nu furnizeze fișiere binare precompilate pentru sistemul tău. Poți consulta Suportul pentru sisteme de operare pentru o listă a platformelor suportate de Qiskit, unele dintre care pot necesita un compilator suplimentar. În cazurile în care nu există fișiere binare precompilate disponibile, pip va încerca să compileze pachetul din sursă, ceea ce poate necesita la rândul său unele dependențe suplimentare care trebuie instalate manual.

Dacă rezultatul comenzii pip install qiskit conține linii similare cu:

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

consultă documentația pachetului care nu a reușit să se instaleze (în codul exemplu, SOME_PACKAGE) pentru informații despre cum să instalezi bibliotecile necesare pentru compilarea din sursă.

Suport pentru sisteme de operare

Qiskit urmărește să suporte cât mai multe sisteme de operare posibil, dar din cauza limitărilor resurselor de testare disponibile și a disponibilității sistemelor de operare, nu toate sistemele de operare pot fi suportate. Suportul pentru sisteme de operare în Qiskit este împărțit în trei niveluri cu diferite grade de suport pentru fiecare nivel. Pentru platformele din afara acestora, cum ar fi FreeBSD sau WebAssembly (WASI), Qiskit poate fi în continuare instalabil, dar nu este testat și va trebui să compilezi Qiskit (și probabil dependențele Qiskit) din sursă.

În plus, Qiskit suportă doar implementarea CPython a limbajului Python. Rularea cu alți interpreți Python, cum ar fi PyPy, nu este suportată.

Qiskit v2.x

În seria de lansări Qiskit v2.x, platformele suportate sunt:

Nivelul 1

Sistemele de operare de Nivelul 1 sunt testate complet ca parte a proceselor de dezvoltare pentru a se asigura că orice modificare propusă va funcționa corect. Fișierele binare precompilate sunt construite, testate și publicate pe PyPI ca parte a procesului de lansare. De obicei, atâta timp cât există un mediu Python funcțional instalat, Qiskit poate fi instalat pe aceste sisteme de operare fără a fi nevoie să instalezi dependențe suplimentare.

Sisteme de operare de Nivelul 1:

• Linux x86_64 (distribuții compatibile cu specificația de pachetare manylinux 2014).
• macOS ARM64 (11.0 sau mai nou)
• Windows 64-bit (Windows 10 și versiuni ulterioare suportate)
• Linux AArch64 (distribuții compatibile cu specificația de pachetare manylinux 2014)

Nivelul 2

Sistemele de operare de Nivelul 2 nu sunt testate ca parte a procesului de dezvoltare. Totuși, fișierele binare precompilate sunt construite, testate și publicate pe PyPI ca parte a procesului de lansare, iar aceste pachete pot fi instalate cu doar un mediu Python funcțional. Poate exista o întârziere la lansarea pachetelor pentru aceste sisteme, deoarece erorile de testare pot fi detectate mult mai târziu, iar erorile la publicare nu vor bloca publicarea pachetului pentru sistemele de Nivelul 1.

Sisteme de operare de Nivelul 2:

• macOS x86_64 (10.12 sau mai nou)

Nivelul 3

Sistemele de operare de Nivelul 3 nu sunt testate ca parte a procesului de dezvoltare. Fișierele binare precompilate sunt construite și publicate pe PyPI ca parte a procesului de lansare, dar nu sunt testate. Este posibil să nu poată fi instalate cu doar un mediu Python funcțional și pot necesita un compilator C/C++ sau programe suplimentare pentru a construi dependențele din sursă în cadrul procesului de instalare. Suportul pentru aceste sisteme de operare este oferit pe baza celor mai bune eforturi.

Sisteme de operare de Nivelul 3:

• Linux ppc64le (distribuții compatibile cu specificația de pachetare manylinux 2014)
• Linux s390x (distribuții compatibile cu specificația de pachetare manylinux 2014)

Începând cu Qiskit v2.0.0, sunt suportate doar platformele pe 64 de biți, iar platformele pe 32 de biți nu sunt suportate. Nu vei putea compila din sursă nici pe platformele pe 32 de biți, deoarece intern codul Rust din Qiskit presupune o lățime a pointerului de 64 de biți.

Qiskit v1.x

În seria de lansări Qiskit v1.x, platformele suportate sunt:

Nivelul 1

Sistemele de operare de Nivelul 1 sunt testate complet ca parte a proceselor de dezvoltare pentru a se asigura că orice modificare propusă va funcționa corect. Fișierele binare precompilate sunt construite, testate și publicate pe PyPI ca parte a procesului de lansare. De obicei, atâta timp cât există un mediu Python funcțional instalat, Qiskit poate fi instalat pe aceste sisteme de operare fără a fi nevoie să instalezi dependențe suplimentare.

Sisteme de operare de Nivelul 1:

• Linux x86_64 (distribuții compatibile cu specificația de pachetare manylinux 2014).
• macOS x86_64 (10.12 sau mai nou)
• macOS ARM64 (11.0 sau mai nou)
• Windows 64-bit (Windows 10 și versiuni ulterioare suportate)

Nivelul 2

Sistemele de operare de Nivelul 2 nu sunt testate ca parte a procesului de dezvoltare. Totuși, fișierele binare precompilate sunt construite, testate și publicate pe PyPI ca parte a procesului de lansare, iar aceste pachete pot fi instalate cu doar un mediu Python funcțional.

Sisteme de operare de Nivelul 2:

• Linux AArch64 (distribuții compatibile cu specificația de pachetare manylinux 2014)

Nivelul 3

Sistemele de operare de Nivelul 3 nu sunt testate ca parte a procesului de dezvoltare. Fișierele binare precompilate sunt construite și publicate pe PyPI ca parte a procesului de lansare, dar nu sunt testate. Este posibil să nu poată fi instalate cu doar un mediu Python funcțional și pot necesita un compilator C/C++ sau programe suplimentare pentru a construi dependențele din sursă în cadrul procesului de instalare. Suportul pentru aceste sisteme de operare este oferit pe baza celor mai bune eforturi.

Sisteme de operare de Nivelul 3:

• Linux ppc64le (distribuții compatibile cu specificația de pachetare manylinux 2014)
• Linux s390x (distribuții compatibile cu specificația de pachetare manylinux 2014)
• Linux i686 (distribuții compatibile cu specificația de pachetare manylinux 2014)
• Windows 10 32-bit

Pași următori

Recomandări

• Configurează-ți contul IBM Cloud.

• Configurează Qiskit local.

• Urmează pașii din Hello world pentru a scrie și rula un program cuantic.

• Încearcă un tutorial IBM Quantum Learning.