Vai al contenuto principale

Installare Qiskit

Che tu lavori in locale o in un ambiente cloud, il primo passo per tutti gli utenti è installare Qiskit.

Aggiornamento da Qiskit 0.x a Qiskit 1.0 e versioni successive

(Se stai installando Qiskit per la prima volta, passa direttamente alla sezione Installa e configura. Questo avviso riguarda solo gli utenti che hanno già installato Qiskit in precedenza.)

Per chi esegue l'aggiornamento dalla versione 0.x alla 1.0 o successiva: tieni presente che, poiché Qiskit v1.0 utilizza una nuova struttura di packaging, non puoi usare pip install -U qiskit per aggiornare da qualsiasi versione Qiskit 0.x alla 1.0.

Consulta la guida alla migrazione di Qiskit 1.0 per dettagli e istruzioni.

Gli aggiornamenti futuri a partire da Qiskit 1.0 consentiranno aggiornamenti in-place.

Installa Qiskit SDK e il client Qiskit Runtime​

  1. Installa Python. Controlla la sezione "Programming Language" nella pagina del progetto Qiskit su PyPI per sapere quali versioni di Python sono supportate dall'ultima release. Per le istruzioni di download, consulta la Guida per principianti di Python.

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

    nota

    Queste istruzioni utilizzano la distribuzione Python standard da pypi.org. Tuttavia, puoi usare altre distribuzioni Python, come Anaconda o miniconda, insieme ad altri workflow di gestione delle dipendenze come Poetry.

    Se non conosci gli ambienti virtuali, clicca qui per maggiori informazioni.

    Un ambiente virtuale Python è uno spazio isolato in cui lavorare con Python per uno scopo specifico — puoi installare i pacchetti che desideri, configurare librerie, dipendenze e così via, senza influenzare l'ambiente Python "base" della tua macchina.

    Un importante vantaggio di un ambiente virtuale è che, se il tuo ambiente Python si corrompe, puoi eliminare l'ambiente virtuale e ricominciare da capo!

    Scegli una posizione preferita in cui conservare le informazioni sui tuoi ambienti virtuali. Di norma vengono salvati in una directory chiamata .venv all'interno di ogni directory di progetto su cui stai lavorando.

    Per prima cosa, vai nella directory del progetto e crea un ambiente minimale con solo Python installato.

    python3 -m venv .venv

    Quindi, attiva il nuovo ambiente.

    source .venv/bin/activate

  2. Installa pip se non è già presente nel tuo ambiente. Pip è un gestore di pacchetti Python che utilizzi per installare Qiskit e altri pacchetti Python. Usa pip list per vedere cosa è presente nel tuo ambiente virtuale. Nella maggior parte degli ambienti Python, pip è già installato.

  3. Installa Qiskit SDK. Se intendi eseguire job su hardware quantistico, installa anche Qiskit Runtime.

    pip install qiskit
    pip install qiskit-ibm-runtime
    Aggiungi il supporto per la visualizzazione

    Se intendi usare funzionalità di visualizzazione o notebook Jupyter, installa anche il modulo qiskit.visualization. Consulta il riferimento API per le visualizzazioni per maggiori informazioni.

  1. Se vuoi eseguire un notebook Jupyter con i pacchetti Qiskit appena installati, devi installare Jupyter nel tuo ambiente.

    pip install jupyter

    Poi apri il notebook nel seguente modo:

    jupyter notebook <path/to/notebook.ipynb>

Se hai intenzione di lavorare in locale e usare i simulatori integrati in Qiskit, l'installazione è completata. Se vuoi eseguire job su QPU IBM, continua con la configurazione del tuo account IBM Cloud.

Resta aggiornato con le ultime versioni

Controlla periodicamente le note di rilascio di Qiskit e le note di rilascio di Qiskit Runtime per conoscere le nuove versioni. Consigliamo di aggiornare frequentemente i requisiti per qiskit e qiskit-ibm-runtime, ad esempio modificando le versioni in requirements.txt con quelle più recenti, e poi eseguendo pip install -r requirements.txt o il comando appropriato per il tuo workflow di gestione delle dipendenze.

Hai bisogno di aiuto? Prova a chiedere a Qiskit Code Assistant.

Risoluzione dei problemi​

Errore "No Module 'qiskit'" con Jupyter Notebook

Se hai usato pip install qiskit e hai configurato il tuo ambiente virtuale in Anaconda, potresti ricevere l'errore No Module 'qiskit' quando esegui un tutorial in Jupyter Notebook. Se non hai ancora installato Qiskit o configurato il tuo ambiente virtuale, puoi seguire i passaggi di installazione.

L'errore si verifica quando si tenta di importare il pacchetto Qiskit in un ambiente in cui Qiskit non è installato. Se hai avviato Jupyter Notebook da Anaconda Navigator, è possibile che Jupyter Notebook sia in esecuzione nell'ambiente base (root), invece che nel tuo ambiente virtuale. Scegli un ambiente virtuale in Anaconda Navigator dal menu a discesa Applications on. In questo menu puoi vedere tutti gli ambienti virtuali presenti in Anaconda e puoi selezionare l'ambiente in cui hai installato Qiskit per avviare Jupyter Notebook.

