Instalando o Qiskit¶
Requisitos¶
Qiskit suporta Python 3.6 ou posterior. No entanto, tanto o Python quanto o Qiskit estão evoluindo seus ecossistemas, e às vezes quando ocorrem novas versões em um ou outro, pode haver problemas com a compatibilidade.
Se você está tendo problemas instalando ou usando o Qiskit, após atualizar o Python, verifique os metadados do pacote Qiskit para Linguagem de Programação para ver quais versões específicas do Python são suportadas.
Recomendamos a instalação do Anaconda, uma distribuição de Python cross-plataform para computação científica. O Jupyter, incluído no Anaconda, é recomendado para interagir com o Qiskit.
O Qiskit é testado e suportado nos seguintes sistemas 64-bit:
Ubuntu 16.04 ou posterior
macOS 10.12.6 ou posterior
Windows 7 ou superior
Instalação¶
Recomendamos usar os ambientes virtuais do Python para separar o Qiskit de outras aplicações e melhorar sua experiência.
A maneira mais simples de usar os ambientes é usando o comando conda incluído com a Anaconda. Um ambiente Conda permite que você especifique uma versão específica do Python e conjunto de bibliotecas. Abra uma janela de terminal no diretório, onde você deseja trabalhar.
É preferível que você instale o Anaconda prompt junto com o Anaconda. Tudo que você precisa fazer é criar um ambiente virtual dentro do Anaconda, e ativar esse ambiente. Esses comandos podem ser rodados no Anaconda prompt independente de utilizar um computador com Windows ou Linux.
Crie um ambiente mínimo, apenas com o Python instalado nele.
conda create -n name_of_my_env python=3
Ative seu novo ambiente.
conda activate name_of_my_env
Nota
Se você está usando versões do conda anteriores a 4.6, use: Para Linux ou macOS: “source activate nome_do_meu_ambiente” Para Windows: “activate nome_do_meu_ambiente”
Em seguida, instale o pacote Qiskit, que inclui: Terra, Aer, Ignis e Aqua.
pip install qiskit
Nota
A partir do Qiskit 0.13.0, é necessário possuir o pip 19 ou mais recente para instalar o qiskit-aer a partir do binário pré-compilado no Linux. Se você não tiver o pip 19 instalado, você pode executar pip install -U pip para atualizá-lo. Sem o pip 19 ou mais recente, este comando tentará instalar o qiskit-aer a partir do sdist (fonte de distribuição), que tentará compilar o aer localmente de modo transparente.
Se os pacotes instalaram corretamente, você pode executar conda list para ver os pacotes ativos em seu ambiente virtual.
Se você pretende utilizar a funcionalidade de visualização ou Jupyter notebooks, é recomendado instalar qiskit com os requisitos extras de visualização
pip install qiskit[visualization]
Vale a pena ressaltar que se você é um usuário zsh (que é o shell padrão em versões mais recentes do macOS), você vai precisar colocar qiskit[visualization] entre aspas:
pip install 'qiskit[visualization]'
Nota
Depois que você instalou e verificou os pacotes Qiskit que deseja utilizar, importe-os em seu ambiente com Python para começar a trabalhar.
import qiskit
Nota
Se você deseja contribuir com a comunidade Qiskit desenvolvendo e contribuindo com o código Qiskit mais atualizado, consulte Construir pacotes Qiskit da fonte.
Acesso aos Sistemas Quantum IBM¶
IBM Quantum oferece vários computadores quânticos reais e simuladores de computação clássica de alto desempenho através do seu IBM Quantum Lab. Siga estas etapas para configurar o seu ambiente Qiskit para enviar jobs para os sistemas IBM Quantum.
Para configurar sua conta, você precisará criar um arquivo de configuração local que inclua uma chave API
1. Crie uma conta IBM Quantum gratuita.
2. Copie seu token de acesso do painel IBM Quantum.
3. Execute os seguintes comandos para armazenar o seu token API localmente em um arquivo de configuração chamado qiskitrc para uso posterior. Substitua MY_API_TOKEN pelo valor do token API que você armazenou no seu editor de texto.
from qiskit import IBMQ
IBMQ.save_account('MY_API_TOKEN')
Para mais detalhes, tais como gerenciar várias credenciais da IBM Quantum, consulte este tutorial intitulado A conta IBM Quantum.
Verificando Qual Versão está Instalada¶
Uma vez que o pacote Qiskit inclui uma constelação de elementos diferentes, simplesmente obtendo a versão executando qiskit.__version__ pode ser enganoso, pois retorna, apenas, a versão do pacote qiskit-terra. Isto porque o namespace qiskit em Python não vem do pacote Qiskit, mas, em vez disto, faz parte do pacote qiskit-terra.
import qiskit
qiskit.__version__
'0.16.4'
Para ver as versões de todos os elementos Qiskit, em seu ambiente, você pode utilizar o atributo __qiskit_version__. Por exemplo, executar o comando, a seguir, retornará um dicionário, que inclui as versões para cada um dos pacotes Qiskit instalados.
qiskit.__qiskit_version__
{'qiskit-terra': '0.16.4',
'qiskit-aer': '0.7.6',
'qiskit-ignis': '0.5.2',
'qiskit-ibmq-provider': '0.12.2',
'qiskit-aqua': '0.8.2',
'qiskit': '0.24.1'}
Dica
Se você está registrando um problema ou precisando compartilhar as versões do Qiskit instaladas para algum propósito, use o atributo __qiskit_version__.