Instalar Qiskit

Ya sea que trabaje localmente o 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 versiones posteriores

(Si está instalando Qiskit por primera vez, continúe a la sección Instalar y configurar. Este aviso es relevante solo para usuarios que hayan instalado Qiskit previamente.)

Para aquellos que actualizan desde la versión 0.x a la 1.0 o posterior: tenga en cuenta que debido a que Qiskit v1.0 utiliza una nueva estructura de empaquetado, no puede usar pip install -U qiskit para actualizar desde ninguna versión 0.x de Qiskit a la 1.0.

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

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

Instalar el SDK de Qiskit y el cliente de Qiskit Runtime

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

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

   nota

   Estas instrucciones utilizan la distribución estándar de 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 es nuevo en entornos virtuales, haga clic aquí para obtener más información.

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

   Una ventaja importante de un entorno virtual es que si su entorno Python se corrompe en el camino, ¡puede eliminar fácilmente el entorno virtual y comenzar de nuevo!

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

   Primero, navegue al directorio de su proyecto y cree un entorno mínimo con solo Python instalado.

   macOS

   python3 -m venv .venv

   Linux

   python3 -m venv .venv

   Windows

   python -m venv .venv

   A continuación, active su nuevo entorno.

   macOS

   source .venv/bin/activate

   Linux

   source .venv/bin/activate

   Windows

   Si utiliza PowerShell:

   .venv\Scripts\Activate.ps1

   Si utiliza Git Bash:

   source .venv/scripts/activate

   Si utiliza el símbolo del sistema:

   .venv\Scripts\activate

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

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

   pip install qiskit

   pip install qiskit-ibm-runtime

   Agregar soporte de visualización

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

1. Si desea ejecutar un notebook de Jupyter con los paquetes de Qiskit que acaba de instalar, debe instalar Jupyter en su entorno.

   pip install jupyter

   Luego abra su notebook de la siguiente manera:

   jupyter notebook <path/to/notebook.ipynb>

Si planea trabajar localmente y utilizar simuladores integrados en Qiskit, entonces su instalación está completa. Si desea ejecutar trabajos en QPUs de IBM, continúe con configurar su cuenta de IBM Cloud.

Manténgase actualizado con las últimas versiones

Revise periódicamente las notas de versión de Qiskit y las notas de versión de Qiskit Runtime para ver las nuevas versiones. Recomendamos actualizar frecuentemente sus requisitos para qiskit y qiskit-ibm-runtime, por ejemplo, cambiando las versiones en requirements.txt a las versiones más recientes y luego ejecutando pip install -r requirements.txt o el comando apropiado para su flujo de trabajo de gestión de dependencias.

Need help? Try asking Qiskit Code Assistant.

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 no ha instalado Qiskit o no ha configurado su entorno virtual, puede seguir los pasos de instalación.

El error se produce al intentar importar el paquete Qiskit en un entorno donde Qiskit no está instalado. Si inició 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. Elija un entorno virtual en Anaconda-Navigator desde el menú desplegable Applications on. En este menú, puede ver todos los entornos virtuales dentro de Anaconda y puede seleccionar el entorno donde tiene Qiskit instalado para iniciar Jupyter Notebook.

Errores de compilación durante la instalación

Qiskit depende de varios otros paquetes de Python de código abierto, que se instalan automáticamente al ejecutar pip install qiskit. Dependiendo de la plataforma de su sistema y la versión de Python, es posible que un paquete en particular no proporcione binarios precompilados para su sistema. Puede consultar Soporte del sistema operativo para obtener una lista de plataformas compatibles con Qiskit, algunas de las cuales pueden necesitar un compilador adicional. En casos donde no hay binarios precompilados disponibles, pip intentará compilar el paquete desde el código fuente, lo que a su vez puede requerir algunas dependencias adicionales que deben instalarse 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 falló al instalar (en el código de ejemplo, SOME_PACKAGE) para obtener información sobre cómo instalar las bibliotecas necesarias para compilar desde el código fuente.

Soporte del sistema operativo

Qiskit se esfuerza por admitir tantos sistemas operativos como sea posible, pero debido a limitaciones en los recursos de prueba disponibles y la disponibilidad del sistema operativo, no todos los sistemas operativos pueden ser compatibles. El soporte del sistema operativo para Qiskit se divide en tres niveles con diferentes niveles de soporte para cada nivel. Para plataformas fuera de estas, como FreeBSD o WebAssembly (WASI), Qiskit aún puede ser instalable, pero no está probado y tendrá que compilar Qiskit (y probablemente las dependencias de Qiskit) desde el código fuente.

Además, Qiskit solo admite la implementación CPython del lenguaje Python. La ejecución con otros intérpretes de Python como PyPy no es compatible.

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 completamente como parte de los procesos de desarrollo para garantizar que cualquier cambio propuesto funcione correctamente. Los binarios precompilados se construyen, prueban y publican en PyPI como parte del proceso de lanzamiento. Por lo general, siempre que haya un entorno de Python en funcionamiento instalado, Qiskit se puede instalar en estos sistemas operativos sin necesidad de instalar dependencias adicionales.

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-bit (Windows 10 y versiones posteriores compatibles)
• 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 construyen, prueban y publican en PyPI como parte del proceso de lanzamiento, y se puede esperar que estos paquetes se instalen con solo un entorno de Python en funcionamiento. Puede haber un retraso en el lanzamiento de paquetes para estos sistemas, ya que las fallas en las pruebas pueden no detectarse hasta mucho más tarde, y las fallas 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 construyen y publican en PyPI como parte del proceso de lanzamiento, pero no se prueban. Es posible que no sean instalables con solo un entorno de Python en funcionamiento y podrían requerir un compilador de C/C++ o programas adicionales para compilar dependencias desde el código fuente como parte del proceso de instalación. El soporte para estos sistemas operativos es solo de mejor esfuerzo.

Sistemas operativos de nivel 3:

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

A partir de Qiskit v2.0.0, solo se admiten plataformas de 64 bits y no se admiten plataformas de 32 bits. Tampoco podrá compilar desde el código fuente en plataformas de 32 bits, ya que internamente el código Rust de Qiskit 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 completamente como parte de los procesos de desarrollo para garantizar que cualquier cambio propuesto funcione correctamente. Los binarios precompilados se construyen, prueban y publican en PyPI como parte del proceso de lanzamiento. Por lo general, siempre que haya un entorno de Python en funcionamiento instalado, Qiskit se puede instalar en estos sistemas operativos sin necesidad de instalar dependencias adicionales.

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-bit (Windows 10 y versiones posteriores compatibles)

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 solo un entorno de 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 construyen y publican en PyPI como parte del proceso de lanzamiento, pero no se prueban. Es posible que no sean instalables con solo un entorno de Python en funcionamiento y podrían requerir un compilador de C/C++ o programas adicionales para compilar dependencias desde el código fuente como parte del proceso de instalación. El soporte para estos sistemas operativos es solo de mejor esfuerzo.

Sistemas operativos de nivel 3:

• Linux ppc64le (distribuciones compatibles con la especificación de empaquetado manylinux 2014)
• 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-bit

Próximos pasos

Recomendaciones

• Configure su cuenta de IBM Cloud.

• Configure Qiskit localmente.

• Siga los pasos en Hello world para escribir y ejecutar un programa cuántico.

• Pruebe un tutorial de IBM Quantum Learning.