メインコンテンツへスキップ
このプロジェクトはベータ版です。バグを見つけましたか？GitHub Issueを開く。質問やアイデアがありますか？Discussionsで質問する — フィードバックをお待ちしています！
このページの翻訳品質はいかがですか？

Qiskitのインストール

ローカル環境で作業する場合でも、クラウド環境で作業する場合でも、すべてのユーザーにとって最初のステップはQiskitのインストールです。

Qiskit SDKのインストール​

  1. Pythonをインストールします。最新リリースでサポートされているPythonバージョンを確認するには、Qiskit PyPIプロジェクトページの「Programming Language」セクションを参照してください。ダウンロード手順については、Python初心者ガイドを参照してください。

    Qiskitを他のアプリケーションから分離するために、Python仮想環境の使用を推奨します。

    備考

    これらの手順は、pypi.orgの標準Python配布版を使用しています。ただし、Anacondaやminicondaなどの他のPython配布版や、Poetryなどの他の依存関係管理ワークフローも使用できます。

    仮想環境が初めての方は、クリックして詳細を表示してください。

    Python仮想環境は、特定の目的のためにPythonで作業するための隔離された空間です。これにより、必要なパッケージをインストールし、ライブラリや依存関係などを設定することができ、マシン上の「ベース」Python環境に影響を与えません。

    仮想環境の重要な利点の1つは、Python環境が途中で破損した場合、仮想環境を簡単に削除して最初からやり直せることです。

    仮想環境に関する情報を保存する好みの場所を選択してください。通常、作業中の各プロジェクトディレクトリ内の.venvという名前のディレクトリに保存されます。

    まず、プロジェクトディレクトリに移動し、Pythonのみがインストールされた最小限の環境を作成します。

    python3 -m venv .venv

    次に、新しい環境をアクティブ化します。

    source .venv/bin/activate

  2. 環境にまだインストールされていない場合は、pipをインストールします。pipはPythonパッケージマネージャーで、Qiskitや他のPythonパッケージのインストールに使用します。pip listを使用して、仮想環境に何が含まれているかを確認できます。ほとんどのPython環境では、pipはすでにインストールされています。

  3. Qiskit SDKをインストールします。

    pip install qiskit
    ビジュアライゼーションサポートの追加

    ビジュアライゼーション機能やJupyterノートブックを使用する予定がある場合は、qiskit.visualizationモジュールもインストールしてください。詳細については、Visualizations APIリファレンスを参照してください。

  1. インストールしたQiskitパッケージでJupyterノートブックを実行したい場合は、環境にJupyterをインストールする必要があります。

    pip install jupyter

    次に、以下のようにノートブックを開きます:

    jupyter notebook <path/to/notebook.ipynb>

ローカルで作業し、Qiskitに組み込まれたシミュレーターを使用する予定の場合、インストールは完了です。IBM® QPUでジョブを実行したい場合は、IBM Cloud® アカウントの設定に進んでください。

最新バージョンを常に使用する

定期的にQiskitリリースノートを確認して、新しいリリースを確認してください。pip install -U qiskitを実行して、qiskitを定期的に最新版へ更新することをお勧めします。

トラブルシューティング​

Jupyter Notebook で No Module 'qiskit' エラーが発生する

pip install qiskit を使用し、Anaconda で仮想環境をセットアップした場合、Jupyter Notebook でチュートリアルを実行すると No Module 'qiskit' エラーが発生することがあります。Qiskit をインストールしていない、または仮想環境をセットアップしていない場合は、インストール の手順に従ってください。

このエラーは、Qiskitパッケージがインストールされていない環境でQiskitパッケージをインポートしようとすると発生します。Anaconda-NavigatorからJupyter Notebookを起動した場合、Jupyter Notebookが仮想環境ではなく、ベース(root)環境で実行されている可能性があります。Anaconda-NavigatorのApplications onドロップダウンメニューから仮想環境を選択してください。このメニューでは、Anaconda内のすべての仮想環境を確認でき、Qiskitがインストールされている環境を選択してJupyter Notebookを起動できます。

インストール中にコンパイル・エラーが発生する

