Instalar o Qiskit

Quer você trabalhe localmente ou em um ambiente de nuvem, a primeira etapa para todos os usuários é instalar o Qiskit.

Faça upgrade do Qiskit 0.x para o Qiskit 1.0 e posterior

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

Para aqueles que estão atualizando da versão 0.x para 1.0 ou posterior : observe que, como o Qiskit v1.0 usa uma nova estrutura de empacotamento, não é possível usar pip install -U qiskit para atualizar de qualquer versão do Qiskit 0.x para 1.0.

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

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

Instale o pacote de atualizações de segurança do Windows ( Qiskit SDK )

Instale o Python. Consulte a seção “Linguagem de programação” na página do projeto Qiskit PyPI para verificar quais versões do Python são compatíveis com a versão mais recente. Para obter instruções sobre como fazer o download, consulte o Guia para Iniciantes do Python.

Recomenda-se o uso de ambientes virtuais Python para separar o Qiskit de outros aplicativos.

Note
Estas instruções usam a distribuição padrão Python do pypi.org. No entanto, você pode usar outras distribuições do Python, como o Anaconda ou o miniconda, juntamente com outros fluxos de trabalho de gerenciamento de dependências, como o Poetry.
- Um ambiente virtual Python é um espaço isolado para trabalhar com o Python para uma finalidade específica, de modo que você possa instalar os pacotes que desejar e configurar bibliotecas, dependências e assim por diante, sem afetar o ambiente "básico" do Python em seu computador.
  Uma vantagem importante de um ambiente virtual é que, se o seu ambiente Python for corrompido em algum ponto do caminho, você poderá excluir facilmente o ambiente virtual e começar de novo!
  Escolha um local preferencial para armazenar informações sobre seus ambientes virtuais. Normalmente, eles são armazenados 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 nele.
```
python3 -m venv .venv
```
```
python3 -m venv .venv
```
```
python -m venv .venv
```
Em seguida, ative seu novo ambiente.
```
source .venv/bin/activate
```
```
source .venv/bin/activate
```
Se estiver usando PowerShell:
```
.venv\Scripts\Activate.ps1
```
Se estiver usando o Git Bash:
```
source .venv/scripts/activate
```
Se estiver usando o prompt de comando:
```
.venv\Scripts\activate
```
Instale o pip se ele ainda não estiver instalado em seu ambiente. O Pip é um gerenciador de pacotes Python que você usa para instalar o Qiskit e outros pacotes Python. Use o site pip list para ver o que há em seu ambiente virtual. Na maioria dos ambientes Python, o pip já está instalado.
Instale o pacote de atualizações do Windows ( Qiskit SDK ).
```
pip install qiskit
```
Adicionar suporte à visualização
Se você pretende usar a funcionalidade de visualização ou os notebooks Jupyter, instale também o qiskit.visualization módulo. Consulte a referência da API de visualizações para obter mais informações.

Se quiser executar um notebook Jupyter com os pacotes Qiskit que acabou de instalar, você precisará instalar o Jupyter em seu ambiente.
```
pip install jupyter
```
Em seguida, abra o notebook da seguinte forma:
```
jupyter notebook <path/to/notebook.ipynb>
```

Se você pretende trabalhar localmente e usar os simuladores integrados ao Qiskit, sua instalação já está concluída. Se você deseja executar tarefas nas QPUs d IBM®, continue para configurar sua conta no IBM Cloud®.

Mantenha-se atualizado com as versões mais recentes

Verifique periodicamente as notas de lançamento do Qiskit para ficar a par das novas versões. Recomendamos que você atualize frequentemente qiskit seus requisitos executando pip install -U qiskit.

Resolução de problemas

Se você usou o site pip install qiskit e configurou seu ambiente virtual no Anaconda, então você pode receber o erro No Module 'qiskit' quando executar um tutorial em Jupyter Notebook. Se você não tiver instalado o Qiskit ou configurado seu ambiente virtual, você pode seguir as etapas de instalação.
O erro é causado quando se tenta importar o pacote Qiskit em um ambiente ambiente em que o Qiskit não está instalado. Se você iniciou o Jupyter Notebook a partir do Anaconda- Navigator, é possível que o Jupyter Notebook esteja sendo executado no ambiente básico (raiz), em vez de em seu ambiente virtual virtual. Escolha um ambiente virtual no Anaconda- Navigator no menu suspenso Aplicativos no menu suspenso. Nesse menu, você pode ver todos os ambientes virtuais dentro do Anaconda e você pode selecionar o ambiente em que você tem o Qiskit instalado para iniciar o Jupyter Notebook.
O Qiskit depende de uma série de outros pacotes de código aberto Python, que são instalados automaticamente ao acessar pip install qiskit. Dependendo da da plataforma de seu sistema e da versão do Python, é possível que um determinado não forneça binários pré-criados para seu sistema. Você pode consultar suporte ao sistema operacional para obter uma lista das plataformas suportadas pelo Qiskit, algumas das quais algumas das quais podem precisar de um compilador extra. Nos casos em que não houver não há binários pré-compilados disponíveis, o pip tentará compilar o pacote a partir do código-fonte, o que, por sua vez, pode exigir algumas dependências extras que precisam ser 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 falhou na instalação (no código de exemplo código de exemplo, SOME_PACKAGE) para obter informações sobre como instalar as bibliotecas necessárias para compilar a partir da fonte.

