Skip to main content
IBM Quantum Platform

Instalar Qiskit

Tanto si vas a trabajar localmente como en un entorno en la nube, el primer paso para todos los usuarios es instalar Qiskit.

Actualización de Qiskit 0.x a Qiskit 1.0 y posteriores

(Si estás instalando Qiskit por primera vez, pasa a la sección Instalar y configurar. Este aviso sólo es relevante para los usuarios que hayan instalado Qiskit previamente)

Para aquellos que actualicen desde la versión 0.x a 1.0 o posterior : tened en cuenta que debido a que Qiskit v1.0 utiliza una nueva estructura de empaquetado, no podréis utilizar pip install -U qiskit para actualizar desde cualquier versión de Qiskit 0.x a 1.0.

Consulte la guía de migración de Qiskit 1.0 para obtener más detalles e instrucciones.

Las futuras actualizaciones, a partir de Qiskit 1.0, permitirán realizar actualizaciones in situ.

Instalar el SDK de Qiskit y el cliente Qiskit Runtime

  1. Instale Python. Consulta la sección "Lenguaje de programación" en la página del proyecto Qiskit PyPI para determinar qué versiones de Python son compatibles con la versión más reciente. Para obtener instrucciones de descarga, consulte la Guía para principiantes Python.

    Se recomienda utilizar entornos virtuales Python para separar Qiskit de otras aplicaciones.

    Note

    Estas instrucciones utilizan la distribución estándar Python de pypi.org. Sin embargo, puede utilizar otras distribuciones de Python, como Anaconda o miniconda, junto con otros flujos de trabajo de gestión de dependencias como Poetry.

    Si no conoces los entornos virtuales, haz clic aquí para obtener más información.

    Un entorno virtual Python es un espacio aislado para trabajar con Python para un propósito específico - así que usted puede instalar cualquier paquete que desee, y configurar bibliotecas, dependencias, etc., sin afectar el entorno "base" Python en su máquina.

    Una ventaja importante de un entorno virtual es que si el entorno Python se corrompe en algún punto del camino, puedes borrar fácilmente el entorno virtual y empezar de nuevo

    Elija una ubicación preferida en la que almacenar la información sobre sus entornos virtuales. Normalmente se almacenan en un directorio llamado .venv dentro de cada directorio de proyecto en el que esté trabajando.

    En primer lugar, vaya al directorio de su proyecto y cree un entorno mínimo en el que sólo esté instalado Python.

    python3 -m venv .venv

    A continuación, activa tu nuevo entorno.

    source .venv/bin/activate

  2. Instale pip si no está ya instalado en su entorno. Pip es un gestor de paquetes de Python que se utiliza para instalar Qiskit y otros paquetes de Python. Utilice pip list para ver lo que hay en su entorno virtual. En la mayoría de los entornos Python, pip ya está instalado.

  3. Instala el SDK de Qiskit. Si tiene previsto ejecutar trabajos en hardware cuántico, instale también Qiskit Runtime.

    pip install qiskit
    pip install qiskit-ibm-runtime
    Añadir soporte para visualización

    Si tiene intención de utilizar la funcionalidad de visualización o los cuadernos Jupyter, instale también el qiskit.visualization módulo. Consulte la referencia de la API de visualizaciones para obtener más información.

  1. Si quieres ejecutar un cuaderno Jupyter con los paquetes Qiskit que acabas de instalar, necesitas instalar Jupyter en tu entorno.

    pip install jupyter

    A continuación, abre tu cuaderno de la siguiente manera:

    jupyter notebook <path/to/notebook.ipynb>

Si estás planeando trabajar localmente y utilizar simuladores incorporados en Qiskit, entonces tu instalación está hecha. Si desea ejecutar trabajos en IBM QPUs, continúe para configurar su cuenta IBM Cloud.

Manténgase al día con las últimas versiones

Consulte periódicamente las notas de la versión de Qiskit y las notas de la versión Qiskit Runtime para ver los nuevos lanzamientos. Le recomendamos que actualice con frecuencia sus requisitos para qiskit y qiskit-ibm-runtime , por ejemplo, cambiando las versiones en requirements.txt a las versiones más recientes y, a continuación, ejecutando pip install -r requirements.txt o el comando adecuado para su flujo de trabajo de gestión de dependencias.

