Pour commencer
Tu débutes en informatique quantique ? Commence par le cours. Tu connais déjà Qiskit ? Plonge dans un tutoriel ou un guide.
Aucun compte IBM Quantum nécessaire. Par défaut, le code s'exécute sur un simulateur intégré. Ajoute ta clé API dans les Paramètres uniquement si tu veux utiliser du vrai matériel quantique.
Exécution de code
Clique sur Exécuter sur n'importe quel bloc de code. Le premier clic démarre un noyau Jupyter via Binder ou IBM Code Engine. Ensuite, les exécutions sont instantanées.
-
Mode Simulateur (aucun compte nécessaire) — Activé par défaut : le code s'exécute sur AerSimulator ou sur des FakeBackends avec modèle de bruit que tu peux choisir dans les Paramètres. Les pages qui nécessitent du matériel IBM Quantum ou les services cloud d'IBM l'indiquent lorsque tu les exécutes.
-
Matériel IBM Quantum — Entre ton jeton API et ton CRN dans les Paramètres une fois — les identifiants sont injectés automatiquement à chaque exécution. Crée un compte gratuit si tu n'en as pas.
Backends d'exécution disponibles
Chaque tutoriel contient des blocs de code exécutables. Clique sur Exécuter pour les exécuter en utilisant l'un des quatre backends :
-
Binder (par défaut sur GitHub Pages) — Noyau Jupyter distant gratuit via mybinder.org
-
IBM Code Engine — Jupyter serverless sur ton compte IBM Cloud. Démarrage à froid en secondes au lieu de minutes. Configurer
-
Jupyter local (Docker / RasQberry) — Se connecte au serveur Jupyter local avec Qiskit pré-installé
-
Serveur personnalisé — Pointe vers n'importe quel point de terminaison Jupyter dans les Paramètres
Lorsque plusieurs backends sont disponibles, choisis lequel utiliser depuis les Paramètres.
Options de déploiement
doQumentation est disponible sous forme de :
-
GitHub Pages — Site statique avec Binder ou IBM Code Engine pour l'exécution de code à distance
-
Docker — Environnement complet en local, utilisable hors ligne
-
RasQberry — Auto-hébergé sur Raspberry Pi avec noyau Jupyter local
Exécuter localement avec Podman / Docker
Installe Podman Desktop ou Docker Desktop (Mac / Windows / Linux), puis exécute :
# Full stack: site + Jupyter + Qiskit (~3 GB)
podman run -p 8080:80 -p 8888:8888 ghcr.io/janlahmann/doqumentation:jupyter
Ouvre http://localhost:8080 — l'exécution de code fonctionne localement, sans temps d'attente Binder.
Tu utilises Docker plutôt que Podman ? Remplace simplement podman par docker — les commandes sont identiques. Les images sont multi-architecture (linux/amd64 + linux/arm64), donc les Mac Apple Silicon fonctionnent nativement.
À propos et crédits
Contenu open-source d'IBM Quantum
IBM fournit une mine de ressources pédagogiques en informatique quantique — tout est open-source sous licence CC BY-SA 4.0 :
-
Learning — Cours structurés, des bases quantiques aux sujets avancés
-
Tutorials — Plus de 40 tutoriels sur la transpilation, l'atténuation d'erreurs, et plus encore
-
Documentation — Guides et référence API pour Qiskit
-
Source repo — Tout le contenu sur GitHub
Leur Quantum Platform est toujours à jour et bien conçue — le meilleur endroit pour lire, apprendre et consulter.
Ce que ce projet ajoute
La documentation Qiskit d'IBM est open-source (CC BY-SA 4.0), mais leur application web ne l'est pas. doQumentation ajoute une interface open-source avec exécution de code en direct, injection automatique des identifiants, et mode simulateur.
Déployable partout — de GitHub Pages à Docker en passant par RasQberry. Découvrez toutes les fonctionnalités.
Quand tu es prêt pour la suite
doQumentation t'aide à faire tes premiers pas avec Qiskit — lire, exécuter du code, et explorer — sans rien avoir à installer. Quand tu veux aller plus loin, dirige-toi vers la plateforme officielle d'IBM :
-
Exécuter sur du vrai matériel — crée un compte IBM Cloud gratuit et une instance Open Plan pour exécuter des circuits sur de vrais ordinateurs quantiques.
-
Contenu le plus récent — la plateforme d'apprentissage Qiskit d'IBM propose les cours, tutoriels et ajouts les plus récents (certains peuvent ne pas encore être dans doQumentation).
-
Développer localement — installe Qiskit sur ton propre ordinateur portable pour un travail de développement sérieux.
Construit sur la documentation open source d'IBM Quantum. Merci à l'équipe IBM Quantum de rendre ce contenu librement disponible sous licence CC BY-SA 4.0.