Ada beberapa cara menyiapkan lingkungan Anda untuk 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 di mesin lokal, instal paket TFQ menggunakan manajer paket pip Python.
- Atau buat TensorFlow Quantum dari sumber.
TensorFlow Quantum didukung di Python 3.9, 3.10, dan 3.11 dan bergantung langsung pada Cirq .
Paket pip
Persyaratan
- pip 19.0 atau lebih baru (memerlukan dukungan
manylinux2014
) - TensorFlow == 2.15.0
Lihat panduan penginstalan TensorFlow untuk menyiapkan lingkungan pengembangan Python dan lingkungan virtual (opsional).
Tingkatkan versi pip
dan instal TensorFlow
pip3 install --upgrade pip
pip3 install tensorflow==2.15.0
Instal paketnya
Instal rilis stabil terbaru TensorFlow Quantum:
pip3 install -U tensorflow-quantum
Build nightly yang mungkin bergantung pada TensorFlow versi terbaru dapat diinstal dengan:
pip3 install -U tfq-nightly
Bangun dari sumber
Langkah-langkah berikut diuji untuk sistem mirip Ubuntu.
1. Siapkan lingkungan pengembangan Python 3
Pertama kita memerlukan alat 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. Ciptakan lingkungan virtual
Buka direktori ruang kerja Anda dan buat lingkungan virtual untuk pengembangan TFQ.
python3.10 -m venv quantum_env
source quantum_env/bin/activate
3. Instal Bazel
Seperti yang tercantum dalam panduan build TensorFlow dari sumber , sistem build Bazel akan diperlukan.
Pembuatan sumber terbaru kami menggunakan TensorFlow 2.15.0. Untuk memastikan kompatibilitas kami menggunakan bazel
versi 6.5.0. Untuk menghapus versi Bazel yang 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, konfirmasikan pemasangan versi bazel
yang benar:
bazel --version
4. Bangun TensorFlow dari sumber
Di sini kami mengadaptasi instruksi dari build TensorFlow dari panduan sumber , lihat link untuk detail lebih lanjut. TensorFlow Quantum kompatibel dengan TensorFlow versi 2.15.0.
Unduh kode sumber TensorFlow :
git clone https://github.com/tensorflow/tensorflow.git
cd tensorflow
git checkout v2.15.0
Pastikan lingkungan virtual yang Anda buat pada langkah 2 diaktifkan. Lalu, instal dependensi TensorFlow:
pip install -U pip six numpy wheel setuptools mock 'future>=0.17.1'
pip install -U keras_applications --no-deps
pip install -U keras_preprocessing --no-deps
pip install numpy==1.23.5
pip install packaging requests
Konfigurasikan build TensorFlow. Saat ditanya lokasi juru bahasa dan perpustakaan Python, pastikan untuk menentukan lokasi di dalam folder lingkungan virtual Anda. Opsi lainnya dapat dibiarkan pada nilai default.
./configure
Bangun paket TensorFlow (Sejak TF v2.8, _GLIBCXX_USE_CXX11_ABI
disetel ke 1, dan semua kode c++ dikompilasi dengan -std=c++17
):
bazel build -c opt --cxxopt="-O3" --cxxopt="-march=native" --cxxopt="-std=c++17" --cxxopt="-D_GLIBCXX_USE_CXX11_ABI=1" //tensorflow/tools/pip_package:build_pip_package
Setelah build selesai, instal paket dan keluar dari direktori TensorFlow:
./bazel-bin/tensorflow/tools/pip_package/build_pip_package /tmp/tensorflow_pkg
pip install /tmp/tensorflow_pkg/name_of_generated_wheel.whl
cd ..
5. Unduh TensorFlow Quantum
Kami menggunakan alur kerja permintaan fork dan pull standar untuk kontribusi. Setelah melakukan fork dari halaman TensorFlow Quantum GitHub, download sumber fork Anda dan instal persyaratannya:
git clone https://github.com/username/quantum.git
cd quantum
pip install -r requirements.txt
6. Buat paket pip TensorFlow Quantum
Bangun paket pip TensorFlow Quantum dan instal:
./configure.sh
bazel build -c opt --cxxopt="-O3" --cxxopt="-march=native" --cxxopt="-std=c++17" --cxxopt="-D_GLIBCXX_USE_CXX11_ABI=1" release:build_pip_package
bazel-bin/release/build_pip_package /tmp/tfquantum/
python3 -m pip install /tmp/tfquantum/name_of_generated_wheel.whl
Untuk mengonfirmasi bahwa TensorFlow Quantum telah berhasil diinstal, Anda dapat menjalankan pengujian:
./scripts/test_all.sh