Sari la conținutul principal

doQumentation

doQumentation adaugă un frontend open-source bogat în funcții și ușor de utilizat la biblioteca completă de tutoriale, cursuri și documentație open-source IBM Quantum.

Conținutul open-source IBM Quantum

IBM oferă o mulțime de materiale de învățare despre calculul cuantic — toate open-source sub CC BY-SA 4.0:

  • Learning — Cursuri structurate de la bazele cuantice până la subiecte avansate
  • Tutorials — Peste 40 de tutoriale despre transpilare, atenuarea erorilor și altele
  • Documentation — Ghiduri și referință API pentru Qiskit
  • Source repo — Tot conținutul pe GitHub

Quantum Platform lor este mereu actualizat și bine proiectat — cel mai bun loc pentru citit, învățat și consultare.

Ce adaugă acest proiect

Documentația Qiskit a IBM este open-source (CC BY-SA 4.0), dar aplicația lor web nu este. doQumentation adaugă un frontend open-source cu execuție de cod live, injectare automată a credențialelor și mod simulator.

Poate fi implementat oriunde — de la GitHub Pages la Docker la RasQberry. Vezi toate funcțiile.

Primii pași

Nou în calculul cuantic? Începe cu cursul. Deja familiar cu Qiskit? Sari direct la un tutorial sau ghid.

Nu ai cont IBM Quantum? Activează Modul Simulator în Setări ca să rulezi tot codul fără înregistrare.

Execuția codului

Apasă Run pe orice bloc de cod. Prima apăsare pornește un kernel Jupyter prin Binder sau IBM Code Engine. După aceea, rulările sunt instantanee.

  • Modul Simulator (fără cont) — Activează Modul Simulator ca să rulezi toate notebook-urile cu AerSimulator sau FakeBackends cu model de zgomot. Zero configurare necesară.

  • Hardware IBM Quantum — Introdu token-ul API și CRN-ul în Setări o singură dată — credențialele sunt injectate automat la fiecare rulare. Creează un cont gratuit dacă nu ai unul.

Backend-uri de execuție disponibile

Fiecare tutorial are blocuri de cod executabile. Apasă Run ca să le rulezi folosind unul din cele patru backend-uri:

  1. Binder (implicit pe GitHub Pages) — Kernel Jupyter la distanță gratuit prin mybinder.org
  2. IBM Code Engine — Jupyter serverless pe contul tău IBM Cloud. Cold start în secunde în loc de minute. Configurează
  3. Jupyter Local (Docker / RasQberry) — Se conectează la serverul Jupyter local cu Qiskit preinstalat
  4. Server personalizat — Indică orice endpoint Jupyter în Setări

Când sunt disponibile mai multe backend-uri, alege care să fie folosit din Setări.

Opțiuni de implementare

doQumentation este disponibil ca:

Rulează local cu Podman / Docker

Instalează Podman Desktop sau Docker Desktop (Mac / Windows / Linux), apoi rulează:

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

Deschide http://localhost:8080 — execuția codului funcționează local, fără timp de așteptare Binder.

Pentru o versiune ușoară fără execuție locală de cod (~60 MB):

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

Folosești Docker în schimb? Înlocuiește podman cu docker — comenzile sunt identice. Imaginile sunt multi-arch (linux/amd64 + linux/arm64), deci Mac-urile Apple Silicon funcționează nativ.