Qrisp Starter Tutorial

Get hands-on experience with Qrisp and IQM quantum hardware

This interactive notebook introduces you to quantum programming with Qrisp and shows you how to run quantum algorithms on real IQM hardware. You’ll learn the differences between simulators, mock backends, and actual quantum computers.

Run notebooks during the school

You can run this notebook and other code examples during the school using Binder - just click the badge below:

Binder

Binder is free, requires no installation, and runs directly in your browser! It’s pre-configured with all necessary dependencies (including qrisp and IQM interface), so you can start coding immediately without any setup.

Or download qrisp-starter.ipynb to run locally.

The notebook is self-contained and portable - works with Binder or locally!

What you’ll learn

  • Setting up Qrisp with IQM backend support

  • Running quantum algorithms on real IQM hardware

  • Comparing simulator vs. mock backend vs. real quantum hardware results

  • Understanding NISQ (Noisy Intermediate-Scale Quantum) effects

Prerequisites

  • Python 3.10, 3.11, or 3.12 (NOT 3.13+ due to Qrisp compatibility)

  • Jupyter notebook environment (VS Code or JupyterLab)

  • IQM API token from IQM Resonance

IQM Token Setup

You can generate your IQM token from IQM Resonance and use it in two ways:

  1. Save as file: Create a token.txt file in the same directory as your notebook and save your token there

  2. Paste directly: Copy and paste your token explicitly in the notebook code

The notebook will show you how to read from the token file or use it directly.

Important

Credit Costs: Running on real IQM hardware (Sirius) consumes credits at 0.30 credits/second. The notebook includes a free mock backend and local simulator for testing without using credits.

Interactive tutorial

View the complete notebook on the next page →

The notebook is rendered on a separate page with syntax highlighting, outputs, and full interactivity preview. Click the link above or navigate using the sidebar.

Tip

After viewing the notebook, don’t forget to download it using the link at the top of this page to run it on your own machine!

See also

Related resources: