Перейти до основного вмісту

doQumentation

doQumentation додає багатофункціональний, зручний, відкритий інтерфейс до повної бібліотеки відкритих навчальних матеріалів, курсів та документації IBM Quantum.

Qiskit Ecosystem — doQumentation є членом екосистеми Qiskit

Відкритий контент IBM Quantum​

IBM надає величезну кількість навчальних матеріалів з квантових обчислень — усе відкрите під ліцензією CC BY-SA 4.0:

Їхня 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 або IBM Code Engine. Після цього виконання миттєве.

  • Режим симулятора (не потрібен обліковий запис) — Увімкни Режим симулятора, щоб виконувати всі ноутбуки з AerSimulator або FakeBackends з моделями шуму. Налаштування не потрібне.

  • Апаратне забезпечення IBM Quantum — Введи свій API-токен та CRN у Налаштуваннях один раз — облікові дані автоматично впроваджуються при кожному запуску. Створи безкоштовний обліковий запис, якщо у тебе його немає.

Доступні бекенди для виконання

Кожен посібник має виконувані блоки коду. Натисни Run, щоб виконати їх, використовуючи один із чотирьох бекендів:

  1. Binder (за замовчуванням на GitHub Pages) — Безкоштовне віддалене ядро Jupyter через mybinder.org

  2. IBM Code Engine — Безсерверний Jupyter на твоєму обліковому записі IBM Cloud. Холодний старт за секунди замість хвилин. Налаштувати

  3. Локальний Jupyter (Docker / RasQberry) — Підключається до локального сервера Jupyter з попередньо встановленим Qiskit

  4. Власний сервер — Вкажи будь-яку кінцеву точку 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.

Для легкої версії без локального виконання коду (~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 працюють нативно.