q-docs: Interactive Execution for IBM's Qiskit Documentation

We recommend IBM's official Quantum Platform and their Qiskit documentation for reading and learning — always current, comprehensive, and well-designed:
Learning (13 courses) · Tutorials (40+) · Guides · API Reference · Source repo

This fork (q-docs) adds Binder support so you can run every notebook in your browser — no local Python installation, no environment setup. Useful for hands-on learning, workshops, and experimentation:

Hello World (q-docs)

Your first quantum circuit — build a Bell state and run it on a simulator or real hardware.

Tutorials

Step-by-step guides covering algorithms, error mitigation, transpilation, and more.

Courses

Structured learning paths from quantum information basics to utility-scale computing.

Guides

Practical how-to notebooks for transpilation, error mitigation, circuit building, and more.

Running notebooks on Binder Edit code blocks

Setting up your IBM Quantum account

Many notebooks connect to IBM Quantum backends. To set this up:

Register at quantum.cloud.ibm.com/registration — no credit card required for the first 30 days
Sign in at quantum.cloud.ibm.com and select region us-east (required for the free Open Plan)
Create an instance (free Open Plan) at Instances if you don't have one yet
Create an API key at quantum.cloud.ibm.com (or at cloud.ibm.com/iam/apikeys)
Copy your CRN (Cloud Resource Name) from your Instances page
Save your credentials once per Binder session — in any notebook, add a new cell and run:

from qiskit_ibm_runtime import QiskitRuntimeService
QiskitRuntimeService.save_account(
    token="<your-api-key>",
    instance="<your-crn>",
    overwrite=True
)

Binder sessions are ephemeral, so you need to re-enter your credentials each time.

Troubleshooting: If you can't see any instances or backends, check that your region is set to us-east and try switching accounts (menu in the upper-right corner). See the IBM guides on cloud setup, initializing your account, and saving credentials for more details.

No token? Use local testing mode

You can run most notebooks without an IBM Quantum account by replacing the backend with a local simulator. Replace service = QiskitRuntimeService() and backend = service.least_busy(...) with one of:

FakeBackend (simulates real device noise):

from qiskit_ibm_runtime.fake_provider import FakeManilaV2
backend = FakeManilaV2()

AerSimulator (ideal, no noise):

from qiskit_aer import AerSimulator
backend = AerSimulator()

Both work with SamplerV2 and EstimatorV2 from qiskit_ibm_runtime — no other code changes needed. See the local testing mode guide for more details.

doQumentation — Open-source website for IBM Quantum's tutorials and learning content

IBM's Qiskit tutorials and documentation are open-source, but the web application serving them is not. doQumentation provides an open-source frontend for IBM's Qiskit documentation content — independently hostable, runnable offline, and deployable on RasQberry. See it live at doQumentation.org — browse tutorials and courses, execute code via Binder, no install required.

Pre-installed packages

Package	Version
qiskit (with visualization extras)	~2.3.0
qiskit-aer	~0.17
qiskit-ibm-runtime	~0.43.1
qiskit-ibm-catalog	latest
qiskit-ibm-transpiler	latest
qiskit-addon-cutting	latest
pylatexenc	latest

This also includes matplotlib, numpy, scipy, and other standard scientific Python libraries via Qiskit dependencies.

Need more packages?

Some notebooks need extras. Install them in a cell:

!pip install -q scipy scikit-learn plotly

Or install everything at once:

!pip install -q scipy scikit-learn qiskit-experiments \
  plotly sympy qiskit-serverless qiskit-addon-sqd \
  qiskit-addon-utils qiskit-addon-mpf qiskit-addon-aqc-tensor[aer,quimb-jax] \
  qiskit-addon-obp pyscf ffsim gem-suite python-sat