Note: In order for images to show up in this jupyter notebook you need to select File => Trusted Notebook

Qiskit Tutorials

Welcome Qiskitters to the Quantum Information Science Kit (Qiskit for short)!

To get you started, we have put together a set of tutorials that can be downloaded by clicking here!.

Please see INSTALLATION for setup and installation instructions.


We have organized the tutorials into three sections:

1. Hello, Quantum World

Since quantum computing is new to most users, we want to find the best Hello Quantum World programs and welcome submissions here.

2. Reference

We've collected a core reference set of notebooks in this section. These notebooks demonstrate how to use Qiskit and explore quantum information science, acting as a reference guide for Qiskit. We will be keeping them up to date with the latest Qiskit version, currently 0.5.

They are organized into the following topics:

2.1 Getting started with Qiskit

In this first topic, we introduce you to the basic features of Qiskit. More tutorials covering Qiskit features can be found here, and developer documentation can be found here.

2.2 Introduction to quantum information science

The next set of notebooks shows how you can explore some simple concepts of quantum information science. More tutorials on other quantum information science concepts can be found here

2.3 Understanding your quantum computer

This set of notebooks describes a few of the techniques used to characterize, verify, and validate quantum systems.

  • Relaxation and decoherence - how to measure coherence times on the real quantum hardware
  • Quantum state tomography - how to identify a quantum state using state tomography, in which the state is prepared repeatedly and measured in different bases
  • Quantum process tomography - using quantum process tomography to reconstruct the behavior of a quantum process and measure its fidelity, i.e., how closely it matches the ideal version
  • Randomized benchmarking

2.4 Working with Qiskit Aqua on near-term devices

Universal fault tolerant quantum computers are still many years away; notebooks in this section describe a few of the things you can do with the approximate quantum computers we have today. Qiskit Aqua provides a library of cross-domain quantum algorithms upon which domain-specific applications for near term quantum computing can be built.

  • Chemistry - using variational quantum eigensolver to experiment with molecular ground-state energy on a quantum computer
  • Optimization - using variational quantum eigensolver to experiment with optimization problems on a quantum computer
  • Artificial Intelligence - using quantum-enhanced support vector machine to experiment with classification problems on a quantum computer
  • Numerous other tutorials can be found in Qiskit Aqua Tutorials

2.5 Examples of quantum algorithms

This section contains notebooks describing the canonical quantum algorithms. Other quantum algorithms can be found here.

2.6 Having fun with quantum computers

Here we have a few examples of quantum games. Enjoy!

  • Battleships - a version of Battleships made to run on ibmqx2. The unique properties of single-qubit operations are used to implement the game mechanics, with the destruction of a ship corresponding to rotation from 0 to 1.
  • Which is the counterfeit coin? - can you solve the counterfeit coin riddle? You are given a quantum computer and quantum beam balance, and your task is to find a counterfeit coin hidden in a set of coins. Armed with the knowledge of the Bernstein-Vazirani algorithm, you can easily find the counterfeit coin using the beam balance only once.
  • Quantum tic tac toe - In classical tic tac toe, players take turns making moves. In quantum tic tac toe, players take turns making superpositions of moves. The game branches out into several states that are measured at the end. A winning strategy exists for this game, see if you can work it out.

3. Appendix

This is where the rest of the tutorials are. They are not guaranteed to work with the latest version of Qiskit. They are organised into various topics:

3.1 Advanced Qiskit features

3.2 More on quantum information science

3.3 Further quantum algorithms and applications for approximate quantum computers

3.4 Teach Me Qiskit Award 2018: Top Submissions

3.5. Everything else


This project is licensed under the Apache License 2.0 - see the LICENSE file for details.