Qiskit Code Assistant

Need help? Try asking Qiskit Code Assistant.

# Print the version of Qiskit we're using
# Return True if the version of Qiskit is 1.0 or greater
# Install Qiskit 1.0.2

¿Eres nuevo en el asistente de códigos? Consulte Qiskit Code Assistant para obtener información sobre su instalación y uso. Tenga en cuenta que esta función es experimental y sólo está disponible para los usuarios de IBM Quantum Premium Plan.

Solución de problemas

error "No Module 'qiskit'" con Jupyter Notebook

Si utilizó pip install qiskit y configuró su entorno virtual en Anaconda, es posible que obtenga el error No Module 'qiskit' cuando ejecute un tutorial en Jupyter Notebook. Si usted no ha instalado Qiskit o configurar su entorno virtual, puede seguir los pasos de instalación.

El error se produce al intentar importar el paquete Qiskit en un donde Qiskit no está instalado. Si lanzó Jupyter Notebook desde Anaconda- Navigator, es posible que Jupyter Notebook se esté ejecutando en el entorno base (root), en lugar de en su entorno virtual virtual. Elija un entorno virtual en Anaconda- Navigator desde el menú desplegable Aplicaciones en el menú desplegable. En este menú, puede ver todos los entornos virtuales dentro de Anaconda, y puedes seleccionar el entorno donde tienes instalado Qiskit para lanzar Jupyter Notebook.

Errores de compilación durante la instalación

Qiskit depende de una serie de otros paquetes de código abierto Python, que se instalan automáticamente al hacer pip install qiskit. Dependiendo de plataforma de su sistema y de la versión de Python, es posible que un determinado paquete no proporcione binarios precompilados para su sistema. Puede consultar a Soporte del sistema operativo para una lista de plataformas soportadas por Qiskit, algunas de las cuales pueden necesitar un compilador adicional. En los casos en que no haya binarios precompilados disponibles, pip intentará compilar el paquete de la fuente, que a su vez puede requerir algunas dependencias adicionales que necesitan instalar manualmente.

Si la salida de pip install qiskit contiene líneas similares 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

consulte la documentación del paquete que no se ha podido instalar (en el código de ejemplo código de ejemplo, SOME_PACKAGE) para obtener información sobre cómo instalar las bibliotecas necesarias para compilar desde el código fuente.

Compatibilidad con sistemas operativos

Qiskit se esfuerza por admitir tantos sistemas operativos como sea posible, pero debido a las limitaciones de los recursos disponibles para las pruebas y a la disponibilidad de los sistemas operativos, no es posible admitir todos los sistemas operativos. La compatibilidad de Qiskit con los sistemas operativos se divide en tres niveles, con distintos niveles de compatibilidad para cada nivel. Para plataformas fuera de éstas, como FreeBSD o WebAssembly (WASI), Qiskit puede ser instalado, pero no está probado y tendrás que compilar Qiskit (y probablemente las dependencias de Qiskit) desde el código fuente.

Además, Qiskit sólo es compatible con la implementación CPython del lenguaje Python. No es compatible con otros intérpretes de Python, como PyPy.

Qiskit v2.x

En la serie de versiones Qiskit v2.x, las plataformas compatibles son:

Nivel 1

Los sistemas operativos de nivel 1 se prueban a fondo como parte de los procesos de desarrollo para garantizar que cualquier cambio propuesto funcione correctamente. Los binarios precompilados se crean, prueban y publican en PyPI como parte del proceso de publicación. Normalmente, siempre que haya un entorno Python instalado, Qiskit puede instalarse en estos sistemas operativos sin necesidad de instalar otras dependencias.

Sistemas operativos de nivel 1:

  • Linux x86_64 (distribuciones compatibles con la especificación de empaquetado manylinux 2014 ).
  • macOS ARM64 ( 11.0 o más reciente)
  • Windows 64 bits (compatible con Windows 10 y versiones posteriores)
  • Linux AArch64 (distribuciones compatibles con la especificación de empaquetado manylinux 2014 )

