Ada beberapa cara menyiapkan lingkungan Anda untuk menggunakan TensorFlow Quantum (TFQ):
- Cara termudah untuk mempelajari dan menggunakan TFQ tidak memerlukan penginstalan—jalankan tutorial TensorFlow Quantum langsung di browser Anda menggunakan Google Colab .
- Untuk menggunakan TensorFlow Quantum di mesin lokal, instal paket TFQ menggunakan pengelola paket pip Python.
- Atau buat TensorFlow Quantum dari sumber.
TensorFlow Quantum didukung pada Python 3.7, 3.8, dan 3.9 dan bergantung langsung pada Cirq .
Paket pip
Persyaratan
- pip 19.0 atau lebih baru (memerlukan dukungan
manylinux2010
) - TensorFlow == 2.11.0
Lihat panduan penginstalan TensorFlow untuk menyiapkan lingkungan pengembangan Python dan lingkungan virtual (opsional).
Tingkatkan pip
dan pasang TensorFlow
pip3 install --upgrade pip
pip3 install tensorflow==2.11.0
Instal paketnya
Instal rilis stabil TensorFlow Quantum terbaru:
pip3 install -U tensorflow-quantum
Build nightly yang mungkin bergantung pada versi TensorFlow yang lebih baru dapat diinstal dengan:
pip3 install -U tfq-nightly
Membangun dari sumber
Langkah-langkah berikut diuji untuk sistem mirip Ubuntu.
1. Siapkan lingkungan pengembangan Python 3
Pertama kita membutuhkan alat pengembangan Python 3.8.
sudo apt update
sudo apt-get install pkg-config zip g++ zlib1g-dev unzip python3.8
sudo apt install python3.8 python3.8-dev python3.8-venv python3-pip
python3.8 -m pip install --upgrade pip
2. Ciptakan lingkungan virtual
Buka direktori ruang kerja Anda dan buat lingkungan virtual untuk pengembangan TFQ.
python3.8 -m venv quantum_env
source quantum_env/bin/activate
3. Pasang Bazel
Seperti disebutkan dalam build TensorFlow dari panduan sumber , sistem build Bazel akan diperlukan.
Build sumber terbaru kami menggunakan TensorFlow 2.11.0. Untuk memastikan kompatibilitas, kami menggunakan bazel
versi 5.3.0. Untuk menghapus versi Bazel yang ada:
sudo apt-get remove bazel
Unduh dan instal bazel
versi 5.3.0:
wget https://github.com/bazelbuild/bazel/releases/download/5.3.0/bazel_5.3.0-linux-x86_64.deb
sudo dpkg -i bazel_5.3.0-linux-x86_64.deb
Untuk mencegah pembaruan otomatis bazel
ke versi yang tidak kompatibel, jalankan perintah berikut:
sudo apt-mark hold bazel
Terakhir, konfirmasi pemasangan versi bazel
yang benar:
bazel --version
4. Bangun TensorFlow dari sumber
Di sini kami mengadaptasi instruksi dari build TensorFlow dari panduan sumber , lihat tautan untuk detail lebih lanjut. TensorFlow Quantum kompatibel dengan TensorFlow versi 2.11.0.
Unduh kode sumber TensorFlow :
git clone https://github.com/tensorflow/tensorflow.git
cd tensorflow
git checkout v2.11.0
Pastikan lingkungan virtual yang Anda buat pada langkah 2 diaktifkan. Kemudian, 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.24.2
pip install packaging requests
Konfigurasikan build TensorFlow. Saat ditanya lokasi juru bahasa dan pustaka Python, pastikan untuk menentukan lokasi di dalam folder lingkungan virtual Anda. Opsi yang tersisa dapat dibiarkan pada nilai default.
./configure
Bangun paket TensorFlow (Karena TF v2.8, _GLIBCXX_USE_CXX11_ABI
diatur 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 tinggalkan 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 fork dan pull request standar untuk kontribusi. Setelah melakukan fork dari halaman TensorFlow Quantum GitHub, unduh sumber fork Anda dan instal persyaratannya:
git clone https://github.com/username/quantum.git
cd quantum
pip install -r requirements.txt
6. Bangun paket pip TensorFlow Quantum
Build 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