Qiskit は他の多くのオープンソース Python パッケージに依存しており、pip install qiskit を実行すると自動的にインストールされます。システムのプラットフォームや Python のバージョンによっては、特定のパッケージがお使いのシステム向けに事前ビルド済みのバイナリーを提供していない場合があります。Qiskit がサポートするプラットフォームの一覧については オペレーティングシステムのサポート を参照してください。これらの一部には追加のコンパイラーが必要になる場合があります。事前コンパイル済みのバイナリーが利用できない場合、pip はソースからパッケージのコンパイルを試み、それには手動でインストールする必要のある追加の依存関係が必要になることがあります。

pip install qiskitの出力に次のような行が含まれている場合:

Failed building wheel for SOME_PACKAGE
...
build/temp.linux-x86_64-3.5/_openssl.c:498:30: fatal error
compilation terminated.
error: command 'x86_64-linux-gnu-gcc' failed with exit status 1

インストールに失敗したパッケージ(例のコードではSOME_PACKAGE)のドキュメントを確認して、ソースからコンパイルするために必要なライブラリのインストール方法に関する情報を確認してください。

オペレーティングシステムのサポート​

Qiskitはできるだけ多くのオペレーティングシステムをサポートするよう努めていますが、利用可能なテストリソースとオペレーティングシステムの可用性の制限により、すべてのオペレーティングシステムをサポートすることはできません。Qiskitのオペレーティングシステムサポートは、異なるレベルのサポートを持つ3つの階層に分かれています。FreeBSDやWebAssembly(WASI)など、これらの範囲外のプラットフォームでは、Qiskitはインストール可能かもしれませんが、テストされておらず、Qiskit(およびおそらくQiskitの依存関係)をソースからビルドする必要があります。

さらに、QiskitはPython言語のCPython実装のみをサポートしています。PyPyなどの他のPythonインタープリターでの実行はサポートされていません。

Qiskit v2.x​

Qiskit v2.xリリースシリーズでは、サポートされているプラットフォームは以下の通りです:

Tier 1

階層1のオペレーティングシステムは、提案された変更が正しく機能することを保証するために、開発プロセスの一部として完全にテストされています。プリコンパイルされたバイナリは、リリースプロセスの一部としてビルド、テスト、PyPIに公開されます。通常、機能するPython環境がインストールされている限り、追加の依存関係をインストールすることなく、これらのオペレーティングシステムにQiskitをインストールできます。

階層1のオペレーティングシステム:

  • Linux x86_64 (manylinux 2014パッケージ仕様と互換性のあるディストリビューション)

  • macOS ARM64 (11.0以降)

  • Windows 64ビット (Windows 10以降がサポートされています)

  • Linux AArch64 (manylinux 2014パッケージ仕様と互換性のあるディストリビューション)

Tier 2

階層2のオペレーティングシステムは、開発プロセスの一部としてテストされていません。ただし、プリコンパイルされたバイナリは、リリースプロセスの一部としてビルド、テスト、PyPIに公開されており、これらのパッケージは機能するPython環境のみでインストールできると期待されます。 テストの失敗がずっと後まで検出されない可能性があり、公開中の失敗が階層1システムのパッケージの公開をブロックしないため、これらのシステムのパッケージのリリースに遅延が生じる可能性があります。

階層2のオペレーティングシステム:

  • macOS x86_64 (10.12以降)
Tier 3

階層3のオペレーティングシステムは、開発プロセスの一部としてテストされていません。プリコンパイルされたバイナリはリリースプロセスの一部としてビルドされ、PyPIに公開されますが、テストされていません。機能するPython環境のみではインストールできない可能性があり、インストールプロセスの一部としてソースから依存関係をビルドするためにC/C++コンパイラまたは追加のプログラムが必要になる場合があります。これらのオペレーティングシステムのサポートはベストエフォートのみです。

階層3のオペレーティングシステム:

  • Linux ppc64le (manylinux 2014パッケージ仕様と互換性のあるディストリビューション)

  • Linux s390x (manylinux 2014パッケージ仕様と互換性のあるディストリビューション)

Qiskit v2.0.0以降、64ビットプラットフォームのみがサポートされており、32ビットプラットフォームはサポートされていません。Qiskitの内部Rustコードは64ビットポインタ幅を想定しているため、32ビットプラットフォームでソースからビルドすることもできません。

次のステップ​

推奨事項
出典: IBM Quantumドキュメント — 更新日 2026年8月17日
doQumentation の 英語版 — 更新日 2026年8月17日
サイトや翻訳の問題?内容の問題? IBM Quantum docs で編集