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:

Simulator-Modusⓘ

Aktivier zum Uusfiere vu Notebooks ohni ä IBM Quantum Account. Alli QiskitRuntimeService-Ufruef werde zu eme lokale Simulator umgleitet. Kei Zäll-Änderige nötig. Des gilt numme für yybetteti Code-Uusfierig uf dere Siite — bim Ufmache vumene Notebook in JupyterLab wird d'Standard Qiskit-Runtime verwändet.

Transpilierti Schaltkreis und backend-spezifischi Ergebnis unterscheide sich vu echter Hardware bim Verwände vom Simulator-Modus. Statischi erwarteti Uusgab uf de Siite spiegle echti IBM-Backends wider.

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.

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.

Sonschtigs

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

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 quantum.cloud.ibm.com
  3. Instanz — Erstell ä koschtefrii Open-Plan-Instanz uf Instanze falls du no kei häsch
  4. API Token — Klick uf dyy Profil-Icon (obe rächts), denn "API token". Kopier de Schlüssel.
  5. CRN — Kopier de CRN-String vu dyynere Instanze-Siite

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
)

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

Erwiiteret

D'Basis-URL vu dyym Jupyter-Server (z.B. http://localhost:8888)
Token vu jupyter server --generate-config oder bim Start aazäigt

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