English
Languages
English
Japanese
Spanish

Getting started

Install Qiskit packages

Installing the following packages lets you create circuits and work with primitives through Qiskit Runtime:

pip install qiskit
pip install qiskit-ibm-runtime

Find your access credentials

You can access Qiskit Runtime from either IBM Quantum or IBM Cloud.

IBM Quantum

Retrieve your IBM Quantum token, and optionally save it for easy access later.

Note

Account credentials are saved in plain text, so only do so if you are using a trusted device.

from qiskit_ibm_runtime import QiskitRuntimeService

# Save an IBM Quantum account.
QiskitRuntimeService.save_account(channel="ibm_quantum", token="MY_IBM_QUANTUM_TOKEN")

IBM Cloud

Retrieve your IBM Cloud access credentials, and optionally save it for easy access later.

Note

Account credentials are saved in plain text, so only do so if you are using a trusted device.

from qiskit_ibm_runtime import QiskitRuntimeService

# Save an IBM Cloud account.
QiskitRuntimeService.save_account(channel="ibm_cloud", token="MY_IBM_CLOUD_API_KEY", instance="MY_IBM_CLOUD_CRN")

Test your setup

Run a simple circuit using Sampler to ensure that your environment is set up properly:

from qiskit.test.reference_circuits import ReferenceCircuits
from qiskit_ibm_runtime import QiskitRuntimeService, Sampler

# You'll need to specify the credentials when initializing QiskitRuntimeService, if they are not previously saved.
service = QiskitRuntimeService()
backend = service.backend("ibmq_qasm_simulator")
job = Sampler(backend).run(ReferenceCircuits.bell())
print(f"job id: {job.job_id()}")
result = job.result()
print(result)

Getting started with primitives

See more tutorials