doQumentation
Вивчай квантові обчислення за допомогою навчальних посібників і курсів Qiskit від IBM та запускай код прямо тут, у браузері. Без встановлення й без облікового запису, щоб почати.
Початок роботи
Новачок у квантових обчисленнях? Почни з курсу. Вже знайомий з Qiskit? Переходь до посібника або довідника.
Обліковий запис IBM Quantum не потрібен. За замовчуванням код виконується на вбудованому симуляторі. Додай свій ключ API в Налаштуваннях лише якщо хочеш використовувати справжнє квантове обладнання.
Виконання коду
Натисни Run на будь-якому блоці коду. Перше натискання запускає ядро Jupyter через Binder або IBM Code Engine. Після цього виконання миттєве.
-
Режим симулятора (обліковий запис не потрібен) — Увімкнено за замовчуванням: код виконується на AerSimulator або на FakeBackends із моделлю шуму, які можна вибрати в Налаштуваннях. Сторінки, що потребують обладнання IBM Quantum або хмарних сервісів IBM, повідомляють про це під час запуску.
-
Апаратне забезпечення 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 або 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.
Використовуєш Docker? Просто заміни podman на docker — команди ідентичні. Образи мультиархітектурні (linux/amd64 + linux/arm64), тому Apple Silicon Mac працюють нативно.
Про проєкт і подяки
Відкритий контент 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.