Instalar o Qiskit

Seja trabalhando localmente ou em um ambiente na nuvem, o primeiro passo para todos os usuários é instalar o Qiskit.

Atualização do Qiskit 0.x para o Qiskit 1.0 e versões posteriores

(Se você está instalando o Qiskit pela primeira vez, pule para a seção Instalar e configurar. Este aviso é relevante apenas para usuários que já instalaram o Qiskit anteriormente.)

Para quem está atualizando da versão 0.x para 1.0 ou posterior: observe que, como o Qiskit v1.0 usa uma nova estrutura de empacotamento, você não pode usar pip install -U qiskit para atualizar de qualquer versão 0.x do Qiskit para a 1.0.

Consulte o guia de migração do Qiskit 1.0 para detalhes e instruções.

Atualizações futuras a partir do Qiskit 1.0 permitirão atualizações no local.

Instalar o SDK do Qiskit e o cliente Qiskit Runtime

1. Instale o Python. Verifique a seção "Programming Language" na página do projeto Qiskit no PyPI para saber quais versões do Python são suportadas pela versão mais recente. Para instruções de download, consulte o Guia para Iniciantes em Python.

   É recomendado que você use ambientes virtuais do Python para separar o Qiskit de outras aplicações.

   nota

   Estas instruções usam a distribuição padrão do Python do pypi.org. No entanto, você pode usar outras distribuições do Python, como Anaconda ou miniconda, junto com outros fluxos de trabalho de gerenciamento de dependências, como o Poetry.

   Se você é novo em ambientes virtuais, clique aqui para mais informações.

   Um ambiente virtual Python é um espaço isolado para trabalhar com Python para um propósito específico — assim você pode instalar os pacotes que quiser e configurar bibliotecas, dependências, entre outros, sem afetar o ambiente Python "base" da sua máquina.

   Uma vantagem importante de um ambiente virtual é que, se o seu ambiente Python ficar corrompido em algum momento, você pode simplesmente deletar o ambiente virtual e começar de novo!

   Escolha um local de sua preferência para armazenar as informações sobre seus ambientes virtuais. Normalmente eles ficam em um diretório chamado .venv dentro de cada diretório de projeto em que você está trabalhando.

   Primeiro, navegue até o diretório do seu projeto e crie um ambiente mínimo com apenas o Python instalado.

   macOS

   python3 -m venv .venv

   Linux

   python3 -m venv .venv

   Windows

   python -m venv .venv

   Em seguida, ative seu novo ambiente.

   macOS

   source .venv/bin/activate

   Linux

   source .venv/bin/activate

   Windows

   Se estiver usando PowerShell:

   .venv\Scripts\Activate.ps1

   Se estiver usando Git Bash:

   source .venv/scripts/activate

   Se estiver usando o prompt de comando:

   .venv\Scripts\activate

2. Instale o pip caso ele ainda não esteja instalado no seu ambiente. O pip é um gerenciador de pacotes Python que você usa para instalar o Qiskit e outros pacotes Python. Use pip list para ver o que está no seu ambiente virtual. Na maioria dos ambientes Python, o pip já vem instalado.

3. Instale o SDK do Qiskit. Se você planeja executar jobs em hardware quântico, instale também o Qiskit Runtime.

   pip install qiskit

   pip install qiskit-ibm-runtime

   Adicionar suporte a visualizações

   Se você pretende usar funcionalidades de visualização ou notebooks Jupyter, instale também o módulo qiskit.visualization. Consulte a referência da API de Visualizações para mais informações.

1. Se você quiser executar um notebook Jupyter com os pacotes do Qiskit que acabou de instalar, precisa instalar o Jupyter no seu ambiente.

   pip install jupyter

   Em seguida, abra seu notebook da seguinte forma:

   jupyter notebook <path/to/notebook.ipynb>

Se você planeja trabalhar localmente e usar os simuladores integrados ao Qiskit, a instalação está concluída. Se quiser executar jobs em QPUs da IBM, continue para configurar sua conta IBM Cloud.

Mantenha-se atualizado com as versões mais recentes

