Zum Hauptinhalt springe

⚙️ doQumentation Yyställige

Konfiguriere de Jupyter-Server wo für d'Uusfierig vu Python-Code in Tutorials verwändet wird.

Aktuelli Umgebig: 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
Sicherheitshinwys: Credentials werde in dyym Browser's localStorage im Klartext gspycheret. Sie sin nit verschlüsselt und chöne vu Browser-Erwyterige oder jedem mit Zugriff uf des Gerät gläse werre. Verwänd d'Ablaufyystallig unte für Exposition z'begränze, und lösch Credentials wenn du fertig bisch. Für gmeinsami oder öffentlichi Computer, bevorzug d'manuelli save_account()-Methode wie unte beschribe.

Gib dyy IBM Quantum Credentials äimol do yy. Sie werde über save_account() auto-injiziert wenn de Kernel startet, so dass du sie nit in jedes Notebook yygäh muesch. Des gilt numme für yybetteti Code-Uusfierig uf dere Siite — bim Ufmache vumene Notebook in JupyterLab muesch save_account() manuäll ufruefe.

  1. Registriere uf quantum.cloud.ibm.com/registration — kei Kreditkarte nötig für d'erschte 30 Täg
  2. Aamälde uf Instances
  3. Instanz — Erstell ä koschtefrii Open-Plan-Instanz uf home page falls du no kei häsch
  4. API Token — Klick uf dyy Profil-Icon (obe rächts), denn "API token". Kopier de Schlüssel.

Für detaillierti Schritt, lueg IBM's Authentifizierig yyrichte-Guide (Schritt 2).

Alternativ: save_account() manuäll in ere Notebook-Zälle uusfiere

Falls du lieber kei Credentials in däm Browser spychere möchtisch, füeg des in irgendä Code-Zälle yy und fier's us. Credentials werde im temporäre Spycher vom Binder-Kernel gspycheret und sin verlore wenn d'Session ändet.

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

Aazeigyyställige

Code-Schriftgrösse

14px
from qiskit import QuantumCircuit

Vorberchneti Uusgab

Jedi Notebook-Siite zeigt vorberchneti Uusgab (Bilder, Tabälle, Text) vu IBM's ursprüngliche Läuf. Wenn du Run klicksch für Code live uuszfiere, werde sowohl d'ursprünglichi Uusgab as au dyy neui live Ergebnis näbenand aazäigt. Aktivier des Toggle für d'ursprünglichi Uusgab während live Uusfierig z'verstecke, so dass numme dyy Ergebnis sichtbar sin.

Python-Warnige

Standardmässig werde Python-Warnige (Deprecation-Hinwys, Runtime-Hinwys) underdruckt für saubereri Notebook-Uusgab. Deaktivier des für alli Warnige z'gsee — nützlich für Debugging oder zum Lärne über API-Änderige.

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.

Lärnfortschritt

Dyy Läs- und Uusfierigs-Fortschritt wird lokal in dyym Browser verfolgt. Bsuechti Siite zeige ä ✓ in de Syteleischte; uusgfierti Notebooks zeige ä ▶.

No kei Fortschritt verfolgt. Bsuech Tutorials und Guides für z'starte mit Tracking.

Läsezeiche

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-Paket

Bim Uusfiere uf GitHub Pages wird Code über MyBinder uusgfiert. D'Binder-Umgebig enthält vorinstallierti Kern-Qiskit-Paket:

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

Manchi Notebooks bruche zusätzlichi Paket. Du chasch sie uf Abruf installiere indem du des in ere Code-Zälle uusfiersch:

!pip install -q <package>

Oder alli optionali Paket uf äimol 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 laufsch, sollt de Jupyter-Server automatisch erkannt werre. Falls nit, stell sicher dass de jupyter-tutorials-Service lauft:

sudo systemctl status jupyter-tutorials

Lokals Jupyter-Setup

Start ä Jupyter-Server mit aktiviertem CORS:

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

Docker-Setup

De Docker-Container generiert ä zufällige Jupyter-Token bim Start. Code-Uusfierig über d'Websiite (Port 8080) funktioniert automatisch — kei Token nötig. De Token wird numme für direkte JupyterLab-Zugriff uf Port 8888 benötigt.

Für de Token us de Container-Logs abzruefe:

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

Für ä feschte Token z'setze:

JUPYTER_TOKEN=mytoken docker compose --profile jupyter up

Remote-Server

Für Remote-Server, stell sicher dass CORS konfiguriert isch für Verbindige vu dere Siite z'erlaube. Füeg Folgens zu dyym jupyter_server_config.py hiizu:

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