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.
To retrieve your Cloud Resource Name (CRN), open the Instances page and click your instance. In the page that opens, click the icon to copy your CRN.
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)