Verifique periodicamente as notas de versão do Qiskit e as notas de versão do Qiskit Runtime para acompanhar novos lançamentos. Recomendamos atualizar frequentemente os requisitos de qiskit e qiskit-ibm-runtime, por exemplo, alterando as versões no requirements.txt para as versões mais recentes e depois executando pip install -r requirements.txt ou o comando apropriado para o seu fluxo de trabalho de gerenciamento de dependências.

Need help? Try asking Qiskit Code Assistant.

Solução de problemas

Erro "No Module 'qiskit'" com Jupyter Notebook

Se você usou pip install qiskit e configurou seu ambiente virtual no Anaconda, pode receber o erro No Module 'qiskit' ao executar um tutorial no Jupyter Notebook. Se você não instalou o Qiskit ou não configurou seu ambiente virtual, siga as etapas de instalação.

O erro ocorre ao tentar importar o pacote Qiskit em um ambiente onde o Qiskit não está instalado. Se você iniciou o Jupyter Notebook pelo Anaconda-Navigator, é possível que o Jupyter Notebook esteja sendo executado no ambiente base (root), em vez do seu ambiente virtual. Escolha um ambiente virtual no Anaconda-Navigator pelo menu suspenso Applications on. Nesse menu, você pode ver todos os ambientes virtuais do Anaconda e selecionar o ambiente onde você instalou o Qiskit para iniciar o Jupyter Notebook.

Erros de compilação durante a instalação

O Qiskit depende de vários outros pacotes Python de código aberto, que são instalados automaticamente ao executar pip install qiskit. Dependendo da plataforma do seu sistema e da versão do Python, é possível que um determinado pacote não forneça binários pré-compilados para o seu sistema. Você pode consultar Suporte a sistemas operacionais para ver uma lista de plataformas suportadas pelo Qiskit, algumas das quais podem precisar de um compilador adicional. Nos casos em que não há binários pré-compilados disponíveis, o pip tentará compilar o pacote a partir do código-fonte, o que pode exigir algumas dependências extras que precisam ser instaladas manualmente.

Se a saída de pip install qiskit contiver linhas semelhantes a:

Failed building wheel for SOME_PACKAGE
...
build/temp.linux-x86_64-3.5/_openssl.c:498:30: fatal error
compilation terminated.
error: command 'x86_64-linux-gnu-gcc' failed with exit status 1

verifique a documentação do pacote que não foi instalado (no código de exemplo, SOME_PACKAGE) para obter informações sobre como instalar as bibliotecas necessárias para compilar a partir do código-fonte.

Suporte a sistemas operacionais

O Qiskit se esforça para suportar o maior número possível de sistemas operacionais, mas devido a limitações de recursos de teste disponíveis e à disponibilidade dos sistemas operacionais, nem todos podem ser suportados. O suporte a sistemas operacionais do Qiskit é dividido em três níveis com diferentes graus de suporte para cada um. Para plataformas fora desses níveis, como FreeBSD ou WebAssembly (WASI), o Qiskit ainda pode ser instalável, mas não é testado e você terá que compilar o Qiskit (e provavelmente as dependências do Qiskit) a partir do código-fonte.

Além disso, o Qiskit suporta apenas a implementação CPython da linguagem Python. A execução com outros interpretadores Python, como o PyPy, não é suportada.

Qiskit v2.x

Na série de versões Qiskit v2.x, as plataformas suportadas são:

Nível 1

Os sistemas operacionais de Nível 1 são totalmente testados como parte dos processos de desenvolvimento para garantir que qualquer alteração proposta funcione corretamente. Binários pré-compilados são construídos, testados e publicados no PyPI como parte do processo de lançamento. Normalmente, desde que haja um ambiente Python funcionando instalado, o Qiskit pode ser instalado nesses sistemas operacionais sem a necessidade de instalar dependências adicionais.

Sistemas operacionais de Nível 1:

• Linux x86_64 (distribuições compatíveis com a especificação de empacotamento manylinux 2014).
• macOS ARM64 (11.0 ou mais recente)
• Windows 64-bit (Windows 10 e posteriores suportados)
• Linux AArch64 (distribuições compatíveis com a especificação de empacotamento manylinux 2014)

