Zum Hauptinhalt springe

⚙️ doQumentation Eistellunge

Konfiguriere de Jupyter-Server der fer d'Ausführung vo Python-Code in Tutorials verwended wrd.

Aktuelle Umgebung: Not detected

Server Backend

Choose which backend to use for code execution:


Execution Mode

Choose what happens when you click Run on tutorial pages. This applies to embedded code execution on this site only — opening a notebook in JupyterLab uses the standard Qiskit runtime.

Changes take effect on the next kernel session. If code is running, click Back then Run to apply.

IBM Quantum Account

Setup instructions & security notes
Sicherheitshinweis: Credentials werded in deim Browser's localStorage im Klartext gspeichert. Sie send ned verschlüsselt und könned vo Browser-Erweiterunge oder jedem mit Zugriff uf des Gerät glesa werra. Verwend d'Ablaufeistellung unten fer Exposition z'begrenzen, und lösch Credentials wenn du fertig bisch. Fer gemeinsam oder öffentliche Computer, bevorzug d'manuelle save_account()-Methode wie unten beschriebe.

Gib dei IBM Quantum Credentials oimol hier ei. Sie werded über save_account() auto-injiziert wenn dr Kernel startet, so dass du se ned in jedes Notebook eigebe mussch. Des gilt nur fer eingebettete Code-Ausführung uf dera Seid — beim Öffne vomene Notebook in JupyterLab mussch save_account() manuell ufrufe.

  1. Registriere uf quantum.cloud.ibm.com/registration — koi Kreditkarte nötig fer d'erschde 30 Tag
  2. Amelde uf Instances
  3. Instanz — Erstell a kostenlose Open-Plan-Instanz uf home page falls du no koi hosch
  4. API Token — Klick uf dei Profil-Icon (obe rechts), dann "API token". Kopier de Schlüssel.

Fer detaillierte Schritte, sieh IBM's Authentifizierung eirichte-Guide (Schritt 2).

Alternative: save_account() manuell in einer Notebook-Zelle ausfiere

Falls du lieber koi Credentials in desem Browser speichere möchtsch, füg des in irgendoi Code-Zelle ei und führ's aus. Credentials werded im temporäre Speicher vom Binder-Kernel gspeichert und send verlora wenn d'Session endet.

from qiskit_ibm_runtime import QiskitRuntimeService
QiskitRuntimeService.save_account(
    token="YOUR_API_TOKEN",
    instance="YOUR_CRN",
    overwrite=True
)

Anzeigeeistellunge

Code-Schriftgröße

14px
from qiskit import QuantumCircuit

Vorberechnete Ausgabe

Jede Notebook-Seid zeigt vorberechnete Ausgabe (Bilder, Tabelle, Text) vo IBM's ursprüngliche Läuf. Wenn du Run klicksch fer Code live auszfiere, werded sowohl d'ursprüngliche Ausgabe als au dei neue live Ergebnisse nebeneinander azzeigt. Aktivier des Toggle fer d'ursprüngliche Ausgabe während live Ausführung z'verstecke, so dass nur dei Ergebnisse sichtbar send.

Python-Warnunge

Standardmäßig werded Python-Warnunge (Deprecation-Hinweise, Runtime-Hinweise) unterdrückt fer sauberere Notebook-Ausgabe. Deaktivier des fer alle Warnunge z'sehe — nützlich fer Debugging oder zum Lerne über API-Änderunge.


Manage Your Data

All data is stored locally in your browser (localStorage). Nothing is sent to our servers. Clearing your browser data or using a different browser/device starts fresh.

Lernfortschritt

Dei Lese- und Ausführungsfortschritt wrd lokal in deim Browser verfolgt. Besuchde Seide zeigen en in dr Seideleischd; ausgfiehrte Notebooks zeigen en .

No koi Fortschritt verfolgt. Besuch Tutorials und Guides fer z'starta mit Tracking.

Lesezeiche

No bookmarks yet. Use the bookmark button on any page to save it here.

Display & UI

Sessions & Credentials

Reset Everything

Remove all saved data including progress, bookmarks, display preferences, and credentials.


Advanced Settings

IBM Cloud Code Engine

IBM Cloud Code Engine provides a fast, serverless Jupyter kernel powered by your own IBM Cloud account. Startup takes seconds instead of minutes. Free tier covers ~14 hours/month.

Setup Instructions
  1. Create an IBM Cloud account at cloud.ibm.com (free tier available)
  2. Go to the IBM Cloud Code Engine console and create a new project in your preferred region
  3. Create a new application with image ghcr.io/janlahmann/doqumentation-codeengine:latest, listening port 8080
    Sizing: 1 vCPU / 2 GB for single user, 8 vCPU / 16 GB for workshops (up to 80 users)
  4. Set environment variables: JUPYTER_TOKEN to a secure token (min 32 characters) and CORS_ORIGIN to your domain (e.g. https://doqumentation.org)

For workshop sizing details, see the workshop setup documentation.

Binder-Pakete

Beim Ausführe uf GitHub Pages wrd Code über MyBinder ausgfiert. D'Binder-Umgebung enthält vorinstallierte Kern-Qiskit-Pakete:

qiskit[visualization], qiskit-aer,
qiskit-ibm-runtime, pylatexenc,
qiskit-ibm-catalog, qiskit-addon-utils, pyscf

Manche Notebooks brauched zusätzliche Pakete. Du kannsch se uf Abruf installiere indem du des in einer Code-Zelle ausfiersch:

!pip install -q <package>

Oder alle optionale Pakete uf oimol installiere:

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

Setup-Hilf

RasQberry-Setup

Falls du uf eme RasQberry Pi läufsch, sollte dr Jupyter-Server automatisch erkannt werre. Falls ned, stell sicher dass dr jupyter-tutorials-Service läuft:

sudo systemctl status jupyter-tutorials

Lokales Jupyter-Setup

Start en Jupyter-Server mit aktiviertem CORS:

jupyter server --ServerApp.token='rasqberry' \
  --ServerApp.allow_origin='*' \
  --ServerApp.disable_check_xsrf=True

Docker-Setup

Dr Docker-Container generiert en zufällige Jupyter-Token beim Start. Code-Ausführung über d'Webseid (Port 8080) funktioniert automatisch — koi Token nötig. Dr Token wrd nur fer direkten JupyterLab-Zugriff uf Port 8888 benötigt.

Fer de Token aus de Container-Logs abzrufe:

docker compose --profile jupyter logs | grep "Jupyter token"

Fer en feschde Token z'setze:

JUPYTER_TOKEN=mytoken docker compose --profile jupyter up

Remote-Server

Fer Remote-Server, stell sicher dass CORS konfiguriert isch fer Verbindunge vo dera Seid z'erlauben. Füg Folgendes zu deim jupyter_server_config.py hinzu:

c.ServerApp.allow_origin = '*'
c.ServerApp.allow_credentials = True