Aller au contenu principal

⚙️ Paramètres doQumentation

Configurez le serveur Jupyter utilisé pour exécuter le code Python dans les tutoriels.

Environnement actuel :

Mode simulateurⓘ

Activez pour exécuter les notebooks sans compte IBM Quantum. Tous les appels QiskitRuntimeService sont redirigés vers un simulateur local. Aucune modification de cellule nécessaire. Cela s'applique uniquement à l'exécution de code intégrée sur ce site — l'ouverture d'un notebook dans JupyterLab utilise le runtime Qiskit standard.

Les circuits transpilés et les résultats spécifiques au backend différeront du matériel réel lors de l'utilisation du mode simulateur. Les sorties attendues statiques affichées sur les pages reflètent les vrais backends IBM.

Préférences d'affichage

Taille de police du code

14px
from qiskit import QuantumCircuit

Sorties pré-calculées

Chaque page de notebook affiche des sorties pré-calculées (images, tableaux, texte) des exécutions originales d'IBM. Lorsque vous cliquez sur Run pour exécuter du code en direct, les sorties originales et vos nouveaux résultats en direct sont affichés côte à côte. Activez cette option pour masquer les sorties originales pendant l'exécution en direct, en ne gardant que vos résultats visibles.

Avertissements Python

Par défaut, les avertissements Python (avis de dépréciation, indices d'exécution) sont supprimés pour une sortie de notebook plus propre. Désactivez ceci pour voir tous les avertissements — utile pour le débogage ou l'apprentissage des modifications d'API.

Progression d'apprentissage

Votre progression de lecture et d'exécution est suivie localement dans votre navigateur. Les pages visitées affichent un ✓ dans la barre latérale ; les notebooks exécutés affichent un ▶.

Aucune progression suivie pour le moment. Visitez des tutoriels et guides pour commencer le suivi.

Autre

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
Join Workshop

Enter the workshop URL and token provided by your instructor. This connects you to the workshop's Code Engine instance.

Compte IBM Quantum

Note de sécurité : Les identifiants sont stockés dans le localStorage de votre navigateur en texte clair. Ils ne sont pas chiffrés et peuvent être lus par les extensions du navigateur ou toute personne ayant accès à cet appareil. Utilisez le paramètre d'expiration ci-dessous pour limiter l'exposition, et supprimez les identifiants lorsque vous avez terminé. Pour les ordinateurs partagés ou publics, privilégiez la méthode manuelle save_account() décrite ci-dessous.

Entrez vos identifiants IBM Quantum une fois ici. Ils seront injectés automatiquement via save_account() au démarrage du noyau, vous n'avez donc pas besoin de les saisir dans chaque notebook. Cela s'applique uniquement à l'exécution de code intégrée sur ce site — l'ouverture d'un notebook dans JupyterLab nécessite d'appeler save_account() manuellement.

  1. S'inscrire sur quantum.cloud.ibm.com/registration — aucune carte de crédit requise pour les 30 premiers jours
  2. Se connecter sur quantum.cloud.ibm.com
  3. Instance — Créez une instance Open Plan gratuite sur Instances si vous n'en avez pas encore
  4. Token API — Cliquez sur votre icône de profil (en haut à droite), puis "API token". Copiez la clé.
  5. CRN — Copiez la chaîne CRN depuis votre page Instances

Pour des étapes détaillées, consultez le guide Configurer l'authentification d'IBM (étape 2).

Alternative : Exécuter save_account() manuellement dans une cellule de notebook

Si vous préférez ne pas stocker les identifiants dans ce navigateur, collez ceci dans une cellule de code et exécutez-la. Les identifiants sont enregistrés dans le stockage temporaire du noyau Binder et perdus à la fin de la session.

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

Packages Binder

Lors de l'exécution sur GitHub Pages, le code s'exécute via MyBinder. L'environnement Binder inclut les packages Qiskit de base pré-installés :

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

Certains notebooks nécessitent des packages supplémentaires. Vous pouvez les installer à la demande en exécutant ceci dans une cellule de code :

!pip install -q <package>

Ou installer tous les packages optionnels en une fois :

!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

Avancé

L'URL de base de votre serveur Jupyter (par ex., http://localhost:8888)
Token de jupyter server --generate-config ou affiché au démarrage

Aide à la configuration

Configuration RasQberry

Si vous exécutez sur un RasQberry Pi, le serveur Jupyter devrait être détecté automatiquement. Sinon, assurez-vous que le service jupyter-tutorials est en cours d'exécution :

sudo systemctl status jupyter-tutorials

Configuration Jupyter locale

Démarrez un serveur Jupyter avec CORS activé :

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

Configuration Docker

Le conteneur Docker génère un token Jupyter aléatoire au démarrage. L'exécution de code via le site web (port 8080) fonctionne automatiquement — aucun token nécessaire. Le token n'est requis que pour l'accès direct à JupyterLab sur le port 8888.

Pour récupérer le token depuis les logs du conteneur :

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

Pour définir un token fixe :

JUPYTER_TOKEN=mytoken docker compose --profile jupyter up

Serveur distant

Pour les serveurs distants, assurez-vous que CORS est configuré pour autoriser les connexions depuis ce site. Ajoutez ce qui suit à votre jupyter_server_config.py :

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