Nivel 2

Los sistemas operativos de nivel 2 no se prueban como parte del proceso de desarrollo. Sin embargo, los binarios precompilados se crean, prueban y publican en PyPI como parte del proceso de lanzamiento, y se espera que estos paquetes se instalen solo con un entorno Python que funcione. Es posible que se produzca un retraso en la publicación de paquetes para estos sistemas, ya que es posible que los fallos en las pruebas no se detecten hasta mucho más tarde, y los fallos durante la publicación no bloquearán la publicación del paquete para los sistemas de nivel 1.

Sistemas operativos de nivel 2:

  • macOS x86_64 ( 10.12 o posterior)

Nivel 3

Los sistemas operativos de nivel 3 no se prueban como parte del proceso de desarrollo. Los binarios precompilados se crean y publican en PyPI como parte del proceso de publicación, pero no se prueban. Es posible que no puedan instalarse sólo con un entorno Python y que requieran un compilador C/C++ o programas adicionales para crear dependencias a partir del código fuente como parte del proceso de instalación. La asistencia para estos sistemas operativos se realiza únicamente en la medida de lo posible.

Sistemas operativos de nivel 3:

  • Linux ppc64le (distribuciones compatibles con la especificación manylinux 2014packaging )
  • Linux s390x (distribuciones compatibles con la especificación de empaquetado manylinux 2014 )

A partir de Qiskit v2.0.0, sólo se admiten plataformas de 64 bits y no de 32 bits. Tampoco podrás compilar desde el código fuente en plataformas de 32 bits, ya que internamente el código Qiskit Rust asume un ancho de puntero de 64 bits.

Qiskit v1.x

En la serie de versiones Qiskit v1.x, las plataformas compatibles son:

Nivel 1

Los sistemas operativos de nivel 1 se prueban a fondo como parte de los procesos de desarrollo para garantizar que cualquier cambio propuesto funcione correctamente. Los binarios precompilados se crean, prueban y publican en PyPI como parte del proceso de publicación. Normalmente, siempre que haya un entorno Python instalado, Qiskit puede instalarse en estos sistemas operativos sin necesidad de instalar otras dependencias.

Sistemas operativos de nivel 1:

  • Linux x86_64 (distribuciones compatibles con la especificación de empaquetado manylinux 2014 ).
  • macOS x86_64 ( 10.12 o posterior)
  • macOS ARM64 ( 11.0 o más reciente)
  • Windows 64 bits (compatible con Windows 10 y versiones posteriores)

Nivel 2

Los sistemas operativos de nivel 2 no se prueban como parte del proceso de desarrollo. Sin embargo, los binarios precompilados se construyen, prueban y publican en PyPI como parte del proceso de lanzamiento y se puede esperar que estos paquetes se instalen con sólo un entorno Python en funcionamiento.

Sistemas operativos de nivel 2:

  • Linux AArch64 (distribuciones compatibles con la especificación de empaquetado manylinux 2014 )

Nivel 3

Los sistemas operativos de nivel 3 no se prueban como parte del proceso de desarrollo. Los binarios precompilados se crean y publican en PyPI como parte del proceso de publicación, pero no se prueban. Es posible que no puedan instalarse sólo con un entorno Python y que requieran un compilador C/C++ o programas adicionales para crear dependencias a partir del código fuente como parte del proceso de instalación. La asistencia para estos sistemas operativos se realiza únicamente en la medida de lo posible.

Sistemas operativos de nivel 3:

  • Linux ppc64le (distribuciones compatibles con la especificación manylinux 2014packaging )
  • Linux s390x (distribuciones compatibles con la especificación de empaquetado manylinux 2014 )
  • Linux i686 (distribuciones compatibles con la especificación de empaquetado manylinux 2014 )
  • Windows 10 32 bits

Pasos siguientes

Recomendaciones
¿Le ha resultado útil esta página?
Informe de un error, errata o solicite contenidos en GitHub .