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 compile o TensorFlow Quantum a partir do código-fonte.

O TensorFlow Quantum é compatível com Python 3.10, 3.11 e 3.12 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. 

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

Instale o pacote

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

  pip install -U tensorflow-quantum

Compilar a partir do código-fonte

Os passos a seguir foram testados em sistemas do tipo Ubuntu.

1. Configure um ambiente de desenvolvimento Python 3.

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

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

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

Certifique-se de que o ambiente virtual esteja ativado para as etapas restantes abaixo e sempre que você quiser usar o TFQ no futuro.

3. Instale o Bazel

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

Nossas versões mais recentes do código-fonte utilizam o TensorFlow 2.16.2. Para garantir a compatibilidade, utilizamos 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 comando: 

  sudo apt-mark hold bazel

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

  bazel --version

4. Compile o TensorFlow a partir do código-fonte

O TensorFlow Quantum é compatível com a versão 2.16.2 do TensorFlow. Para compilar o TensorFlow a partir do código-fonte, baixe o código-fonte clonando o repositório git e, em seguida, mude para a branch r2.16 : 

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

Certifique-se de que o ambiente virtual criado na etapa 2 esteja ativado e, em seguida, siga as instruções do TensorFlow para compilar e instalar o pacote pip em seu sistema.

Após a conclusão da compilação e a instalação do pacote pip, saia do diretório TensorFlow antes de prosseguir para a etapa 5: 

  cd ..

5. Baixe o TensorFlow Quantum

Utilizamos o fluxo de trabalho padrão de fork e pull request para contribuições. Após fazer um fork a partir da página do TensorFlow Quantum no GitHub, baixe o código-fonte do seu fork e instale os requisitos: 

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

6. Compile e instale o TensorFlow Quantum.

Certifique-se de que o ambiente virtual criado na etapa 2 esteja ativado. Em seguida, execute o comando abaixo para instalar as dependências do TensorFlow Quantum: 

  pip install -r requirements.txt

Em seguida, use o script configure.sh do TensorFlow Quantum para configurar a compilação do TFQ: 

  ./configure.sh

Agora, compile o TensorFlow Quantum: 

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

Após a conclusão da compilação, execute os dois comandos seguintes para criar um pacote Python para o TensorFlow Quantum e gravá-lo em um diretório temporário (neste exemplo, usamos /tmp/tfquantum/ ). Em seguida, instale-o usando o pip: 

  bazel-bin/release/build_pip_package /tmp/tfquantum/
  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