Aller au contenu principal

doQumentation

doQumentation ajoute une interface open-source riche en fonctionnalités et conviviale à la bibliothèque complète de tutoriels, cours et documentation open-source d'IBM Quantum.

Qiskit Ecosystem — doQumentation est membre de l'écosystème Qiskit

Contenu open-source d'IBM Quantum

IBM fournit une abondance de matériel d'apprentissage sur l'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 localementinstalle 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.

Pour commencer

Nouveau dans l'informatique quantique ? Commence par le cours. Déjà familier avec Qiskit ? Plonge dans un tutoriel ou un guide.

Pas de compte IBM Quantum ? Active le Mode Simulateur dans les Paramètres pour exécuter tout le code sans inscription.

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 requis) — Active le Mode Simulateur pour exécuter tous les notebooks avec AerSimulator ou des FakeBackends avec modèle de bruit. Aucune configuration requise.

  • 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 :

  1. Binder (par défaut sur GitHub Pages) — Noyau Jupyter distant gratuit via mybinder.org
  2. IBM Code Engine — Jupyter serverless sur ton compte IBM Cloud. Démarrage à froid en secondes au lieu de minutes. Configurer
  3. Jupyter local (Docker / RasQberry) — Se connecte au serveur Jupyter local avec Qiskit pré-installé
  4. 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 — Stack complète localement, capable de fonctionner 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.

Pour une version légère sans exécution de code locale (~60 Mo) :

# Static site only — code execution still works via Binder
podman run -p 8080:80 ghcr.io/janlahmann/doqumentation:latest

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.