Skip to Content
New in v0.1.0 OpenQASM export: run fqkit circuits on real IBM hardware
DocumentationHardwareOverview

Hardware

run() simulates a circuit on your computer. This section is the other path: send that same circuit to a real machine, watch the job in the queue, and read the measurements when the chip is done.

You do this from your own Python. The lessons on this website stay on the simulator, so a hardware token never has to be pasted into a browser cell.

The path

  1. Install the extra for the company that owns the machine.
  2. Create an account with that company and save the credential on your computer.
  3. Build the circuit with QuantumCircuit, the same way you do for the simulator.
  4. submit(qc, machine) hands the circuit to that company’s runtime.
  5. job.status() asks the queue. job.counts() waits, then returns the shots in FQkit order.

The machines

Name you passCompanyHow FQkit reaches itAccount
"ibm"IBM QuantumQiskit RuntimeFree IBM Quantum account
"ionq"IonQ Forte-1Amazon BraketAWS account with Braket enabled
"rigetti"Rigetti Ankaa-3Amazon BraketAWS account with Braket enabled
"iqm"IQM GarnetAmazon BraketAWS account with Braket enabled
"aqt"AQT IBEX-Q1Amazon BraketAWS account with Braket enabled

IBM jobs wait on the free plan’s queue. Braket jobs are billed by AWS for each task. A different chip from the same company is selected later with backend.

Read it in order

PageWhat you do
1AccountsInstall the extra, create the account, save the token
2RuntimeWhat the vendor does with the circuit after you submit
3Job submissionsubmit, device choice, cancel, and reconnect
4ResultsStatus words, counts, bit order, and noise

The circuit still has to be legal FQkit: the gates are H, RX, RY, RZ, CNOT, CZ, SWAP, and Toffoli, and every Parameter is bound to a number before the job is sent. Export details live on OpenQASM & Hardware.

Last updated on