Instale o TensorFlow Quantum

Existem algumas maneiras de configurar seu ambiente para usar o TensorFlow Quantum (TFQ):

  • A maneira mais fácil de aprender e usar o TFQ não requer instalação: execute os tutoriais do TensorFlow Quantum diretamente no seu navegador usando o Google Colab .
  • Para usar o TensorFlow Quantum em uma máquina local, instale o pacote TFQ usando o gerenciador de pacotes pip do Python.
  • Ou crie o TensorFlow Quantum a partir da fonte.

O TensorFlow Quantum é compatível com Python 3.9, 3.10 e 3.11 e depende diretamente do Cirq .

Pacote pip

Requisitos

Consulte o guia de instalação do TensorFlow para configurar seu ambiente de desenvolvimento Python e um ambiente virtual (opcional).

Atualize pip e instale o TensorFlow 

  pip3 install --upgrade pip
  pip3 install tensorflow==2.15.0

Instale o pacote

Instale a versão estável mais recente do TensorFlow Quantum: 

  pip3 install -U tensorflow-quantum

Compilações noturnas que podem depender da versão mais recente do TensorFlow podem ser instaladas com: 

  pip3 install -U tfq-nightly

Construir a partir da fonte

As etapas a seguir são testadas para sistemas semelhantes ao Ubuntu.

1. Configure um ambiente de desenvolvimento Python 3

Primeiro precisamos das ferramentas de desenvolvimento 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. Crie um ambiente virtual

Vá para o diretório do seu espaço de trabalho e crie um ambiente virtual para desenvolvimento do TFQ. 

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

3. Instale o Bazel

Conforme observado no guia de compilação a partir da fonte do TensorFlow, o sistema de compilação Bazel será necessário.

Nossas compilações de origem mais recentes usam o TensorFlow 2.15.0. Para garantir a compatibilidade, usamos bazel versão 6.5.0. Para remover qualquer versão existente do Bazel: 

  sudo apt-get remove bazel

Baixe e instale bazel versão 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

Para evitar a atualização automática do bazel para uma versão incompatível, execute o seguinte: 

  sudo apt-mark hold bazel

Por fim, confirme a instalação da versão correta bazel : 

  bazel --version

4. Crie o TensorFlow a partir da fonte

Aqui adaptamos as instruções do guia de compilação do código-fonte do TensorFlow, consulte o link para obter mais detalhes. O TensorFlow Quantum é compatível com o TensorFlow versão 2.15.0.

Baixe o código-fonte do TensorFlow :

  git clone https://github.com/tensorflow/tensorflow.git
  cd tensorflow
  git checkout v2.15.0

Certifique-se de que o ambiente virtual criado na etapa 2 esteja ativado. Em seguida, instale as dependências do 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

Configure a compilação do TensorFlow. Quando for solicitado o interpretador Python e os locais da biblioteca, certifique-se de especificar os locais dentro da pasta do seu ambiente virtual. As opções restantes podem ser deixadas com os valores padrão. 

  ./configure

Crie o pacote TensorFlow (desde o TF v2.8, _GLIBCXX_USE_CXX11_ABI está definido como 1 e os códigos c++ são todos compilados com -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

Após a conclusão da compilação, instale o pacote e saia do diretório do 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. Baixe o TensorFlow Quantum

Usamos o fluxo de trabalho padrão de fork e pull request para contribuições. Após a bifurcação na página TensorFlow Quantum GitHub, baixe a origem da bifurcação e instale os requisitos: 

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

6. Crie o pacote pip do TensorFlow Quantum

Crie o pacote pip do TensorFlow Quantum e instale: 

  ./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

Para confirmar se o TensorFlow Quantum foi instalado com sucesso, você pode executar os testes: 

  ./scripts/test_all.sh