Zom Hauptinhalt springe

⚙️ doQumentation-Instellunge

Konfigureeert dä Jupyter-Server, dä för de Ußföhrung vun Python-Code en Tutorials jenutzt weed.

Aktuell Umjebung:

Simulatormodusⓘ

Aktiveet, för Notebooks ohne IBM Quantum-Konto ze laufe. All QiskitRuntimeService-Oprööf weede zo enem lokale Simulator ömjelaitet. Kein Zell-Änderunge nüdich. Dat jelld nur för einjebettde Code-Ußföhrung op dä Sigg hee — e Notebook en JupyterLab ze öffne benutzt de standard Qiskit-Runtime.

Transpileetde Schaltkrees un backend-spezifische Erjebnis weede sich vun echter Hardware ongerscheide, wann Simulatormodus jenutzt weed. Statische erwaat Ußjaabe op Sigge speejele echte IBM-Backends widder.

Aanzeijeeinstellunge

Code-Schreffjrüüße

14px
from qiskit import QuantumCircuit

Vorberechnete Ußjaabe

Jede Notebook-Sigg zeich vorberechnete Ußjaabe (Bellder, Tabelle, Text) vun IBM singe ursprüngleche Lööf. Wann Ehr Run kleckt för Code live ußzeföhre, weede sowohl de ursprüngleche Ußjaabe als och Ühr neue live Resultaate nevveenander jezeich. Aktiveet dä Toggle för de ursprüngleche Ußjaabe während live Ußföhrung ze verstecke, un nur Ühr Resultaate sechtbor ze maache.

Python-Warnunge

Standardmäßich weede Python-Warnunge (Avschaffungs-Hendeise, Laufzigk-Tipps) ongerdröck för suberere Notebook-Ußjaab. Deaktiveet dat för all Warnunge ze siehn — nötzlich för Fehlerbehebung oder för övver API-Änderunge ze länne.

Lännfortschrett

Ühr Läs- un Ußföhrungs-Fortschrett weed lokal en Ührem Browser verfollt. Besöökde Sigge zeije en ✓ en de Siggeliss; ußjeföhrde Notebooks zeije en ▶.

Noch kein Fortschrett verfollt. Besöök Tutorials un Anleitunge för ze aanfange.

Söns

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

Secherheitshendeiss: Zugangsdaate weede en Ührem Browser singe localStorage als Klartext jespeichert. Se sin nit verschlösselt un künne vun Browser-Erweiterunge oder jedereine met Zogriff op dat Jerät jelässe weede. Benutzt de Avlaaf-Instellung unne för Belastung ze begränze, un löscht de Zugangsdaate, wann Ehr fäädich sitt. För jedeilde oder öffentliche Computer, bevorzecht de manuelle save_account()-Method, die unne beschrevve es.

Jitt Ühr IBM Quantum-Zugangsdaate einmol hee en. Se weede övver save_account() beim Kernel-Start auto-injizeet, su dat Ehr se nit en jedes Notebook enjavve müsst. Dat jelld nur för einjebettde Code-Ußföhrung op dä Sigg hee — för e Notebook en JupyterLab ze öffne, moss save_account() manuell oproofe weede.

  1. Rejistreeere bei quantum.cloud.ibm.com/registration — kein Kredikaat för de erschde 30 Dääch nüdich
  2. Enmelde bei quantum.cloud.ibm.com
  3. Instanz — Määt en kostenlose Open Plan-Instanz bei Instanze, wann Ehr noch kein hant
  4. API Token — Kleckt op Ühr Profil-Symbol (bovve rähts), dann "API token". Kopeert dä Schlössel.
  5. CRN — Kopeert dä CRN-String vun Ühr Instanze-Sigg

För detailleete Schrett, luurt en IBM singe Authentifizeerung inrichte-Leitfade (Schrett 2).

Alternativ: save_account() manuell en ener Notebook-Zell laufe losse

Wann Ehr et bevorzecht, kein Zugangsdaate en däm Browser ze speichere, plakkt dat hee en en beleebije Code-Zell un loot se laufe. Zugangsdaate weede em temporäre Speicher vum Binder-Kernel jespeichert un sin futsch, wann de Sitzung endet.

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

Binder-Pakete

Wann op GitHub Pages jelaufe weed, weed Code övver MyBinder ußjeföhrt. De Binder-Umjebung hät Qiskit-Hauptpakete vorigestalleet:

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

Einije Notebooks benüdije zosätzliche Pakete. Ehr künnt se op Aanfraach installeeere, endem Ehr dat en ener Code-Zell laufe loot:

!pip install -q <package>

Oder all optionale Pakete op ens installeeere:

!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

De Basis-URL vun Ührem Jupyter-Server (z.B., http://localhost:8888)
Token vun jupyter server --generate-config oder beim Start aanjezeich

Inrichtungs-Hölp

RasQberry-Inrichtung

Wann Ehr op enem RasQberry Pi loof, sollt dä Jupyter-Server automatisch erkannt weede. Wann nit, stellt secher, dat de jupyter-tutorials-Döngs läuf:

sudo systemctl status jupyter-tutorials

Lokale Jupyter-Inrichtung

Start ene Jupyter-Server met CORS aktiveet:

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

Docker-Inrichtung

Dä Docker-Container jeneeet beim Start en zofällijet Jupyter-Token. Code-Ußföhrung övver de Websigg (Port 8080) funkzioneet automatisch — kein Token nüdich. Dat Token es nur för diräkte JupyterLab-Zogriff op Port 8888 erforderlich.

För dat Token us de Container-Logs ze hahle:

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

För en festes Token ze setze:

JUPYTER_TOKEN=mytoken docker compose --profile jupyter up

Fännserver

För Fännserver, stellt secher, dat CORS konfigueet es för Verbindunge vun dä Sigg hee ze erlaube. Fööcht dat Folgende zo Ühr jupyter_server_config.py derbei:

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