Qiskit IBM Quantum Provider for accessing the quantum devices and simulators at IBM
Qiskit is an open-source SDK for working with quantum computers at the level of circuits, algorithms, and application modules.
This project contains a provider that allows accessing the IBM Quantum systems and simulators.
If you are familiar with the qiskit-ibmq-provider
repository, check out the migration guide.
You can install the provider using pip:
pip install qiskit-ibm-provider
Create an IBM Quantum account or log in to your existing account by visiting the IBM Quantum login page.
Copy (and/or optionally regenerate) your API token from your IBM Quantum account page.
Take your token from step 2, here called MY_API_TOKEN
, and save it by calling IBMProvider.save_account()
:
from qiskit_ibm_provider import IBMProvider
IBMProvider.save_account(token='MY_API_TOKEN')
The command above stores your credentials locally in a configuration file called qiskit-ibm.json
. By default, this file is located in $HOME/.qiskit
, where $HOME
is your home directory.
Once saved you can then instantiate the provider like below and access the backends:
from qiskit_ibm_provider import IBMProvider
provider = IBMProvider()
# display current supported backends
print(provider.backends())
# get IBM's simulator backend
simulator_backend = provider.get_backend('ibmq_qasm_simulator')
Alternatively, the IBM Provider can discover credentials from environment variables:
export QISKIT_IBM_TOKEN='MY_API_TOKEN'
Then instantiate the provider without any arguments and access the backends:
from qiskit_ibm_provider import IBMProvider
provider = IBMProvider()
As another alternative, you can also enable an account just for the current session by instantiating the provider with the token.
from qiskit_ibm_provider import IBMProvider
provider = IBMProvider(token='MY_API_TOKEN')
Now you're set up and ready to check out some of the tutorials.
If you'd like to contribute to qiskit-ibm-provider, please take a look at our contribution guidelines. This project adheres to Qiskit's code of conduct. By participating, you are expect to uphold to this code.
We use GitHub issues for tracking requests and bugs. Please use our slack
for discussion and simple questions. To join our Slack community use the
invite link at Qiskit.org. For questions that are more suited for a forum we
use the Qiskit
tag in Stack Exchange.
The Qiskit IBM Quantum Provider is the work of many people who contribute to the project at different levels. If you use Qiskit, please cite as per the included BibTeX file.