Skip to main content
IBM Quantum Platform

Qiskit をインストールする

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

Qiskit 0.x から Qiskit 1.0 以降へのアップグレード

(初めてQiskitをインストールする場合は、 インストールとセットアップのセクションに進んでください。 この通知は、以前にQiskitをインストールしたことのあるユーザーにのみ関係します)

バージョン 0.x から 1.0 以降にアップグレードされる方へ: Qiskit v1.0 は新しいパッケージ構造を使用しているため、 pip install -U qiskit を使用して Qiskit 0.x のどのバージョンからも 1.0 にアップグレードすることはできません。

詳細および手順については、 Qiskit 1.0 移行ガイドを参照してください。

Qiskit 1.0 から始まる将来のアップデートでは、インプレースアップグレードが可能になります。

Qiskit SDKと Qiskit Runtime クライアントをインストールする

  1. Python をインストールします。 Qiskit PyPI project pageの "Programming Language "セクションをチェックし、最新リリースでサポートされている Python バージョンを確認してください。 ダウンロード方法については、 Python ビギナーズガイドをご覧ください

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

    Note

    これらの命令は、以下の標準 Python。 pypi.org. しかし、 Anaconda や miniconda などの他の Python ディストリビューションを、 Poetry のような他の依存関係管理ワークフローと一緒に使うこともできる。

    仮想環境が初めての方は、こちらをクリックして詳細をご覧ください。

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

    仮想環境の重要な利点のひとつは、 Python 環境が途中で壊れても、簡単に仮想環境を削除してやり直せることだ！

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

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

    python3 -m venv .venv

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

    source .venv/bin/activate

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

  3. Qiskit SDKをインストールします。 量子ハードウェア上でジョブを実行する予定がある場合は、 Qiskit Runtime もインストールしてください。

    pip install qiskit
    pip install qiskit-ibm-runtime

    視覚化機能またはJupyterノートブックを使用する場合は、Qiskitを追加視覚化サポート('qiskit[visualization]')とともにインストールすることを推奨します。

    pip install qiskit[visualization]

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

    pip install jupyter

    次にノートブックを次のように開く：

    jupyter notebook <path/to/notebook.ipynb>

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

最新バージョンに対応

定期的に Qiskitリリースノートと Qiskit Runtime リリースノートをチェックし、新しいリリースを確認してください。 例えば、 requirements.txt のバージョンを最新バージョンに変更し、 pip install -r requirements.txt または依存関係管理ワークフローの適切なコマンドを実行するなどして、 qiskit と qiskit-ibm-runtime の要件を頻繁に更新することをお勧めします。

Qiskit Code Assistant

Need help? Try asking Qiskit Code Assistant.

# Print the version of Qiskit we're using
# Return True if the version of Qiskit is 1.0 or greater
# Install Qiskit 1.0.2

コードアシスタントは初めてですか？ Qiskit Code Assistant を参照。 これは実験的な機能であり、 IBM Quantum Premium Plan ユーザーだけが利用できることに注意してください。

トラブルシューティング

「モジュール 'qiskit' がありません。 Jupyter Notebook

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

Qiskitがインストールされていない環境でQiskitパッケージをインポートしようとするとエラーが発生します。 Qiskitがインストールされていない環境で から起動した場合 Jupyter Notebook Navigator から起動した場合、 Jupyter Notebook が仮想環境ではなくベース（ルート）環境で実行されている可能性があります。 が実行されている可能性があります。 環境で実行されている可能性があります。 ドロップダウンメニューから Anaconda- Navigator の仮想環境を選択します。 の仮想環境を選択します。 このメニューでは 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 リリースシリーズでは、対応プラットフォームは以下の通りです：

ティア 1

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

ティア1オペレーティングシステム：

  • Linux x86_64 ( manylinux 2014 パッケージング仕様と互換性のあるディストリビューション）。
  • macOS x86_64 ( 10.12 またはそれ以降)
  • macOS ARM64 ( 11.0 またはそれ以降)
  • Windows 64ビット（Windows 10以降に対応）
  • Linux AArch64 ( manylinux2014 パッケージング仕様と互換性のあるディストリビューション)

ティア 2

Qiskit v2.x リリースシリーズにはTier 2オペレーティングシステムはありません。 ティア2のオペレーティングシステムは、開発プロセスの一環としてテストされない。 しかし、コンパイル済みのバイナリは、リリースプロセスの一環としてビルド、テストされ、 PyPI。これらのパッケージは、 Python 環境が機能しているだけでインストールされることが期待できます。

ティア 3

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

ティア3のオペレーティングシステム：

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

Qiskit v2.0.0 からは64ビットプラットフォームのみがサポートされ、32ビットプラットフォームはサポートされません。 32ビットプラットフォーム上ではソース なぜならQiskit Rustコードは内部的に64ビットのポインタ幅を想定しているからです。

Qiskit v1.x

Qiskit v1.x リリースシリーズでは、対応プラットフォームは以下の通りです：

ティア 1

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

ティア1オペレーティングシステム：

  • Linux x86_64 ( manylinux 2014 パッケージング仕様と互換性のあるディストリビューション）。
  • macOS x86_64 ( 10.12 またはそれ以降)
  • macOS ARM64 ( 11.0 またはそれ以降)
  • Windows 64ビット（Windows 10以降に対応）

ティア 2

ティア2のオペレーティングシステムは、開発プロセスの一環としてテストされない。 しかし、コンパイル済みのバイナリはビルドされ、テストされ、リリースプロセスの一環として PyPI に公開されており、これらのパッケージは Python 環境が機能しているだけでインストールされることが期待できる。

ティア2オペレーティングシステム：

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

ティア 3

ティア3のオペレーティングシステムは、開発プロセスの一環としてテストされることはない。 プリコンパイルされたバイナリは、リリースプロセスの一環としてビルドされ、 PyPI に公開されますが、テストは行われません。 これらは、 Python 環境だけではインストー ルできないかもしれないし、インストール・プロセスの一環として、C/C++ コンパイラや、依存関係をソースからビルドするための追加プログラムが必要になるかもしれない。 これらのOSのサポートはベストエフォートのみです。

ティア3のオペレーティングシステム：

  • Linux ppc64le ( manylinux 2014packaging 仕様と互換性のあるディストリビューション)
  • Linux s390x ( manylinux2014 パッケージング仕様と互換性のあるディストリビューション)
  • Linux i686 ( manylinux2014 パッケージング仕様と互換性のあるディストリビューション)
  • Windows 10 32ビット

次のステップ

推奨事項
このページは役に立ちましたか？
GitHub に関するバグ、誤字の報告、またはコンテンツのリクエスト。