Início rápido

Versões dos pacotes

O código desta página foi desenvolvido com os seguintes requisitos. Recomendamos usar essas versões ou versões mais recentes.

qiskit[all]~=2.5.2

# Added by doQumentation — installs the packages this notebook needs if they are missing
import importlib.util

_needed = {"qiskit": "qiskit"}
_missing = [pip for module, pip in _needed.items()
            if importlib.util.find_spec(module) is None]
# One at a time, so a package that fails to install does not block the others
for _pip in _missing:
    %pip install -q {_pip}
if not _missing:
    print("\u2713 All required packages are installed")

Construa seu primeiro Circuit quântico em menos de dois minutos, no seu ambiente local — sem necessidade de cadastro ou chave de API.

Novo no Python e em ambientes virtuais?

• Baixe o Python e use um ambiente virtual com o Qiskit (recomendado).

Clique para expandir e saber mais sobre o Python.

• Para instalar o Python, primeiro 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.

nota

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

Clique para expandir e saber mais sobre ambientes virtuais.

• Use ambientes virtuais do Python para separar o Qiskit de outras aplicações. Um ambiente virtual do Python é um espaço isolado para trabalhar com Python para um propósito específico — assim você pode instalar quaisquer pacotes que desejar, e configurar bibliotecas, dependências, e assim por diante, sem afetar o ambiente Python "base" da sua máquina.

Uma vantagem importante de um ambiente virtual é que, se o seu ambiente Python for corrompido, você pode simplesmente deletá-lo e começar novamente!

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.

Para configurar um ambiente virtual, 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 o 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

1. Instale o Qiskit

Instale o seguinte com o gerenciador de pacotes de sua preferência (como o pip):

• qiskit

• matplotlib

• qiskit[visualization]

2. Construa seu Circuit

Abra um ambiente Python e execute este código para construir um estado de Bell (dois Qubits entrelaçados).

from qiskit import QuantumCircuit
from qiskit.primitives import StatevectorSampler

qc = QuantumCircuit(2)
qc.h(0)
qc.cx(0, 1)
qc.measure_all()

sampler = StatevectorSampler()
result = sampler.run([qc], shots=1024).result()
print(result[0].data.meas.get_counts())

{'11': 522, '00': 502}

A saída esperada é uma divisão quase igual entre '00' e '11'.

3. Visualize seus resultados

Para obter um histograma dos seus resultados, adicione o seguinte código ao seu programa.

# Uncomment lines 2 and 8 if you are not using Python in a Jupyter notebook
# import matplotlib.pyplot as plt
from qiskit.visualization import plot_histogram

counts = result[0].data.meas.get_counts()
plot_histogram(counts)

# plt.show()

Este resultado é uma marca característica do entrelaçamento quântico.

4. Veja o que acontece

Tente modificar o código para ver como isso afeta os resultados. Por exemplo:

• Adicione um terceiro Qubit alterando para QuantumCircuit(3), e adicione um segundo Gate CX com qc.cx(1,2). As medições deverão mudar para 000 e 111, o que significa que todos os três Qubits foram entrelaçados.

• Veja seus resultados mudarem ao adicionar qc.x(1) ao final do Circuit.

Próximos passos

Recomendações

• Siga os passos do guia Execute seu primeiro circuito em hardware para executar um circuito em hardware quântico real.
• Ainda não está pronto para rodar no hardware? Comece sua jornada quântica com o curso Fundamentos de informação quântica.