Primeros Pasos#

Instalación#

¡Comencemos a usar Qiskit! Lo primero que debes hacer es elegir cómo vas a ejecutar e instalar los paquetes. Hay tres formas principales de hacer esto:

Qiskit es compatible con Python 3.7 o posterior. Sin embargo, tanto Python como Qiskit son ecosistemas en evolución y, a veces, cuando se producen nuevas versiones en uno u otro, puede haber problemas de compatibilidad.

Deberás descargar Python en tu sistema local para comenzar. Se recomienda Jupyter para interactuar con Qiskit.

Recomendamos utilizar entornos virtuales de Python para separar claramente Qiskit de otras aplicaciones y mejorar tu experiencia.

Crea un entorno mínimo con solo Python instalado en él.

python3 -m venv /path/to/virtual/environment

Activa tu nuevo entorno.

source /path/to/virtual/environment/bin/activate

Nota: si estás usando Windows, usa los siguientes comandos en PowerShell.

python3 -m venv c:\path\to\virtual\environment
c:\path\to\virtual\environment\Scripts\Activate.ps1

A continuación, instala el paquete Qiskit.

pip install qiskit

Si los paquetes se instalaron correctamente, puedes ejecutar pip list para ver los paquetes activos en tu entorno virtual.

Si tienes la intención de utilizar la funcionalidad de visualización o los cuadernos de Jupyter, se recomienda instalar Qiskit con el soporte adicional de visualization:

pip install qiskit[visualization]

Vale la pena señalar que si eres usuario de zsh (que es el shell predeterminado en las versiones más recientes de macOS), deberás poner qiskit[visualization] entre comillas:

pip install 'qiskit[visualization]'

Los siguientes proveedores de nube tienen Qiskit preinstalado en sus entornos:

IBM Quantum Lab

Build quantum applications and experiments with Qiskit in a cloud programming environment.

Strangeworks

A platform that enables users and organizations to easily apply quantum computing to their most pressing problems and research.

Installing Qiskit from source allows you to access the current development version, instead of using the version in the Python Package Index (PyPI) repository. This will give you the ability to inspect and extend the latest version of the Qiskit code more efficiently.

Begin by making a new virtual environment and activating it:

python3 -m venv QiskitDevenv
source QiskitDevenv/bin/activate

La instalación desde el código fuente requiere que tengas el compilador de Rust en tu sistema. Para instalar el compilador de Rust, el camino recomendado es usar rustup, que es un instalador de Rust multiplataforma. Para usar rustup puedes ir a:

https://rustup.rs/

que proporcionará instrucciones sobre cómo instalar rust en tu plataforma. Además de rustup, también hay otros métodos de instalación disponibles.

Once the Rust compiler is installed, you are ready to install Qiskit.

  1. Clone the Qiskit repository.

    git clone https://github.com/Qiskit/qiskit-terra.git

  2. La clonación del repositorio crea una carpeta local llamada qiskit-terra.

    cd qiskit-terra

  3. Si quieres ejecutar pruebas o verificaciones de linting, instala los requerimientos de desarrollador.

    pip install -r requirements-dev.txt

  4. Instalar qiskit-terra.

    pip install .

Si deseas instalarlo en modo editable, es decir, que los cambios en el código del proyecto no requieran ser instalados de nuevo, puedes hacerlo con:

pip install -e .

La instalación en modo editable construirá las extensiones compiladas en modo de depuración sin optimizaciones. Esto afectará el rendimiento en tiempo de ejecución del código compilado. Si deseas utilizar el modo editable y construir el código compilado que está publicado, con las optimizaciones habilitadas, puedes ejecutar:

python setup.py build_rust --release --inplace

después de ejecutar pip y eso reconstruirá el binario en modo de liberación. Si estás trabajando en el código de Rust en Qiskit, necesitarás reconstruir el código de extensión cada vez que realices un cambio local. pip install -e . solo compilará la extensión de Rust cuando sea ejecutado, por lo que cualquier cambio local que hagas en el código de Rust después de ejecutar pip no se reflejará en el paquete instalado a menos que reconstruyas la extensión. Puedes aprovechar el comando anterior build_rust para hacer esto (con o sin --release en función de si deseas compilar en modo de depuración o modo de liberación).

You can then run the code examples after installing Qiskit. You can run the example with the following command.

python examples/python/using_qiskit_terra_level_0.py

Soporte de la Plataforma#

Qiskit se esfuerza por admitir tantas plataformas como sea posible, pero debido a las limitaciones en los recursos de prueba disponibles y la disponibilidad de la plataforma, no todas las plataformas son compatibles. El soporte de plataforma para Qiskit se divide en 3 niveles con diferentes grados de soporte para cada nivel. Para plataformas fuera de estas, es probable que Qiskit todavía se pueda instalar, pero no se ha probado y tendrás que compilar Qiskit (y probablemente las dependencias de Qiskit) desde la fuente.

Además, Qiskit solo es compatible con CPython. Actualmente, no se admite la ejecución con otros intérpretes de Python.

Nivel 1#

Las plataformas compatibles con el nivel 1 se prueban completamente en upstream 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. Se espera que estas plataformas se puedan instalar con solo un entorno de Python en funcionamiento, ya que todas las dependencias están disponibles en estas plataformas.

Las plataformas de nivel 1 actualmente son:

  • Linux x86_64 (distributions compatible with the manylinux 2014 packaging specification).

  • macOS x86_64 (10.9 o superior)

  • Windows 64 bit

Nivel 2#

Las plataformas de nivel 2 no se prueban en upstream 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 solo con un entorno de Python en funcionamiento.

Las plataformas de nivel 2 actualmente son:

  • Linux i686 (distribuciones compatibles con la especificación de empaquetado manylinux 2014) para Python < 3.10

  • Windows 32 bit para Python < 3.10

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

Nivel 3#

Las plataformas de nivel 3 no se prueban en upstream como parte del proceso de desarrollo. Los binarios precompilados se construyen y publican en PyPI como parte del proceso de lanzamiento, sin ninguna prueba. Es posible que no se puedan instalar solo con un entorno de Python en funcionamiento y pueden requerir un compilador C/C++ o programas adicionales para crear dependencias desde el origen como parte del proceso de instalación. El soporte para estas plataformas es únicamente de mejores intenciones.

Las plataformas de nivel 3 actualmente son:

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

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

  • macOS arm64 (10.15 o superior)

  • Linux i686 (distribuciones compatibles con la especificación de empaquetado manylinux 2014) para Python >= 3.10

  • Windows 32 bit para Python >= 3.10

¿Listo para empezar?…#

Qiskit from the ground up

Learn how to build, execute, and post-process quantum circuits with Qiskit.

Start learning Qiskit

Dive into the tutorials

Find out how to leverage Qiskit for everything from single-circuits to full quantum application development.

Qiskit tutorials