Tutorials

Use these tutorials to learn how to apply Qiskit to common quantum computing use cases.

• Start with the set of tutorials in the Get started section if it is your first time running code on a quantum computer.
• The section on workflows toward advantage contains end-to-end examples of using a quantum computer to solve real-world problems. These tutorials focus on algorithms that are promising candidates for achieving computational advantage by a quantum computer over a classical computer.
• The section on Qiskit capabilities contains examples that use the latest and most advanced techniques in the Qiskit ecosystem to improve part or the whole of a particular workflow.

Get started

These tutorials are for beginners who are ready to explore running quantum algorithms on a quantum computer.

• CHSH inequality

Explore workflows toward advantage

Tutorials in this section cover large-scale demonstrations of quantum algorithms.

• The algorithms in this category focus on quantum circuits whose output distributions encode solutions to structured problems with verifiable output. Verifiability means that you can check the consistency between measured data, either through evaluating the chosen bitstring or by knowing that false positives do not occur.

  The tutorials highlight techniques where repeated sampling enables estimation of problem-specific quantities (for example, cost function values or spectral weights). These methods are particularly relevant for optimization and simulation tasks with symmetries.

  • Sample-based quantum diagonalization of a chemistry Hamiltonian

  • Sample-based Krylov quantum diagonalization of a fermionic lattice model

  • SqDRIFT algorithm for ground state estimation

  • Pooled sample-based quantum diagonalization of a nuclear Hamiltonian

  • Quantum approximate optimization algorithm

  • Advanced techniques for QAOA

  • Warm-start QAOA with the Optimization Mapper Qiskit addon

  • Quantum approximate multi-objective optimization

  • Pauli correlation encoding to reduce max-cut requirements

  • Implicit solvent calculations using Qiskit Serverless

• These tutorials focus on estimating physically meaningful quantities, such as energy or correlation values, by preparing quantum states and measuring observables. Techniques include both variational and Trotterized circuit approaches that balance circuit expressiveness with circuit-depth efficiency. Emphasis is placed on workflows that reduce quantum resource demands while maintaining accuracy, and enabling practical estimation of observables in chemical and physical systems.

  • Simulate neutron scattering in quantum materials with quantum circuits

  • Simulate neutron scattering with an AQC + Trotter dynamics Serverless workflow

  • Krylov quantum diagonalization of lattice Hamiltonians

  • Nishimori phase transition

  • Ground-state energy estimation of the Heisenberg chain with VQE

  • Quantum kernel training

  • Enhance feature classification using projected quantum kernels

  • CHSH inequality

  • Observation of robust and coherent non-Abelian hadron dynamics on noisy quantum processors

  • Shadow tomography of the Greenberger-Horne-Zeilinger state

  • Learn noisy quantum states with classical shadows

  • Simulate time evolution of the transverse-field Ising model

  • Onset of ergodicity across scales

• This section features algorithms with well-defined theoretical guarantees that are designed to run on future error-corrected quantum hardware. The circuits or sampling overhead for these algorithms scale in a manner that is not depth-efficient and thereby are more likely to demonstrate quantum advantage when fault-tolerant quantum computers exist. These tutorials illustrate how the methods operate in idealized settings and demonstrate small-scale examples.

  • Shor's algorithm
  • Grover's algorithm

Leverage Qiskit capabilities

This section introduces advanced capabilities within the Qiskit ecosystem that enhance performance, reliability, and speed when executing quantum algorithms.

• Workload optimization focuses on either efficient orchestration of classical and quantum resources or tailored methods for improving quantum circuit manipulation.

  • Run quantum workloads with QRMI

  • Manage a quantum-centric supercomputing workflow with QCSC-Prefect

  • Benchmark dynamic circuits with cut Bell pairs

  • Quantum kernels with fractional gates

  • Qiskit AI-powered transpiler introduction

  • Transpilation optimization with SABRE

  • Compilation methods for Hamiltonian simulation circuits

  • Long-range entanglement with dynamic circuits

  • Simulation of kicked Ising Hamiltonian with dynamic circuits

  • Tools to profile, customize, and inspect experiments

• IBM Quantum® Functions are a collection of pre-packaged error management and application tools, making it easy to design large-scale experiments with circuits, molecules, QUBOs, and more.

  • Design new algorithms with Circuit functions — with pre-built transpilation, error suppression, and error mitigation pipelines.

    • Transverse-Field Ising Model with Q-CTRL's Performance Management

    • Quantum Phase Estimation with Q-CTRL's quantum functions

    • Simulate 2D tilted-field Ising with the QESEM function

    • Simulate a kicked Ising model with the TEM function

    • Benchmark QFT process fidelity with Orbit by Quantum Elements

    • Trotterized time evolution of the 2D tilted-field Ising model with LTM AI-QEM

  • Experiment with domain-specific problems with Application functions — with familiar inputs and outputs to classical solvers.

    • Dynamic portfolio optimization with Global Data Quantum's Portfolio Optimizer

    • Higher-order binary optimization with Q-CTRL's Optimization Solver

    • Model a flowing non-viscous fluid using QUICK-PDE

    • Dissociation PES curves with Qunova HiVQE

    • Hybrid quantum-enhanced ensemble classification (grid stability workflow)

    • Solve the Market Split problem with Kipu Quantum's Iskay Quantum Optimizer

    • Find the Maximum Independent Set with the Aqarios Constrained Quantum Optimizer

    • Solve the market split problem with the ParityQC Parity Twine Optimizer

    • Solve the Sherrington-Kirkpatrick model with the ParityQC Parity Twine Optimizer

    • Classify credit risk with Kipu Quantum's Rimay Quantum Feature Extraction

    • Spin and charge dynamics in the Fermi-Hubbard model

    • Solve a maximum independent set problem with more variables than qubits using JIJ's SQOA Solver

• Addons enable advanced circuit manipulation, such as cutting, backpropagating observables, or approximating circuits, that allow users to sidestep hardware limitations at the cost of increased classical compute overhead.

  • Multi-product formulas to reduce Trotter error

  • Approximate quantum compilation for time evolution circuits

  • Operator backpropagation (OBP) for estimation of expectation values

  • Wire cutting for expectation values estimation

  • Circuit cutting for periodic boundary conditions

  • Circuit cutting for depth reduction

  • Hard-core bosons on a square lattice

  • Readout error mitigation for the Sampler primitive using M3

  • Spinful Fermi-Hubbard dynamics - when mode ordering meets hardware connectivity

• Error mitigation addresses the challenge of noise without full fault tolerance by recovering accurate expectation values through controlled circuit manipulation and post-processing.

  • Utility-scale error mitigation with probabilistic error amplification

  • Combine error mitigation options with the Estimator primitive

  • Probabilistic error cancellation with shaded lightcones

  • Improve expectation values with propagated noise absorption (PNA)

  • Refresh backend properties with real-time benchmarking

  • Probabilistic error cancellation with logical noise models

• Error detection identifies faulty operations to return noise-free results shot-by-shot by post-processing.

  • Repetition codes

  • Low-overhead error detection with spacetime codes