Installare Qiskit

Sia che si lavori in locale o in un ambiente cloud, il primo passo per tutti gli utenti è installare Qiskit.

Installa l' Qiskit SDK

Installa Python. Consulta la sezione "Linguaggi di programmazione" nella pagina del progetto Qiskit PyPI per verificare quali versioni di Python sono supportate dall'ultima versione disponibile. Per le istruzioni sul download, consultare la Guida per principianti di Python.

Si consiglia di utilizzare gli ambienti virtuali Python per separare Qiskit dalle altre applicazioni.

Note
Queste istruzioni utilizzano la distribuzione standard Python da pypi.org. Tuttavia, è possibile utilizzare altre distribuzioni di Python, come Anaconda o miniconda, insieme ad altri flussi di gestione delle dipendenze come Poetry.
- Un ambiente virtuale Python è uno spazio isolato in cui lavorare con Python per uno scopo specifico, in modo da poter installare qualsiasi pacchetto si desideri e impostare librerie, dipendenze e così via, senza influenzare l'ambiente "base" Python sulla propria macchina.
  Un importante vantaggio di un ambiente virtuale è che se l'ambiente Python si corrompe da qualche parte lungo il percorso, si può facilmente cancellare l'ambiente virtuale e ricominciare da capo!
  Scegliere una posizione preferita in cui memorizzare le informazioni sugli ambienti virtuali. In genere sono memorizzati in una cartella denominata .venv all'interno di ogni cartella di progetto in cui si sta lavorando.
Per prima cosa, spostarsi nella cartella del progetto e creare un ambiente minimale con solo Python installato.
```
python3 -m venv .venv
```
```
python3 -m venv .venv
```
```
python -m venv .venv
```
Quindi, attivare il nuovo ambiente.
```
source .venv/bin/activate
```
```
source .venv/bin/activate
```
Se si utilizza PowerShell:
```
.venv\Scripts\Activate.ps1
```
Se si utilizza Git Bash:
```
source .venv/scripts/activate
```
Se si utilizza il prompt dei comandi:
```
.venv\Scripts\activate
```
Installare pip se non è già installato nel proprio ambiente. Pip è un gestore di pacchetti Python che si usa per installare Qiskit e altri pacchetti Python. Utilizzate pip list per vedere cosa c'è nel vostro ambiente virtuale. Nella maggior parte degli ambienti Python, pip è già installato.
Installa l' Qiskit SDK
```
pip install qiskit
```
Aggiungi supporto alla visualizzazione
Se si intende utilizzare la funzionalità di visualizzazione o i notebook Jupyter, installare anche il qiskit.visualization modulo. Per ulteriori informazioni, consulta la guida di riferimento dell'API Visualizzazioni.

Se si desidera eseguire un notebook Jupyter con i pacchetti Qiskit appena installati, è necessario installare Jupyter nel proprio ambiente.
```
pip install jupyter
```
Quindi aprire il blocco note come segue:
```
jupyter notebook <path/to/notebook.ipynb>
```

Se hai intenzione di lavorare in locale e di utilizzare i simulatori integrati in Qiskit, l'installazione è completata. Se desideri eseguire lavori sulle QPU dell' IBM®, procedi con la configurazione del tuo account IBM Cloud®.

Rimanere aggiornati con le ultime versioni

Controlla periodicamente le note di rilascio di Qiskit per scoprire le nuove versioni. Si consiglia di aggiornare regolarmente qiskit i requisiti eseguendo pip install -U qiskit.

Risoluzione dei problemi

Se si è utilizzato pip install qiskit e si è configurato l'ambiente virtuale in Anaconda, è possibile che si verifichi l'errore No Module 'qiskit' quando si esegue un tutorial in Jupyter Notebook. Se non si è installato Qiskit o non si è configurato l'ambiente virtuale, è possibile seguire i passi dell'installazione ambiente virtuale, è possibile seguire la procedura di installazione.
L'errore si verifica quando si tenta di importare il pacchetto Qiskit in un in un ambiente in cui Qiskit non è installato. Se è stato lanciato Jupyter Notebook da Anaconda- Navigator, è possibile che Jupyter Notebook sia in esecuzione nell'ambiente di base (root), invece che nel vostro ambiente virtuale virtuale. Scegliere un ambiente virtuale in Anaconda- Navigator dal menu a tendina Applicazioni su menu a discesa. In questo menu è possibile vedere tutti gli ambienti virtuali all'interno di Anaconda, e si può selezionare l'ambiente in cui è installato Qiskit per lanciare Jupyter Notebook.
Qiskit dipende da una serie di altri pacchetti open-source di Python, che vengono installati automaticamente quando si esegue pip install qiskit. A seconda della della piattaforma del sistema e della versione di Python, è possibile che un particolare pacchetto non fornisca binari precostituiti per il vostro sistema. Per un elenco delle piattaforme supportate da Qiskit si può fare riferimento a al supporto del sistema operativo per un elenco delle piattaforme supportate da Qiskit, alcune delle quali potrebbero richiedere un compilatore aggiuntivo alcune delle quali potrebbero richiedere un compilatore aggiuntivo. Nei casi in cui non sono disponibili binari precompilati, pip cercherà di compilare il pacchetto dai sorgenti dai sorgenti, il che a sua volta potrebbe richiedere alcune dipendenze extra che devono essere essere installate manualmente.
Se l'output di pip install qiskit contiene righe simili a:
```
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
```
controllare la documentazione del pacchetto che non è stato installato (nel codice di esempio, ) per informazioni su come installare le librerie codice di esempio, SOME_PACKAGE) per informazioni su come installare le librerie necessarie per la compilazione dai sorgenti.

