Zum Hauptinhalt springe

⚙️ doQumentation Eistellunge

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

Aktuelle Umgebung:

Simulator-Modusⓘ

Aktivier zum Ausführe vo Notebooks ohne en IBM Quantum Account. Alle QiskitRuntimeService-Ufrufe werded zu eme lokale Simulator umgleitet. Koi Zell-Änderunge nötig. Des gilt nur fer eingebettete Code-Ausführung uf dera Seid — beim Öffne vomene Notebook in JupyterLab wrd d'Standard Qiskit-Runtime verwended.

Transpilierte Schaltkreise und backend-spezifische Ergebnisse unterscheided sich vo echter Hardware beim Verwende vom Simulator-Modus. Statische erwartete Ausgabe uf de Seide spiegled echde IBM-Backends wider.

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.

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.

Sonschtiges

Advanced Settings

IBM Cloud Code Engine

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. Create a Code Engine project in your preferred region
  3. Deploy a new application with image ghcr.io/janlahmann/doqumentation-codeengine:latest, port 8080
  4. Set environment variable JUPYTER_TOKEN to a secure token (min 32 characters) and CORS_ORIGIN to your domain

IBM Quantum Account

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 quantum.cloud.ibm.com
  3. Instanz — Erstell a kostenlose Open-Plan-Instanz uf Instanze falls du no koi hosch
  4. API Token — Klick uf dei Profil-Icon (obe rechts), dann "API token". Kopier de Schlüssel.
  5. CRN — Kopier de CRN-String vo deiner Instanze-Seid

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
)

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

Erweitert

D'Basis-URL vo deim Jupyter-Server (z.B. http://localhost:8888)
Token vo jupyter server --generate-config oder beim Start azzeigt

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