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.

• Verifiable sampling 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

  • Quantum approximate optimization algorithm

  • Advanced techniques for QAOA

  • Pauli Correlation Encoding to reduce Maxcut requirements

• Observable estimation

  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.

  • 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

• Fault-tolerant algorithms

  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

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

  • Benchmark dynamic circuits with cut Bell pairs

  • Introduction to fractional gates

  • Qiskit AI-powered transpiler service introduction

  • Transpilation optimizations with SABRE

  • Compilation methods for Hamiltonian simulation circuits

  • Long-range entanglement with dynamic circuits

  • Simulation of kicked Ising Hamiltonian with dynamic circuits

• Qiskit Functions

  Qiskit 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.

    • Error mitigation with the IBM Circuit function

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

    • Quantum Phase Estimation with Q-CTRL's Qiskit Functions

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

    • Simulate a kicked Ising model with the TEM function

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

    • Quantum Portfolio Optimizer - A Qiskit Function by Global Data Quantum

    • 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

• Qiskit addons

  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

  • Readout error mitigation for the Sampler primitive using M3

• Error mitigation

  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

  • Real-time benchmarking for qubit selection

• Error detection

  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