doQumentation
doQumentation додає багатофункціональний, зручний, відкритий інтерфейс до повної бібліотеки відкритих навчальних матеріалів, курсів та документації IBM Quantum.
Відкритий контент IBM Quantum
IBM надає величезну кількість навчальних матеріалів з квантових обчислень — усе відкрите під ліцензією CC BY-SA 4.0:
- Навчання — Структуровані курси від основ квантової механіки до складних тем
- Посібники — Понад 40 посібників з транспіляції, зменшення помилок та інше
- Документація — Довідники та API-довідка для Qiskit
- Вихідний репозиторій — Весь контент на GitHub
Їхня Quantum Platform завжди актуальна та добре розроблена — найкраще місце для читання, навчання та довідкової інформації.
Що додає цей проект
Документація Qiskit від IBM є відкритою (CC BY-SA 4.0), але їхній веб-додаток — ні. doQumentation додає відкритий інтерфейс з можливістю виконання коду в реальному часі, автоматичним впровадженням облікових даних та режимом симулятора.
Може бути розгорнутий будь-де — від GitHub Pages до Docker до RasQberry. Дивись всі можливості.
Коли ти готовий до більшого
doQumentation допомагає тобі зробити перші кроки з Qiskit — читати, запускати код та досліджувати — без необхідності щось встановлювати. Коли ти будеш готовий рухатися далі, переходь на офіційну платформу IBM:
- Запуск на реальному обладнанні — створи безкоштовний обліковий запис IBM Cloud та екземпляр Open Plan, щоб виконувати схеми на справжніх квантових комп’ютерах.
- Найновіший вміст — навчальна платформа Qiskit IBM містить найновіші курси, навчальні матеріали та доповнення (деякі з них можуть ще не бути в doQumentation).
- Розробка локально — встанови Qiskit на власному ноутбуці для серйозної розробки.
Побудовано на основі відкритої документації IBM Quantum. Дякуємо команді IBM Quantum за те, що цей вміст вільно доступний під ліцензією CC BY-SA 4.0.
Початок роботи
Новачок у квантових обчисленнях? Почни з курсу. Вже знайомий з Qiskit? Переходь до посібника або довідника.
Немає облікового запису IBM Quantum? Увімкни Режим симулятора в Налаштуваннях, щоб виконувати весь код без реєстрації.
Виконання коду
Натисни Run на будь-якому блоці коду. Перше натискання запускає безкоштовне ядро Jupyter через Binder or IBM Code Engine. Після цього виконання миттєве.
-
Режим симулятора (не потрібен обліковий запис) — Увімкни Режим симулятора, щоб виконувати всі ноутбуки з AerSimulator або FakeBackends з моделями шуму. Налаштування не потрібне.
-
Апаратне забезпечення IBM Quantum — Введи свій API-токен та CRN у Налаштуваннях один раз — облікові дані автоматично впроваджуються при кожному запуску. Створи безкоштовний обліковий запис, якщо у тебе його немає.
Доступні бекенди для виконання
Кожен посібник має виконувані блоки коду. Натисни Run, щоб виконати їх, використовуючи один із чотирьох бекендів:
- Binder (за замовчуванням на GitHub Pages) — Безкоштовне віддалене ядро Jupyter через mybinder.org
- IBM Code Engine — Безсерверний Jupyter на твоєму обліковому записі IBM Cloud. Холодний старт за секунди замість хвилин. Налаштувати
- Локальний Jupyter (Docker / RasQberry) — Підключається до локального сервера Jupyter з попередньо встановленим Qiskit
- Власний сервер — Вкажи будь-яку кінцеву точку Jupyter у Налаштуваннях
Коли доступно кілька серверів, обери, який використовувати, у Налаштуваннях.
Варіанти розгортання
doQumentation доступний як:
- GitHub Pages — Статичний сайт з Binder or IBM Code Engine для віддаленого виконання коду
- Docker — Повний стек локально, здатний працювати офлайн
- RasQberry — Самостійно розміщений на Raspberry Pi з локальним ядром Jupyter
Запуск локально з Podman / Docker
Встанови Podman Desktop або Docker Desktop (Mac / Windows / Linux), потім виконай:
# Full stack: site + Jupyter + Qiskit (~3 GB)
podman run -p 8080:80 -p 8888:8888 ghcr.io/janlahmann/doqumentation:jupyter
Відкрий http://localhost:8080 — виконання коду працює локально, без очікування Binder.
Для легкої версії без локального виконання коду (~60 МБ):
# Static site only — code execution still works via Binder
podman run -p 8080:80 ghcr.io/janlahmann/doqumentation:latest
Використовуєш Docker? Просто заміни podman на docker — команди ідентичні. Образи мультиархітектурні (linux/amd64 + linux/arm64), тому Apple Silicon Mac працюють нативно.