doQumentation
Uč se kvantové počítání s tutoriály a kurzy Qiskit od IBM a spouštěj kód přímo tady ve svém prohlížeči. Žádná instalace, k začátku nepotřebuješ ani účet.
Jak začít
Nováček v kvantovém výpočetnictví? Začni kurzem. Qiskit už znáš? Přejdi rovnou na tutoriál nebo průvodce.
Účet IBM Quantum není potřeba. Kód se ve výchozím nastavení spouští na vestavěném simulátoru. Svůj API klíč přidej v Nastavení jen tehdy, pokud chceš používat skutečný kvantový hardware.
Spouštění kódu
Klikni na Run u libovolného bloku kódu. První kliknutí spustí kernel Jupyter přes Binder nebo IBM Code Engine. Poté jsou spuštění okamžitá.
-
Simulátorový režim (účet není potřeba) — Ve výchozím nastavení zapnutý: kód se spouští na AerSimulator nebo na FakeBackends s modelem šumu, které si můžeš vybrat v Nastavení. Stránky, které potřebují hardware IBM Quantum nebo cloudové služby IBM, na to upozorní při spuštění.
-
Hardware IBM Quantum — Zadej svůj API token a CRN v Nastavení jednou — přihlašovací údaje se automaticky vkládají při každém spuštění. Vytvoř si bezplatný účet, pokud ho ještě nemáš.
Dostupné backendy pro spouštění
Každý tutoriál má spustitelné bloky kódu. Klikni Run a spusť je pomocí jednoho ze čtyř backendů:
-
Binder (výchozí na GitHub Pages) — Bezplatný vzdálený kernel Jupyter přes mybinder.org
-
IBM Code Engine — Bezserverový Jupyter na tvém IBM Cloud účtu. Studený start trvá sekundy místo minut. Nastavit
-
Lokální Jupyter (Docker / RasQberry) — Připojuje se k lokálnímu serveru Jupyter s předinstalovaným Qiskit
-
Vlastní server — Nasměruj na libovolný Jupyter endpoint v Nastavení
Když je k dispozici více backendů, vyber v Nastavení, který z nich použít.
Možnosti nasazení
doQumentation je k dispozici jako:
-
GitHub Pages — Statický web s Binder nebo IBM Code Engine pro vzdálené spouštění kódu
-
Docker — Plný stack lokálně, schopný fungovat offline
-
RasQberry — Self-hosted na Raspberry Pi s lokálním kernelem Jupyter
Spusť lokálně s Podman / Docker
Nainstaluj Podman Desktop nebo Docker Desktop (Mac / Windows / Linux), pak spusť:
# Full stack: site + Jupyter + Qiskit (~3 GB)
podman run -p 8080:80 -p 8888:8888 ghcr.io/janlahmann/doqumentation:jupyter
Otevři http://localhost:8080 — spouštění kódu funguje lokálně, žádné čekání na Binder.
Používáš Docker? Stačí nahradit podman za docker — příkazy jsou identické. Obrazy jsou multi-arch (linux/amd64 + linux/arm64), takže Apple Silicon Macy fungují nativně.
O projektu a poděkování
Open-source obsah IBM Quantum
IBM poskytuje bohaté výukové materiály o kvantovém výpočetnictví — vše open-source pod licencí CC BY-SA 4.0:
-
Learning — Strukturované kurzy od základů kvantového výpočetnictví po pokročilá témata
-
Tutorials — Přes 40 tutoriálů o transpilaci, zmírnění chyb a dalším
-
Documentation — Průvodci a reference API pro Qiskit
-
Source repo — Veškerý obsah na GitHubu
Jejich Quantum Platform je vždy aktuální a dobře navržená — nejlepší místo pro čtení, učení a vyhledávání informací.
Co tento projekt přidává
Dokumentace Qiskit od IBM je open-source (CC BY-SA 4.0), ale jejich webová aplikace není. doQumentation přidává open-source frontend s živým spouštěním kódu, automatickým vkládáním přihlašovacích údajů a simulátorovým režimem.
Nasaditelný kdekoliv — od GitHub Pages přes Docker až po RasQberry. Viz všechny funkce.
Až budeš připraven na víc
doQumentation ti pomáhá udělat první kroky s Qiskitem — číst, spouštět kód a prozkoumávat — aniž bys musel cokoli instalovat. Až budeš chtít pokročit dál, přejdi na oficiální platformu IBM:
-
Spouštěj na skutečném hardwaru — vytvoř si bezplatný účet IBM Cloud a instanci Open Plan, abys mohl spouštět obvody na skutečných kvantových počítačích.
-
Nejnovější obsah — vzdělávací platforma Qiskit od IBM má nejnovější kurzy, tutoriály a doplňky (některé z nich nemusí být v doQumentation ještě k dispozici).
-
Vyvíjej lokálně — nainstaluj si Qiskit na svůj vlastní notebook pro vážnější vývojářskou práci.
Postaveno na open-source dokumentaci IBM Quantum. Děkujeme týmu IBM Quantum za to, že tento obsah zpřístupňuje volně pod licencí CC BY-SA 4.0.