Nível 2

Os sistemas operacionais de Nível 2 não são testados como parte do processo de desenvolvimento. No entanto, binários pré-compilados são construídos, testados e publicados no PyPI como parte do processo de lançamento, e esses pacotes podem ser instalados com apenas um ambiente Python funcionando. Pode haver um atraso no lançamento de pacotes para esses sistemas, pois falhas nos testes podem não ser detectadas até muito mais tarde, e falhas durante a publicação não bloquearão a publicação do pacote para os sistemas de Nível 1.

Sistemas operacionais de Nível 2:

• macOS x86_64 (10.12 ou posterior)

Nível 3

Os sistemas operacionais de Nível 3 não são testados como parte do processo de desenvolvimento. Binários pré-compilados são construídos e publicados no PyPI como parte do processo de lançamento, mas não são testados. Podem não ser instaláveis apenas com um ambiente Python funcionando e podem exigir um compilador C/C++ ou programas adicionais para compilar dependências a partir do código-fonte durante o processo de instalação. O suporte para esses sistemas operacionais é de melhor esforço apenas.

Sistemas operacionais de Nível 3:

• Linux ppc64le (distribuições compatíveis com a especificação de empacotamento manylinux 2014)
• Linux s390x (distribuições compatíveis com a especificação de empacotamento manylinux 2014)

A partir do Qiskit v2.0.0, apenas plataformas de 64 bits são suportadas e plataformas de 32 bits não são suportadas. Você também não conseguirá compilar a partir do código-fonte em plataformas de 32 bits, pois internamente o código Rust do Qiskit assume um tamanho de ponteiro de 64 bits.

Qiskit v1.x

Na série de versões Qiskit v1.x, as plataformas suportadas são:

Nível 1

Os sistemas operacionais de Nível 1 são totalmente testados como parte dos processos de desenvolvimento para garantir que qualquer alteração proposta funcione corretamente. Binários pré-compilados são construídos, testados e publicados no PyPI como parte do processo de lançamento. Normalmente, desde que haja um ambiente Python funcionando instalado, o Qiskit pode ser instalado nesses sistemas operacionais sem a necessidade de instalar dependências adicionais.

Sistemas operacionais de Nível 1:

• Linux x86_64 (distribuições compatíveis com a especificação de empacotamento manylinux 2014).
• macOS x86_64 (10.12 ou posterior)
• macOS ARM64 (11.0 ou mais recente)
• Windows 64-bit (Windows 10 e posteriores suportados)

Nível 2

Os sistemas operacionais de Nível 2 não são testados como parte do processo de desenvolvimento. No entanto, binários pré-compilados são construídos, testados e publicados no PyPI como parte do processo de lançamento, e esses pacotes podem ser instalados com apenas um ambiente Python funcionando.

Sistemas operacionais de Nível 2:

• Linux AArch64 (distribuições compatíveis com a especificação de empacotamento manylinux 2014)

Nível 3

Os sistemas operacionais de Nível 3 não são testados como parte do processo de desenvolvimento. Binários pré-compilados são construídos e publicados no PyPI como parte do processo de lançamento, mas não são testados. Podem não ser instaláveis apenas com um ambiente Python funcionando e podem exigir um compilador C/C++ ou programas adicionais para compilar dependências a partir do código-fonte durante o processo de instalação. O suporte para esses sistemas operacionais é de melhor esforço apenas.

Sistemas operacionais de Nível 3:

• Linux ppc64le (distribuições compatíveis com a especificação de empacotamento manylinux 2014)
• Linux s390x (distribuições compatíveis com a especificação de empacotamento manylinux 2014)
• Linux i686 (distribuições compatíveis com a especificação de empacotamento manylinux 2014)
• Windows 10 32-bit

Próximos passos

Recomendações

• Configure sua conta IBM Cloud.

• Configure o Qiskit localmente.

• Siga os passos em Hello world para escrever e executar um programa quântico.

• Experimente um tutorial do IBM Quantum Learning.