Qiskit環境構築 [uv版] (2)uvの導入/Python仮想環境の作成 <Windows11, WSL2, openSuSE, uv>

概要

　・Windows11/WSL2でのQiskit環境構築手順は需要があるかもしれないで記載します。
・以前、pyenv,pipx,poetry環境構築手順を記載しましたが、uvの方が構築手順が少なく、圧倒的に速いのでこちらも記載します。

環境

　・手順では< Windows11, WSL2, openSuSE LEAP, uv >を組み合わせた環境を構築します。

本ドキュメントの範囲

　uv版では(2)だけ新規。(3)が数コマンドだけ違う。
　　(1) windows11へのWSL2の導入
　★(2) uvの導入、Python仮想環境の作成
　　(3) vscode導入/Python仮想環境へのアクセス
　　(4) シミュレータでの量子回路実行(qiskit primitives)
　　(5) IBM Quantum量子コンピュータ実機での量子回路実行

python仮想環境の構築

　(2-1) uv導入
　(2-2) Python導入
　(2-3) Python仮想環境作成
　(2-4) Qiskitパッケージ導入

(2-1) uv導入

uv参照

uv導入

# uv が ~/.local 以下に配置される。
curl -LsSf https://astral.sh/uv/install.sh | sh ; echo $?

# uvのアップデート
uv self update ; echo $?

# uvコマンド自動補完設定
echo 'eval "$(uv generate-shell-completion bash)"' >> ~/.bashrc
source ~/.bashrc

# 確認
uv --version

[参考] uv削除

uv cache clean

# ex.　/home/nyanco/.local/share/uv/python
rm -r "$(uv python dir)" ; echo $?  

# ex. /home/nyanco/.local/share/uv/tools
rm -r "$(uv tool dir)"   ; echo $?  

rm -r ~/.local/bin/uv ~/.local/bin/uvx ; echo $? 

# ~/.bashrcの下記のエントリ削除
eval "$(uv generate-shell-completion bash)"

(2-2) Python導入

Python仮想環境で使用したいバージョンのPythonを導入

Python導入

#--- 確認
# 導入可能バージョン一覧
uv python list --all-platforms

# 導入済みバージョン一覧
uv python list --only-installed

# 好きなバージョンのPythonを導入
# Python 3.12.8導入
uv python install 3.12.8 ; echo $?

# 確認
uv python list --only-installed

(2-3) Python仮想環境作成

Python仮想環境作成場所は特に決まりはない。
例では下記のディレクトリに作成
　　~/work/vmPy/vqis
workは作業用。vmPyはPython仮想環境用。vqisはQiskit環境用。

Python仮想環境作成

#--- 作業用ディレクトリ作成
mkdir -p ~/work/vmPy ; echo $?
cd ~/work/vmPy
pwd

#---Python仮想環境作成
uv init uvqis ; echo $?
ls -ld uvqis

#---pythonバージョン指定
# 事前確認
python -V

# カレントディレクトリ以下で使用するPythonのバージョンを固定
uv python pin 3.12.8 ; echo $?

# 確認
ls -a
cat .python-version
python -V

# toml確認
cat ~/work/vmPy/uvqis/pyproject.toml

(2-4) Qiskitパッケージ導入

Qiskitパッケージ導入

# qiskit導入
uv add qiskit qiskit-aer qiskit[visualization] qiskit-ibm-runtime ; echo $?
uv add qiskit-machine-learning qiskit-algorithms ; echo $?

# ipykernel導入 (vscodeからの接続で使用)
uv add ipykernel ; echo $?

# toml確認
cat ~/work/vmPy/uvqis/pyproject.toml

Qiskit環境構築
【uv版】
(1) Linuxの導入/設定
(2) uvの導入/Python仮想環境の作成

【poetry版】
(1) Linuxの導入/設定
(2) Python仮想環境の作成

【uv/poetry共通】
(3) vscodeからのPython仮想環境接続
(4) シミュレータでの量子回路実行
(5) IBMQ実機での量子回路実行
(6) メンテナンス