Installa TensorFlow Quantum

Esistono diversi modi per configurare l'ambiente per utilizzare TensorFlow Quantum (TFQ):

  • Il modo più semplice per imparare e utilizzare TFQ non richiede installazione: esegui i tutorial di TensorFlow Quantum direttamente nel tuo browser utilizzando Google Colab .
  • Per utilizzare TensorFlow Quantum su una macchina locale, installare il pacchetto TFQ utilizzando il gestore di pacchetti pip di Python.
  • Oppure compila TensorFlow Quantum dal codice sorgente.

TensorFlow Quantum è supportato su Python 3.10, 3.11 e 3.12 e dipende direttamente da Cirq .

Pacchetto Pip

Requisiti

Consulta la guida all'installazione di TensorFlow per configurare l'ambiente di sviluppo Python e un ambiente virtuale (facoltativo).

Aggiorna pip e installa TensorFlow 

  pip install --upgrade pip
  pip install tensorflow==2.16.2

Installa il pacchetto

Installa l'ultima versione stabile di TensorFlow Quantum: 

  pip install -U tensorflow-quantum

Compila dal codice sorgente

I seguenti passaggi sono stati testati per sistemi simili a Ubuntu.

1. Impostare un ambiente di sviluppo Python 3

Per prima cosa abbiamo bisogno degli strumenti di sviluppo Python 3.10. 

  sudo apt update
  sudo apt-get install pkg-config zip g++ zlib1g-dev unzip python3.10
  sudo apt install python3.10 python3.10-dev python3.10-venv python3-pip
  python3.10 -m pip install --upgrade pip

2. Creare un ambiente virtuale

Vai alla directory del tuo spazio di lavoro e crea un ambiente virtuale per lo sviluppo TFQ. 

  python3.10 -m venv quantum_env
  source quantum_env/bin/activate

Assicurati che l'ambiente virtuale sia attivato per tutti i passaggi successivi e ogni volta che vorrai utilizzare TFQ in futuro.

3. Installa Bazel

Come indicato nella guida alla compilazione di TensorFlow dalla sorgente , sarà necessario il sistema di compilazione Bazel .

Le nostre ultime build sorgente utilizzano TensorFlow 2.16.2. Per garantire la compatibilità, utilizziamo la versione 6.5.0 bazel . Per rimuovere qualsiasi versione esistente di Bazel: 

  sudo apt-get remove bazel

Scarica e installa la versione 6.5.0 bazel : 

  wget https://github.com/bazelbuild/bazel/releases/download/6.5.0/bazel_6.5.0-linux-x86_64.deb

  sudo dpkg -i bazel_6.5.0-linux-x86_64.deb

Per impedire l'aggiornamento automatico di bazel a una versione incompatibile, eseguire quanto segue: 

  sudo apt-mark hold bazel

Infine, confermare l'installazione della versione corretta bazel : 

  bazel --version

4. Compila TensorFlow dal codice sorgente

TensorFlow Quantum è compatibile con TensorFlow versione 2.16.2. Per compilare TensorFlow dai sorgenti, scarica il codice sorgente di TensorFlow clonando il repository git, quindi passa al branch r2.16 : 

  git clone https://github.com/tensorflow/tensorflow.git
  cd tensorflow
  git checkout r2.16

Assicurati che l'ambiente virtuale creato nel passaggio 2 sia attivato, quindi segui le istruzioni di TensorFlow su come compilare e installare il pacchetto pip sul tuo sistema.

Una volta completata la build e installato il pacchetto pip, uscire dalla directory TensorFlow prima di passare al passaggio 5: 

  cd ..

5. Scarica TensorFlow Quantum

Utilizziamo il flusso di lavoro standard per fork e pull request per i contributi. Dopo aver effettuato il fork dalla pagina GitHub di TensorFlow Quantum , scarica il codice sorgente del fork e installa i requisiti: 

  git clone https://github.com/username/quantum.git
  cd quantum
  pip install -r requirements.txt

6. Compila e installa TensorFlow Quantum

Assicurati che l'ambiente virtuale creato nel passaggio 2 sia attivato. Quindi, esegui il comando seguente per installare le dipendenze di TensorFlow Quantum: 

  pip install -r requirements.txt

Successivamente, utilizzare lo script configure.sh di TensorFlow Quantum per configurare la build TFQ: 

  ./configure.sh

Ora compila TensorFlow Quantum: 

  bazel build -c opt --cxxopt="-O3" --cxxopt="-march=native" release:build_pip_package

Una volta completata la compilazione, esegui i due comandi successivi per creare un pacchetto Python per TensorFlow Quantum e scrivilo in una directory temporanea (in questo esempio utilizziamo /tmp/tfquantum/ ), quindi installalo utilizzando pip: 

  bazel-bin/release/build_pip_package /tmp/tfquantum/
  pip install /tmp/tfquantum/name_of_generated_wheel.whl

Per confermare che TensorFlow Quantum è stato installato correttamente, puoi eseguire i test: 

  ./scripts/test_all.sh