メインコンテンツへスキップ

doQumentation

doQumentationは、IBM Quantumの包括的なオープンソースチュートリアル、コース、ドキュメントライブラリに、機能豊富でユーザーフレンドリーなオープンソースフロントエンドを追加します。

IBM Quantumのオープンソースコンテンツ

IBMは、量子コンピューティング学習教材を豊富に提供しています。すべてCC BY-SA 4.0ライセンスのオープンソースです:

  • Learning — 量子基礎から高度なトピックまでの構造化されたコース
  • Tutorials — トランスパイル、エラー緩和などに関する40以上のチュートリアル
  • Documentation — QiskitのガイドとAPIリファレンス
  • Source repo — GitHubのすべてのコンテンツ

彼らのQuantum Platformは常に最新で洗練されたデザインです。読書、学習、リファレンスに最適な場所です。

このプロジェクトが追加するもの

IBMのQiskitドキュメントはオープンソース(CC BY-SA 4.0)ですが、Webアプリケーションはオープンソースではありません。doQumentationは、ライブコード実行、自動認証情報インジェクション、シミュレーターモードを備えたオープンソースフロントエンドを追加します。

どこでもデプロイ可能 — GitHub PagesからDockerRasQberryまで。すべての機能を参照してください。

さらに進む準備ができたら

doQumentationは、何もインストールせずにQiskitの第一歩を踏み出すお手伝いをします — 読み、コードを実行し、探索する。さらに進むときは、IBMの公式プラットフォームへ:

  • 実機で実行 — 無料のIBM CloudアカウントとOpen Planインスタンスを作成し、本物の量子コンピューターで回路を実行しましょう。
  • 最新コンテンツ — IBMのQiskit Learningプラットフォームには、最新のコース、チュートリアル、追加コンテンツがあります(一部はまだdoQumentationに含まれていない場合があります)。
  • ローカル開発 — 本格的な開発作業のために、自分のノートパソコンにQiskitをインストールしましょう。

IBM Quantumのオープンソースドキュメントを基に構築されています。CC BY-SA 4.0ライセンスでこのコンテンツを自由に利用できるようにしてくれたIBM Quantumチームに感謝します。

はじめに

量子コンピューティングは初めてですか? コースから始めましょう。Qiskitに既に精通していますか? チュートリアルまたはガイドに進みましょう。

IBM Quantumアカウントをお持ちでない方へ: 設定でシミュレーターモードを有効にすると、サインアップせずにすべてのコードを実行できます。

コード実行

任意のコードブロックでRunをクリックします。最初のクリックでBinder or IBM Code Engine経由で無料のJupyterカーネルが起動します(1〜2分)。その後、実行は即座に行われます。

  • シミュレーターモード(アカウント不要)シミュレーターモードを有効にすると、AerSimulatorまたはノイズモデルFakeBackendsですべてのノートブックを実行できます。セットアップは一切不要です。

  • IBM Quantumハードウェア — APIトークンとCRNを設定に一度入力すれば、認証情報はすべての実行時に自動注入されます。アカウントをお持ちでない場合は、無料アカウントを作成してください。

利用可能な実行バックエンド

すべてのチュートリアルには実行可能なコードブロックがあります。Runをクリックして、3つのバックエンドのいずれかを使用して実行します:

  1. Binder (GitHub Pagesのデフォルト) — mybinder.org経由の無料リモートJupyterカーネル
  2. ローカルJupyter (Docker / RasQberry) — QiskitがプリインストールされたローカルJupyterサーバーに接続
  3. カスタムサーバー設定で任意のJupyterエンドポイントを指定

IBM Quantum アカウントがない場合は? 設定で シミュレーターモード を有効にすれば、サインアップなしですべてのコードを実行できます。

複数のバックエンドが利用可能な場合、設定 からどれを使うか選択できます。

デプロイオプション

doQumentationは以下として利用可能です:

  • GitHub Pages — リモートコード実行用のBinder or IBM Code Engineを備えた静的サイト
  • Docker — ローカルで完全スタック、オフライン対応
  • RasQberry — ローカルJupyterカーネルを備えたRaspberry Pi上のセルフホスト
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 MB):

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

Dockerを使用する場合は、podmandockerに置き換えるだけです。コマンドは同じです。イメージはマルチアーキテクチャ(linux/amd64 + linux/arm64)なので、Apple Silicon Macでもネイティブに動作します。