Errori di compilazione durante l'installazione

Qiskit dipende da numerosi altri pacchetti Python open source, che vengono installati automaticamente con pip install qiskit. A seconda della piattaforma del sistema e della versione di Python, è possibile che un determinato pacchetto non fornisca binari precompilati per il tuo sistema. Puoi fare riferimento a Supporto dei sistemi operativi per un elenco delle piattaforme supportate da Qiskit; alcune di esse potrebbero richiedere un compilatore aggiuntivo. Nei casi in cui non siano disponibili binari precompilati, pip tenterà di compilare il pacchetto dai sorgenti, il che a sua volta potrebbe richiedere alcune dipendenze aggiuntive da installare 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

consulta la documentazione del pacchetto che non è riuscito a installarsi (nell' esempio, SOME_PACKAGE) per informazioni su come installare le librerie necessarie per la compilazione dai sorgenti.

Supporto dei sistemi operativi​

Qiskit si impegna a supportare il maggior numero possibile di sistemi operativi, ma a causa dei limiti nelle risorse di test disponibili e nella disponibilità dei sistemi operativi, non tutti i sistemi operativi possono essere supportati. Il supporto dei sistemi operativi per Qiskit è suddiviso in tre livelli con diversi gradi di supporto per ciascun livello. Per le piattaforme al di fuori di queste, come FreeBSD o WebAssembly (WASI), Qiskit potrebbe comunque essere installabile, ma non è testato e dovrai compilare Qiskit (e probabilmente le sue dipendenze) dai sorgenti.

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

Qiskit v2.x​

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

Livello 1

I sistemi operativi di Livello 1 sono completamente testati come parte del processo di sviluppo per garantire che qualsiasi modifica proposta funzioni correttamente. I binari precompilati vengono creati, testati e pubblicati su PyPI come parte del processo di rilascio. In genere, finché è installato 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 la specifica di packaging manylinux 2014).
  • macOS ARM64 (11.0 o successivo)
  • Windows 64-bit (supportati Windows 10 e versioni successive)
  • Linux AArch64 (distribuzioni compatibili con la specifica di packaging manylinux 2014)

Livello 2

I sistemi operativi di Livello 2 non vengono testati come parte del processo di sviluppo. Tuttavia, i binari precompilati vengono creati, testati e pubblicati su PyPI come parte del processo di rilascio, e ci si aspetta che questi pacchetti possano essere installati con solo un ambiente Python funzionante. Potrebbe esserci un ritardo nel rilascio dei pacchetti per questi sistemi, poiché i fallimenti dei test potrebbero non essere rilevati fino a molto più tardi, e i fallimenti 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)

Livello 3

I sistemi operativi di Livello 3 non vengono testati come parte 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 con solo un ambiente Python funzionante e potrebbero richiedere un compilatore C/C++ o programmi aggiuntivi per compilare le dipendenze dai sorgenti durante l'installazione. Il supporto per questi sistemi operativi è esclusivamente di tipo best effort.

Sistemi operativi di Livello 3:

  • Linux ppc64le (distribuzioni compatibili con la specifica di packaging manylinux 2014)
  • Linux s390x (distribuzioni compatibili con la specifica di packaging manylinux 2014)

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

Qiskit v1.x​

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

Livello 1

I sistemi operativi di Livello 1 sono completamente testati come parte del processo di sviluppo per garantire che qualsiasi modifica proposta funzioni correttamente. I binari precompilati vengono creati, testati e pubblicati su PyPI come parte del processo di rilascio. In genere, finché è installato 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 la specifica di packaging manylinux 2014).
  • macOS x86_64 (10.12 o successivo)
  • macOS ARM64 (11.0 o successivo)
  • Windows 64-bit (supportati Windows 10 e versioni successive)

Livello 2

I sistemi operativi di Livello 2 non vengono testati come parte del processo di sviluppo. Tuttavia, i binari precompilati vengono creati, testati e pubblicati su PyPI come parte del processo di rilascio, e ci si aspetta che questi pacchetti possano essere installati con solo un ambiente Python funzionante.

Sistemi operativi di Livello 2:

  • Linux AArch64 (distribuzioni compatibili con la specifica di packaging manylinux 2014)

Livello 3

I sistemi operativi di Livello 3 non vengono testati come parte 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 con solo un ambiente Python funzionante e potrebbero richiedere un compilatore C/C++ o programmi aggiuntivi per compilare le dipendenze dai sorgenti durante l'installazione. Il supporto per questi sistemi operativi è esclusivamente di tipo best effort.

Sistemi operativi di Livello 3:

  • Linux ppc64le (distribuzioni compatibili con la specifica di packaging manylinux 2014)
  • Linux s390x (distribuzioni compatibili con la specifica di packaging manylinux 2014)
  • Linux i686 (distribuzioni compatibili con la specifica di packaging manylinux 2014)
  • Windows 10 32-bit

Passi successivi​

Raccomandazioni