Vai al contenuto principale

doQumentation

doQumentation aggiunge un frontend open-source ricco di funzionalità e intuitivo alla biblioteca completa di tutorial, corsi e documentazione open-source di IBM Quantum.

Contenuti open-source di IBM Quantum​

IBM fornisce una vasta quantità di materiale didattico sul quantum computing — tutto open source sotto licenza CC BY-SA 4.0:

  • Learning — Corsi strutturati dalle basi quantistiche agli argomenti avanzati
  • Tutorials — Oltre 40 tutorial su transpilazione, mitigazione degli errori e altro
  • Documentation — Guide e riferimenti API per Qiskit
  • Source repo — Tutti i contenuti su GitHub

La loro Quantum Platform è sempre aggiornata e ben progettata — il miglior posto per leggere, imparare e consultare.

Cosa aggiunge questo progetto​

La documentazione Qiskit di IBM è open source (CC BY-SA 4.0), ma la loro applicazione web non lo è. doQumentation aggiunge un frontend open-source con esecuzione di codice dal vivo, iniezione automatica delle credenziali e modalità simulatore.

Distribuibile ovunque — da GitHub Pages a Docker a RasQberry. Veda tutte le funzionalità.

Per iniziare​

Nuovo al quantum computing? Inizi con il corso. Già familiare con Qiskit? Passi direttamente a un tutorial o una guida.

Nessun account IBM Quantum? Attivi la Modalità Simulatore nelle Impostazioni per eseguire tutto il codice senza registrazione.

Esecuzione del codice​

Clicca Run su qualsiasi blocco di codice. Il primo click avvia un kernel Jupyter tramite Binder o IBM Code Engine. Successivamente, le esecuzioni sono istantanee.

  • Modalità Simulatore (nessun account necessario) — Attivi la Modalità Simulatore per eseguire tutti i notebook con AerSimulator o FakeBackends con modelli di rumore. Nessuna configurazione richiesta.

  • Hardware IBM Quantum — Inserisca il suo token API e CRN nelle Impostazioni una volta — le credenziali vengono iniettate automaticamente ad ogni esecuzione. Crei un account gratuito se non ne ha uno.

Backend di esecuzione disponibili

Ogni tutorial ha blocchi di codice eseguibili. Clicca Run per eseguirli usando uno dei quattro backend:

  1. Binder (predefinito su GitHub Pages) — Kernel Jupyter remoto gratuito tramite mybinder.org
  2. IBM Code Engine — Jupyter serverless sul tuo account IBM Cloud. Avvio a freddo in pochi secondi anziché minuti. Configura
  3. Jupyter locale (Docker / RasQberry) — Si connette al server Jupyter locale con Qiskit preinstallato
  4. Server personalizzato — Punta a qualsiasi endpoint Jupyter nelle Impostazioni

Quando più backend sono disponibili, scegli quale usare dalle Impostazioni.

Opzioni di distribuzione

doQumentation è disponibile come:

Esegua localmente con Podman / Docker

Installi Podman Desktop o Docker Desktop (Mac / Windows / Linux), poi esegua:

# Full stack: site + Jupyter + Qiskit (~3 GB)
podman run -p 8080:80 -p 8888:8888 ghcr.io/janlahmann/doqumentation:jupyter

Apra http://localhost:8080 — l'esecuzione del codice funziona localmente, nessun tempo di attesa per Binder.

Per una versione leggera senza esecuzione locale del codice (~60 MB):

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

Usa Docker invece? Sostituisca semplicemente podman con docker — i comandi sono identici. Le immagini sono multi-arch (linux/amd64 + linux/arm64), quindi i Mac Apple Silicon funzionano nativamente.