al Sistema Operativo SCE

Qiskit si sforza di supportare il maggior numero possibile di sistemi operativi, ma a causa dei limiti delle risorse di test disponibili e della disponibilità dei sistemi operativi, non tutti i sistemi operativi possono essere supportati. Il supporto del sistema operativo per Qiskit è suddiviso in tre livelli con diversi livelli di supporto per ciascun livello. Per piattaforme diverse da queste, come FreeBSD o WebAssembly (WASI), Qiskit può essere ancora installabile, ma non è testato e dovrete compilare Qiskit (e probabilmente le sue dipendenze) dai sorgenti.

Inoltre, Qiskit supporta solo l'implementazione CPython del linguaggio Python. L'esecuzione con altri interpreti di Python, come PyPy, non è supportata.

Qiskit v2.x

Nella serie di release di Qiskit v2.x, le piattaforme supportate sono:

I sistemi operativi di livello 1 vengono testati completamente nell'ambito dei processi di sviluppo per garantire il corretto funzionamento di qualsiasi modifica proposta. I binari precompilati vengono costruiti, testati e pubblicati su PyPI come parte del processo di rilascio. In genere, se è presente un ambiente Python funzionante, Qiskit può essere installato su questi sistemi operativi senza dover installare ulteriori dipendenze.
Sistemi operativi di livello 1:
- Linux x86_64 (distribuzioni compatibili con le specifiche di packaging di Manylinux 2014 ).
- macOS ARM64 ( 11.0 o più recente)
- Windows 64-bit (Windows 10 e successivi supportati)
- Linux AArch64 (distribuzioni compatibili con le specifiche di packaging di manylinux 2014 )
I sistemi operativi di livello 2 non vengono testati nell'ambito del processo di sviluppo. Tuttavia, i binari precompilati vengono creati, testati e pubblicati su PyPI come parte del processo di rilascio, e questi pacchetti possono essere installati solo con un ambiente Python funzionante. Potrebbero verificarsi ritardi nel rilascio dei pacchetti per questi sistemi, poiché gli errori nei test potrebbero non essere rilevati fino a molto tempo dopo e gli errori durante la pubblicazione non bloccheranno la pubblicazione del pacchetto per i sistemi di livello 1.
Sistemi operativi di livello 2:
- macOS x86_64 ( 10.12 o successivo)
I sistemi operativi di livello 3 non vengono testati nell'ambito del processo di sviluppo. I binari precompilati vengono creati e pubblicati su PyPI come parte del processo di rilascio, ma non vengono testati. Potrebbero non essere installabili solo con un ambiente Python funzionante e potrebbero richiedere un compilatore C/C++ o programmi aggiuntivi per creare le dipendenze dai sorgenti come parte del processo di installazione. L'assistenza per questi sistemi operativi è solo di tipo "best effort".
Sistemi operativi di livello 3:
- Linux ppc64le (distribuzioni compatibili con la specifica manylinux 2014packaging )
- Linux s390x (distribuzioni compatibili con le specifiche di packaging di manylinux 2014 )

A partire da Qiskit v2.0.0, sono supportate solo le piattaforme a 64 bit e non quelle a 32 bit. Non sarà possibile compilare dai sorgenti su piattaforme a 32 bit, poiché internamente il codice di Qiskit Rust presuppone una larghezza del puntatore di 64 bit.

Passi successivi

Suggerimenti

Configura Qiskit localmente.
Segui i passaggi indicati nella guida Esegui il tuo primo circuito su hardware per scrivere ed eseguire un programma quantistico.
Prova un tutorial su IBM Quantum Learning.
Comprendere la politica di supporto delle versioni.

Questa pagina è stata utile?

Segnala un bug, un errore di battitura o richiedi contenuti su GitHub.