Suporte do sistema operacional

O Qiskit se esforça para oferecer suporte ao maior número possível de sistemas operacionais, mas devido a limitações nos recursos de teste disponíveis e na disponibilidade do sistema operacional, nem todos os sistemas operacionais podem ser suportados. O suporte ao sistema operacional para o Qiskit é dividido em três camadas com diferentes níveis de suporte para cada camada. Para plataformas fora dessas, como FreeBSD ou WebAssembly (WASI), o Qiskit ainda pode ser instalado, 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 é compatível apenas com a implementação CPython da linguagem Python. Não há suporte para a execução com outros intérpretes do site Python, como o PyPy.

Qiskit v2.x

Na série de versões do Qiskit v2.x, as plataformas compatíveis são:

Os sistemas operacionais Tier 1 são totalmente testados como parte dos processos de desenvolvimento para garantir que qualquer alteração proposta funcione corretamente. Os binários pré-compilados são criados, testados e publicados em PyPI como parte do processo de lançamento. Normalmente, desde que haja um ambiente Python em funcionamento instalado, o Qiskit pode ser instalado nesses sistemas operacionais sem a necessidade de instalar outras dependências.
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 de 64 bits (compatível com Windows 10 e posterior)
- Linux AArch64 (distribuições compatíveis com a especificação de empacotamento manylinux 2014 )
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 criados, testados e publicados em PyPI como parte do processo de lançamento, e esses pacotes podem ser instalados apenas com um ambiente Python em funcionamento. Pode haver um atraso no lançamento de pacotes para esses sistemas, uma vez que as falhas nos testes podem não ser detectadas até muito mais tarde, e as falhas durante a publicação não bloquearão a publicação do pacote para sistemas de Nível 1.
Sistemas operacionais de nível 2:
- macOS x86_64 ( 10.12 ou posterior)
Os sistemas operacionais de nível 3 não são testados como parte do processo de desenvolvimento. Os binários pré-compilados são criados e publicados em PyPI como parte do processo de lançamento, mas não são testados. Eles podem não ser instaláveis apenas com um ambiente Python em funcionamento e podem exigir um compilador C/C++ ou programas adicionais para criar dependências a partir da fonte como parte do processo de instalação. O suporte a esses sistemas operacionais é feito apenas com o melhor esforço possível.
Sistemas operacionais de nível 3:
- Linux ppc64le (distribuições compatíveis com a especificação manylinux 2014packaging )
- Linux s390x (distribuições compatíveis com a especificação de empacotamento manylinux 2014 )

A partir do Qiskit v2.0.0, somente as plataformas de 64 bits são compatíveis e as plataformas de 32 bits não são compatíveis. Você não poderá compilar a partir do código-fonte em plataformas de 32 bits, pois internamente o código Qiskit Rust assume uma largura de ponteiro de 64 bits.

Qiskit v1.x

Na série de versões do Qiskit v1.x, as plataformas compatíveis são:

Os sistemas operacionais Tier 1 são totalmente testados como parte dos processos de desenvolvimento para garantir que qualquer alteração proposta funcione corretamente. Os binários pré-compilados são criados, testados e publicados em PyPI como parte do processo de lançamento. Normalmente, desde que haja um ambiente Python em funcionamento instalado, o Qiskit pode ser instalado nesses sistemas operacionais sem a necessidade de instalar outras dependências.
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 de 64 bits (compatível com Windows 10 e posterior)
Os sistemas operacionais de nível 2 não são testados como parte do processo de desenvolvimento. No entanto, os binários pré-compilados são criados, testados e publicados no site PyPI como parte do processo de lançamento, e pode-se esperar que esses pacotes sejam instalados apenas com um ambiente Python em funcionamento.
Sistemas operacionais de nível 2:
- Linux AArch64 (distribuições compatíveis com a especificação de empacotamento manylinux 2014 )
Os sistemas operacionais de nível 3 não são testados como parte do processo de desenvolvimento. Os binários pré-compilados são criados e publicados em PyPI como parte do processo de lançamento, mas não são testados. Eles podem não ser instaláveis apenas com um ambiente Python em funcionamento e podem exigir um compilador C/C++ ou programas adicionais para criar dependências a partir da fonte como parte do processo de instalação. O suporte a esses sistemas operacionais é feito apenas com o melhor esforço possível.
Sistemas operacionais de nível 3:
- Linux ppc64le (distribuições compatíveis com a especificação manylinux 2014packaging )
- 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 de 32 bits

Próximas etapas

Recomendações

Configure o Qiskit localmente.
Siga as etapas do guia Execute seu primeiro circuito no hardware para escrever e executar um programa quântico.
Experimente um tutorial do IBM Quantum Learning.
Entenda a política de suporte a versões.

Esta página foi útil?

Relate um bug, erro de digitação ou solicite conteúdo no GitHub.