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
- pip 19.0 atau lebih baru (membutuhkan dukungan
manylinux2014) - TensorFlow == 2.16.2
Lihat panduan instalasi TensorFlow untuk menyiapkan lingkungan pengembangan Python Anda dan lingkungan virtual (opsional).
Perbarui pip dan instal TensorFlow
pip install --upgrade pippip 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 updatesudo apt-get install pkg-config zip g++ zlib1g-dev unzip python3.10sudo apt install python3.10 python3.10-dev python3.10-venv python3-pippython3.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_envsource 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.debsudo 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.gitcd tensorflowgit 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.gitcd quantumpip 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