A collection of Jupyter notebooks using Qiskit
Clone or download
Latest commit 0342265 Sep 12, 2018


Qiskit Tutorials

License Binder

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

In this repository, we've put together a collection of Jupyter notebooks aimed at teaching people who want to use the Qiskit for writing quantum computing programs and executing them on one of several backends (online quantum processors, online simulators, and local simulators). The online quantum processors connects to the IBM Q devices.

Installation and Setup

Please refer to this installation guide for installing and setting up Qiskit and tutorials on your own machine.

You can also run the tutorials online without installation on the IBM Data Science Experience following the instructions in this notebook.


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

3. Appendix

This is where the rest of the tutorials are. They are not guaranteed to work with the latest version of Qiskit, but we will do our best.


If you would like to contribute to the tutorials, there are a number of ways to get involved:

  • Issues: Issues can be reported with GitHub issue reporting for this repository. Select New issue, fill in a descriptive title, and provide as much detail as is needed for the issue to be reproduced.
  • Notebooks: If you would like to contribute a notebook, please create a fork of the repository from the master branch and create a pull request for your change. Note that new notebooks should be placed in the relevant part of the Appendix section. We will discuss in the Slack channel which of these should be in the Reference section.


An alphabetical list of contributors can be found here. If you have contributed to these tutorials, please include your name there.


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