Saltar al contenido principal

Instalar el SDK de Qiskit y Qiskit Runtime desde el código fuente

Instalar el SDK de Qiskit desde el código fuente te permite acceder a la versión de desarrollo actual, en lugar de usar la versión disponible en el repositorio del Python Package Index (PyPI). Esto te permite inspeccionar y ampliar la última versión del código de Qiskit de forma más eficiente.

Crear y activar un nuevo entorno virtual​

  1. Navega al directorio de tu proyecto y crea un entorno mínimo con solo Python instalado.

    python3 -m venv .venv

  2. Activa tu nuevo entorno.

    source .venv/bin/activate

Instalar el compilador de Rust​

Es necesario tener un compilador de Rust instalado en tu sistema para compilar Qiskit. Para instalarlo, usa el instalador multiplataforma rustup u otro método de instalación.

Instalar Qiskit​

Sigue estos pasos para instalar Qiskit:

  1. Clona el repositorio de Qiskit.
git clone https://github.com/Qiskit/qiskit.git
  1. Cambia al directorio qiskit.
cd qiskit
  1. (Opcional) Si quieres ejecutar pruebas o verificaciones de estilo de código, instala los requisitos para desarrolladores.
pip install -r requirements-dev.txt
  1. Instala qiskit.

  • Instalación estándar:

    pip install .

  • Modo editable: En este modo, no necesitas reinstalar Qiskit cuando haya cambios en el código del proyecto.

    pip install -e .

    En modo editable, las extensiones compiladas se construyen en modo debug sin optimizaciones. Esto afecta al rendimiento en tiempo de ejecución del código compilado. Para compilar las extensiones con optimizaciones habilitadas, ejecuta el siguiente comando para reconstruir el binario en modo release:

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

    Si estás trabajando en código Rust dentro de Qiskit, necesitas reconstruir el código de la extensión cada vez que hagas un cambio local. En modo editable, la extensión de Rust solo se compila cuando se ejecuta el comando de instalación, por lo que los cambios locales que hagas en el código Rust no se reflejan en el paquete instalado a menos que reconstruyas la extensión volviendo a ejecutar build_rust (con o sin --release, según si quieres compilar en modo release o debug).

Instalar Qiskit Runtime​

Sigue estos pasos si quieres instalar Qiskit Runtime:

  1. Clona el repositorio de Qiskit Runtime.
git clone https://github.com/Qiskit/qiskit-ibm-runtime.git
  1. Cambia al directorio qiskit-ibm-runtime.
cd qiskit-ibm-runtime
  1. Instala qiskit-runtime. Recomendamos usar un entorno virtual para evitar contaminar tu instalación global de Python.

  • Instalación estándar:

    pip install .

  • Modo editable: En este modo, no necesitas reinstalar Qiskit cuando haya cambios en el código del proyecto.

    pip install -e .

    En modo editable, las extensiones compiladas se construyen en modo debug sin optimizaciones.

  1. (Opcional) Si quieres ejecutar pruebas o verificaciones de estilo de código, instala los requisitos para desarrolladores. Recomendamos usar un entorno virtual para evitar contaminar tu instalación global de Python.
pip install -e ".[dev]"

Próximos pasos​

Recomendaciones