Skip to content
A collection of Jupyter notebooks from the community and qiskit developers showing how to use Qiskit
Branch: master
Clone or download
attp Merge pull request #563 from omarcostahamido/master
fixing links "qiskit-tutorial(s)"
Latest commit 6c4b80d Mar 18, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
qiskit typos on tutorial and binder issues (#560) Mar 12, 2019
releases Remove snaphot warning (#473) Dec 26, 2018
to_sort Moving old files to a to_sort (#385) Nov 18, 2018
utils Formatting edits Jun 4, 2018
.gitignore Split monitoring tools into Terra and Jupyter sections (#463) Dec 22, 2018
LICENSE Initial commit Aug 4, 2017 fixing links Mar 12, 2019
environment.yml typos on tutorial and binder issues (#560) Mar 12, 2019

Qiskit Tutorials


Welcome to the Qiskit tutorials!

In this repository, we've put together a collection of Jupyter notebooks aimed at teaching people who want to use 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 are the IBM Q devices.


The notebooks for these tutorials can be viewed here on GitHub. But for the full experience, you'll want to interact with them!

The easiest way to do this is using the Binder image, which lets you use the notebooks via the web. This means that you don't need to download or install anything, but it also means that you should not insert any private information into the notebooks (such as your API key). We recommend as pointed out in issue #231 that after you are done using mybinder that you regenerate your token.

Please refer to this installation guide for setting up Qiskit and the tutorials on your own machine (this is the recommended way).


We have organized the tutorials into two sections:

1. Qiskit notebooks

We've collected a core reference set of notebooks in this section outlining the features of Qiskit. We will be keeping them up to date with the latest Qiskit version.

  • Basics is meant for those who are getting started.
  • Terra is meant for those who want to study circuits.
  • Ignis is meant for those who want to study noise.
  • Aqua is meant for those who want to develop applications on NISQ computers.
  • Jupyter is meant to highlight some cool Juypter features.

2. Community notebooks

Teaching quantum computing and qiskit has many different paths of learning. We love our community, and we love the contributions so keep them coming. Because Qiskit is changing so much, at the moment we cant keep this updated, but there are some great notebooks in here. See:

To go through the tutorials, load up the index.ipynb notebook and start learning.

Contribution Guidelines

If you'd like to contribute to Qiskit Tutorials, please take a look at our contribution guidelines. This project adheres to Qiskit's code of conduct. By participating, you are expect to uphold to this code.

We use GitHub issues for tracking requests and bugs. Please use our slack for discussion and simple questions. To join our Slack community use the link. For questions that are more suited for a forum we use the Qiskit tag in the Stack Exchange.

Authors and Citation

Qiskit Tutorials is the work of many people who contribute to the project at different levels. If you use Qiskit, please cite as per the included BibTeX file.


Apache License 2.0

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.