Pular para o conteúdo principal

Instalar o Qiskit SDK e o Qiskit Runtime a partir do código-fonte

Instalar o Qiskit SDK a partir do código-fonte permite que você acesse a versão de desenvolvimento atual, em vez de usar a versão disponível no repositório Python Package Index (PyPI). Isso permite que você inspecione e estenda a versão mais recente do código do Qiskit com mais eficiência.

Criar e ativar um novo ambiente virtual

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

    python3 -m venv .venv
  2. Ative o novo ambiente.

    source .venv/bin/activate

Instalar o compilador Rust

Um compilador Rust deve estar instalado no seu sistema para compilar o Qiskit. Para instalar o compilador Rust, use o instalador multiplataforma rustup ou outro método de instalação.

Instalar o Qiskit

Siga estas etapas para instalar o Qiskit:

  1. Clone o repositório do Qiskit.
git clone https://github.com/Qiskit/qiskit.git
  1. Acesse o diretório qiskit.
cd qiskit
  1. (Opcional) Se você quiser executar testes ou verificações de linting, instale os requisitos de desenvolvimento.
pip install -r requirements-dev.txt
  1. Instale o qiskit.
  • Instalação padrão:

    pip install .
  • Modo editável: Neste modo, você não precisa reinstalar o Qiskit quando houver alterações no código do projeto.

    pip install -e .

    No modo editável, as extensões compiladas são geradas em modo de depuração sem otimizações. Isso afeta o desempenho em tempo de execução do código compilado. Para compilar as extensões com otimizações habilitadas, execute o seguinte comando para recompilar o binário em modo de lançamento:

    python setup.py build_rust --release --inplace
    nota

    Se você estiver trabalhando com código Rust no Qiskit, precisará recompilar o código de extensão toda vez que fizer uma alteração local. No modo editável, a extensão Rust só é compilada quando o comando de instalação é executado, portanto as alterações locais feitas no código Rust não são refletidas no pacote instalado a menos que você recompile a extensão executando novamente o build_rust (com ou sem --release, dependendo se você quer compilar em modo de lançamento ou de depuração).

Instalar o Qiskit Runtime

Siga estas etapas se quiser instalar o Qiskit Runtime:

  1. Clone o repositório do Qiskit Runtime.
git clone https://github.com/Qiskit/qiskit-ibm-runtime.git
  1. Acesse o diretório qiskit-ibm-runtime.
cd qiskit-ibm-runtime
  1. Instale o qiskit-runtime. Recomendamos usar um ambiente virtual para evitar poluir sua instalação global do Python.
  • Instalação padrão:

    pip install .
  • Modo editável: Neste modo, você não precisa reinstalar o Qiskit quando houver alterações no código do projeto.

    pip install -e .

    No modo editável, as extensões compiladas são geradas em modo de depuração sem otimizações.

  1. (Opcional) Se você quiser executar testes ou verificações de linting, instale os requisitos de desenvolvimento. Recomendamos usar um ambiente virtual para evitar poluir sua instalação global do Python.
pip install -e ".[dev]"

Próximas etapas

Recomendações