uv の使い方

2025年7月5日

はじめに

Python のパッケージ管理ツールである uv の使い方について。

uv のセットアップ

ここ に従う。Linux を想定する。

$ curl -LsSf https://astral.sh/uv/install.sh | sh
downloading uv 0.7.15 x86_64-unknown-linux-gnu
no checksums to verify
installing to /home/penguin/.local/bin
  uv
  uvx
everything's installed!

To add $HOME/.local/bin to your PATH, either restart your shell or run:

    source $HOME/.local/bin/env (sh, bash, zsh)
    source $HOME/.local/bin/env.fish (fish)

以下の行がシェルの設定ファイルに追加される。

. "$HOME/.local/bin/env"

シェルを再起動する。

$ uv --version
uv 0.7.15

uv の使い方

Python のリスト

$ uv python list
  cpython-3.14.0b2-linux-x86_64-gnu                 <download available>
  cpython-3.14.0b2+freethreaded-linux-x86_64-gnu    <download available>
  cpython-3.13.5-linux-x86_64-gnu                   <download available>
  cpython-3.13.5+freethreaded-linux-x86_64-gnu      <download available>
  cpython-3.12.11-linux-x86_64-gnu                  <download available>
  cpython-3.11.13-linux-x86_64-gnu                  <download available>
  cpython-3.10.18-linux-x86_64-gnu                  <download available>
  cpython-3.10.12-linux-x86_64-gnu                  /usr/bin/python3.10
  cpython-3.10.12-linux-x86_64-gnu                  /usr/bin/python3 -> python3.10
  cpython-3.9.23-linux-x86_64-gnu                   <download available>
  cpython-3.8.20-linux-x86_64-gnu                   <download available>

venv

$ uv venv myenv --python 3.11
$ myenv/bin/activate
(myenv) $

pip

(myenv) $ uv pip install open-webui

プロキシ環境での利用

--native-tls が必要な場合がある。

$ uv pip install open-webui --native-tls