uv

macOS / Linux 用の公式ワンライン インストーラー — uv を `~/.local/bin` にインストールし、現在のシェル用に PATH に追加します。

pipx を介して分離された CLI ツールとして uv をインストールします(管理された Python インストールで推奨)。

Windows Package Manager(Windows 10/11)経由で uv をインストールします。

uv を最新リリースに更新します。次のプレリリースを取得するには `--preview` を使用します。

--preview; --stable

Python インタープリターを uv の管理されたキャッシュ(`~/.cache/uv` / `%LOCALAPPDATA%\uv`)にダウンロードします。`3.12`、`3.11.9`、さらにはナイトリー用の `cpython-3.13.0a5` を渡します。

3.12; 3.11.9; [email protected]; --mirror

uv がダウンロードできるすべての Python インタープリター(CPython、PyPy、フリー スレッド ビルド)を一覧表示します。すでに持っているものにフィルタするには `--only-installed` を使用します。

--only-installed; --all-versions; --arch; --os

現在のディレクトリの uv が使用するインタープリターへのパスを表示します。`.python-version`、`pyproject.toml`、アクティブな virtualenv を尊重します。

<version>

現在のプロジェクト用に Python バージョンを固定します — `.python-version` を書き込みます。CI / Docker はこれを読み取ってローカル インタープリターに合わせます。

新しい Python プロジェクトをスキャフォールドします: `pyproject.toml`、hello-world モジュール、`.gitignore`、オプションのテスト / README。

--package 配布可能パッケージとしてビルド; --lib ライブラリとしてビルド; --bare ソース レイアウトなし; --python <ver>; --no-readme; --no-pin-python

ライブラリ プロジェクトを初期化します(src レイアウト、`from <name> import ...` を公開)。

`pyproject.toml` と `uv.lock` で宣言されたすべての依存関係をプロジェクトの virtualenv にインストールします。冪等; `--frozen` はロックファイル更新をスキップし、`--locked` は変更される場合に失敗します。

--frozen; --locked; --no-dev; --extra <name>; --all-extras; --group <name>; --no-install-project

インストールせずに `uv.lock` ファイルを解決して書き込みます。`--check` を使用して `pyproject.toml` と一致することを検証します(CI で便利)。

--check; --upgrade; --upgrade-package <pkg>; --frozen; --dry-run

`pyproject.toml` に依存関係を追加し、`uv.lock` を更新し、venv にインストールします。

--dev; --group <name>; --optional <extra>; --upgrade; --<specifier>; --editable <path>; --raw; --no-sync; --python <ver>

バージョン指定子(PEP 440)で依存関係を追加します。シェルでは引用符を推奨します。

dev のみの依存関係を追加します — `pyproject.toml` の `[dependency-groups].dev` の下に入ります。

名前付き依存関係グループに追加します。複数のグループは `uv sync --group docs --group lint` 経由でインストールできます。

`pyproject.toml`、ロックファイル、venv から依存関係を削除します。

--dev; --group <name>; --optional <extra>

プロジェクトの virtualenv 内でコマンドを実行します。venv がない場合は自動的に再作成されます。

--with <pkg> 一時的な依存関係を追加; --with-requirements <file>; --no-sync; --locked; --frozen; --isolated; --refresh-package <pkg>; --package <name>

プロジェクト venv にインストールされたツールを実行します — 最初に venv をソースする必要はありません。

次回のためにキャッシュされる一回限りの依存関係を持つ一時的なスクリプトを実行します。

PEP 723 インライン メタデータを使用する Python スクリプトを実行します(uv は上部にある `# /// script` ブロックを読み取り、その場で解決します)。

--no-sync

プロジェクト virtualenv を `.venv` に作成します。pip + setuptools をバンドルするには `--seed` を使用します。

<path>; --python <ver>; --seed; --no-seed; --prompt <name>; --system-site-packages; --clear; --relocatable

venv を作成し、pip / setuptools / wheel もインストールします — venv 内の `pip install` ワークフローに必要です。

プロジェクト venv とロックファイルを削除します。新しく始めるには `uv sync` と組み合わせます。

一時的な環境で CLI ツールを実行します(`uv tool run` のエイリアス)。ツールは初回使用後にキャッシュされます。

<tool>@<ver>; --from <pkg>; --with <dep>; --upgrade; --quiet

特定のパッケージによって公開されるツールを実行します(パッケージ名と CLI 名が異なる場合)。

分離された環境にグローバル CLI ツールをインストールします(pipx と同様)。ツールは PATH で利用できるようになります。

--python <ver>; --with <dep>; --reinstall; --quiet; --force

`uv tool install` でインストールされたすべての CLI ツールを一覧表示します。

`uv tool install` を介してインストールされた CLI ツールをアンインストールします。

--quiet

インストールされたすべてのツールを最新バージョンにアップグレードします(`uv tool update-self` とピン ファイルを尊重)。1 つのツールをターゲットにするには名前を渡します。

<tool>; --all; --reinstall; --quiet

uv のモジュール キャッシュ(`~/.cache/uv`)をクリアします。完全な再ダウンロードを強制するには `uv sync --refresh` と組み合わせます。

<package>; --force

ダウンロードされた wheel に uv が使用するキャッシュ ディレクトリを表示します。

pip 互換モードに切り替えます — 既存のプロジェクトを移行中、またはツールがまだ `pip` を呼び出す場合に便利です。

<pkg>; -r <requirements.txt>; -e <path>; --index-url <url>

`requirements.in` を固定された `requirements.txt` に解決します(`pip-tools` と同様)。

プロジェクトのソース ディストリビューションと wheel をビルドします(`pyproject.toml` に応じて hatchling / setuptools / poetry core プラグインを使用)。

-o <dir>; --wheel; --sdist; --no-byte-compile

ビルドされたアーティファクトを PyPI(または `--index` を介してカスタム インデックス)にアップロードします。

--token <pypi-token>; --index <name>; --publish-url <url>; --trusted-publishing <on|off>

uv のバージョンを表示します。

すべての uv サブコマンドを一覧表示します。

1 つのサブコマンドの完全なフラグ リストを出力します。