Instal TensorFlow Quantum

Ada beberapa cara untuk menyiapkan lingkungan Anda agar dapat menggunakan TensorFlow Quantum (TFQ):

  • Cara termudah untuk mempelajari dan menggunakan TFQ tidak memerlukan instalasi—jalankan tutorial TensorFlow Quantum langsung di browser Anda menggunakan Google Colab .
  • Untuk menggunakan TensorFlow Quantum pada mesin lokal, instal paket TFQ menggunakan pengelola paket pip Python.
  • Atau bangun TensorFlow Quantum dari kode sumber.

TensorFlow Quantum didukung pada Python 3.10, 3.11, dan 3.12 dan bergantung langsung pada Cirq .

Paket Pip

Persyaratan

Lihat panduan instalasi TensorFlow untuk menyiapkan lingkungan pengembangan Python Anda dan lingkungan virtual (opsional).

Perbarui pip dan instal TensorFlow

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

Instal paketnya

Instal versi stabil terbaru dari TensorFlow Quantum:

  pip install -U tensorflow-quantum

Membangun dari sumber

Langkah-langkah berikut telah diuji pada sistem yang mirip dengan Ubuntu.

1. Siapkan lingkungan pengembangan Python 3

Pertama-tama kita membutuhkan perangkat pengembangan 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. Buat lingkungan virtual

Masuk ke direktori ruang kerja Anda dan buat lingkungan virtual untuk pengembangan TFQ.

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

Pastikan lingkungan virtual diaktifkan untuk langkah-langkah selanjutnya di bawah ini, dan setiap kali Anda ingin menggunakan TFQ di masa mendatang.

3. Instal Bazel

Seperti yang disebutkan dalam panduan membangun TensorFlow dari kode sumber , sistem pembangunan Bazel akan dibutuhkan.

Versi kode sumber terbaru kami menggunakan TensorFlow 2.16.2. Untuk memastikan kompatibilitas, kami menggunakan bazel versi 6.5.0. Untuk menghapus versi Bazel yang sudah ada:

  sudo apt-get remove bazel

Unduh dan instal bazel versi 6.5.0:

  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

Untuk mencegah pembaruan otomatis bazel ke versi yang tidak kompatibel, jalankan perintah berikut:

  sudo apt-mark hold bazel

Terakhir, pastikan instalasi versi bazel yang benar telah terpasang:

  bazel --version

4. Membangun TensorFlow dari kode sumber

TensorFlow Quantum kompatibel dengan TensorFlow versi 2.16.2. Untuk membangun TensorFlow dari kode sumber, unduh kode sumber TensorFlow dengan mengkloning repositori git, lalu beralih ke cabang r2.16 :

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

Pastikan lingkungan virtual yang Anda buat pada langkah 2 telah diaktifkan, lalu ikuti petunjuk TensorFlow tentang cara membangun dan menginstal paket pip pada sistem Anda.

Setelah proses build selesai dan Anda telah menginstal paket pip, keluar dari direktori TensorFlow sebelum melanjutkan ke langkah 5:

  cd ..

5. Unduh TensorFlow Quantum

Kami menggunakan alur kerja fork dan pull request standar untuk kontribusi. Setelah melakukan fork dari halaman GitHub TensorFlow Quantum , unduh kode sumber fork Anda dan instal persyaratannya:

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

6. Bangun dan instal TensorFlow Quantum

Pastikan lingkungan virtual yang Anda buat pada langkah 2 telah diaktifkan. Kemudian, jalankan perintah di bawah ini untuk menginstal dependensi TensorFlow Quantum:

  pip install -r requirements.txt

Selanjutnya, gunakan skrip configure.sh TensorFlow Quantum untuk mengkonfigurasi build TFQ:

  ./configure.sh

Sekarang, bangun TensorFlow Quantum:

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

Setelah proses build selesai, jalankan dua perintah berikut untuk membuat paket Python untuk TensorFlow Quantum dan menuliskannya ke direktori sementara (dalam contoh ini kita menggunakan /tmp/tfquantum/ ), kemudian instal menggunakan pip:

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

Untuk memastikan bahwa TensorFlow Quantum telah berhasil diinstal, Anda dapat menjalankan pengujian berikut:

  ./scripts/test_all.sh