Primeiros Passos#

Instalação#

Vamos começar a usar o Qiskit! O primeiro passo é escolher como você irá rodar e instalar os pacotes. Existem três maneiras principais para fazer isto:

Qiskit suporta Python 3.7 ou superior. Contudo, tanto o Python quanto o Qiskit são ecosistemas que estão em constante evolução, e as vezes, com novos lançamentos em um ou no outro, alguns problemas de compatibilidade podem surgir.

Você precisará baixar Python em seu sistema local para começar. Jupyter é recomendado para interagir com o Qiskit.

Recomendamos o uso de ambientes virtuais Python para separar o Qiskit de outros aplicativos e melhorar sua experiência.

Crie um ambiente mínimo com apenas o Python instalado.

python3 -m venv /path/to/virtual/environment

Ative seu novo ambiente.

source /path/to/virtual/environment/bin/activate

Observação: se você estiver usando o Windows, use os seguintes comandos no PowerShell.

python3 -m venv c:\path\to\virtual\environment
c:\path\to\virtual\environment\Scripts\Activate.ps1

Em seguida, instale o pacote Qiskit.

pip install qiskit

Se os pacotes foram instalados corretamente, você pode executar pip list para ver os pacotes ativos em seu ambiente virtual.

Se você pretende usar a funcionalidade de visualização ou notebooks Jupyter, é recomendável instalar o Qiskit com suporte extra à visualização:

pip install qiskit[visualization]

Vale ressaltar que se você for um usuário zsh (que é o shell padrão nas versões mais recentes do macOS), você precisará colocar qiskit[visualization] entre aspas:

pip install 'qiskit[visualization]'

Os seguintes fornecedores de nuvem têm o Qiskit pré-instalado em seus ambientes:

IBM Quantum Lab

Build quantum applications and experiments with Qiskit in a cloud programming environment.

Strangeworks

A platform that enables users and organizations to easily apply quantum computing to their most pressing problems and research.

Installing Qiskit from source allows you to access the current development version, instead of using the version in the Python Package Index (PyPI) repository. This will give you the ability to inspect and extend the latest version of the Qiskit code more efficiently.

Begin by making a new virtual environment and activating it:

python3 -m venv QiskitDevenv
source QiskitDevenv/bin/activate

A instalação a partir da fonte requer que você tenha o compilador Rust em seu sistema. Para instalar o compilador Rust, o caminho recomendado é usar rustup, que é um instalador Rust multiplataforma. Para usar o rustup, você pode acessar:

https://rustup.rs/

que fornecerá instruções sobre como instalar o rust em sua plataforma. Além do rustup, também existem outros métodos de instalação disponíveis.

Once the Rust compiler is installed, you are ready to install Qiskit.

  1. Clone the Qiskit repository.

    git clone https://github.com/Qiskit/qiskit-terra.git

  2. Clonar o repositório criará uma pasta local chamada qiskit-terra.

    cd qiskit-terra

  3. Se você quiser executar testes ou análise de código, instale os requisitos de desenvolvedor.

    pip install -r requirements-dev.txt

  4. Instale o qiskit-terra.

    pip install .

Se você quiser instalá-lo em modo editável, o que significa que as alterações ao código no projeto não requerem que uma reinstalação seja aplicada, você pode fazer isso com:

pip install -e .

A instalação no modo editável criará as extensões compiladas no modo de depuração sem otimizações. Isso afetará o desempenho do tempo de execução do código compilado. Se você quiser usar o modo editável e construir o código compilado na versão com otimizações habilitadas, você pode executar:

python setup.py build_rust --release --inplace

depois de executar o pip e isso reconstruirá o binário no modo de liberação. Se você estiver trabalhando no código Rust no Qiskit, precisará reconstruir o código de extensão sempre que fizer uma alteração local. pip install -e . apenas construirá a extensão Rust quando ela for chamada, então qualquer alteração local que você fizer no código Rust após executar o pip não será refletida no pacote instalado, a menos que você reconstrua a extensão. Você pode usar o comando build_rust acima para fazer isso (com ou sem --release dependendo se você deseja compilar em modo de depuração ou modo de lançamento).

You can then run the code examples after installing Qiskit. You can run the example with the following command.

python examples/python/using_qiskit_terra_level_0.py

Suporte de Plataforma#

O Qiskit se esforça para dar suporte ao máximo possível de plataformas, mas devido às limitações em recursos de testagem e disponibilidade das plataformas, nem todas têm suporte. O suporte para o Qiskit é dividido em 3 camadas com diferentes níveis de suporte. Para plataformas que não sejam essas, é provável que seja possível instalar o Qiskit, mas ele não é testado, e você precisará compilá-lo (e provavelmente suas dependências) diretamente da fonte.

Além disso, o Qiskit apenas dá suporte ao CPython. Rodar outros interpretadores de Python não é suportado atualmente.

Camada 1#

Plataformas com suporte na camada 1 são completamente testadas antes como parte de processos de desenvolvimento para garantir que quaisquer mudanças propostas funcionem corretamente. Binários pré-compilados são construídos, testados, e publicados no PyPI como parte do processo de lançamento. Espera-se que tais plataformas sejam instaláveis usando-se apenas um ambiente Python ativo, já que todas as dependências estão disponíveis nessas plataformas.

Plataformas da camada 1 atualmente são:

  • Linux x86_64 (distributions compatible with the manylinux 2014 packaging specification).

  • macOS x86_64 (10.9 ou mais recente)

  • Windows 64 bit

Camada 2#

Plataformas da camada 2 não são testadas previamente no desenvolvimento. No entanto, binários pré-compilados são construídos, testados, e publicados no PyPI como parte do processo de lançamento, e espera-se que esses pacotes possam ser instalados com apenas um ambiente Python ativo.

Plataformas da camada 2 atualmente são:

  • Linux i686 (distribuições compatíveis com a especificação de pacote manylinux 2014) para Python < 3.10

  • Windows 32 bit para Python < 3.10

  • Linux aarch64 (distribuições compatíveis com a especificação de pacotes manylinux 2014 <https://www.python.org/dev/peps/pep-0599/>)

Camada 3#

Plataformas da camada 3 não são testadas previamente no desenvolvimento. Binários pré-compilados são construídos e publicados no PyPI como parte do processo de lançamento, mas sem nenhuma testagem. Eles podem não ser instaláveis com apenas um ambiente ativo Python e podem requerer um compilador de C/C++ ou programas adicionais para construir dependências direto das fontes, como parte do processo de instalação. Suporte para essas plataformas não é garantido.

Plataformas da camada 3 atualmente são:

  • Linux ppc64le (distribuições compatíveis com a especificação de pacotes manylinux 2014 <https://www.python.org/dev/peps/pep-0599/>)

  • Linux s390x (distribuições compatíveis com a especificação de pacotes manylinux 2014 <https://www.python.org/dev/peps/pep-0599/>)

  • macOS arm64 (10.15 ou mais recente)

  • Linux i686 (distribuições compatíveis com o manylinux 2014 packaging specification) para Python >= 3.10

  • Windows 32 bit para Python >= 3.10

Pronto para começar?…#

Qiskit from the ground up

Learn how to build, execute, and post-process quantum circuits with Qiskit.

Start learning Qiskit

Dive into the tutorials

Find out how to leverage Qiskit for everything from single-circuits to full quantum application development.

Qiskit tutorials