CLI ReferenceCLI リファレンス

uv

An extremely fast Python package manager.非常に高速なPythonパッケージマネージャー。

Usage使用法

uv [OPTIONS] <COMMAND>

Commandsコマンド

uv authuv auth: Manage authentication認証を管理する
uv runuv run: Run a command or scriptコマンドまたはスクリプトを実行する
uv inituv init: Create a new project新しいプロジェクトを作成する
uv adduv add: Add dependencies to the projectプロジェクトに依存関係を追加する
uv removeuv remove: Remove dependencies from the projectプロジェクトから依存関係を削除する
uv versionuv version: Read or update the project's versionプロジェクトのバージョンを読み取るか更新する
uv syncuv sync: Update the project's environmentプロジェクトの環境を更新する
uv lockuv lock: Update the project's lockfileプロジェクトのロックファイルを更新する
uv exportuv export: Export the project's lockfile to an alternate formatプロジェクトのロックファイルを別の形式にエクスポートする
uv treeuv tree: Display the project's dependency treeプロジェクトの依存関係ツリーを表示する
uv formatuv format: Format Python code in the projectプロジェクト内のPythonコードをフォーマットする
uv tooluv tool: Run and install commands provided by Python packagesPythonパッケージが提供するコマンドを実行およびインストールする
uv pythonuv python: Manage Python versions and installationsPythonのバージョンとインストールを管理する
uv pipuv pip: Manage Python packages with a pip-compatible interfacepip互換インターフェースでPythonパッケージを管理する
uv venvuv venv: Create a virtual environment仮想環境を作成する
uv builduv build: Build Python packages into source distributions and wheelsPythonパッケージをソース配布物とホイールにビルドする
uv publishuv publish: Upload distributions to an index配布物をインデックスにアップロードする
uv cacheuv cache: Manage uv's cacheuvのキャッシュを管理する
uv selfuv self: Manage the uv executableuv実行可能ファイルを管理する
uv helpuv help: Display documentation for a commandコマンドのドキュメントを表示する

uv authuv auth

Manage authentication認証を管理する

Usage使用法

uv auth [OPTIONS] <COMMAND>

Commandsコマンド

uv auth loginuv auth login: Login to a serviceサービスにログインする
uv auth logoutuv auth logout: Logout of a serviceサービスからログアウト
uv auth tokenuv auth token: Show the authentication token for a serviceサービスの認証トークンを表示
uv auth diruv auth dir: Show the path to the uv credentials directoryuv 認証情報ディレクトリへのパスを表示

Login to a serviceサービスにログイン

Usage使用法

uv auth login [OPTIONS] <SERVICE>

Arguments引数

SERVICESERVICE: The domain or URL of the service to log intoログインするサービスのドメインまたはURL

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートのペア（例：localhost:8080）、またはURL（例：https://localhost）を受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、検証済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.デフォルトでは $XDG_CACHE_HOME/uv または $HOME/.cache/uv（macOSおよびLinuxの場合）、および %LOCALAPPDATA%\uv\cache（Windowsの場合）に設定されます。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR 環境変数を使用して設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末への書き込み時に自動的に色のサポートを検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力が色のサポートを持つ端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.uv.toml ファイルのパスを設定に使用します。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定は pyproject.toml ファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE 環境変数でも設定できます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--project を参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY 環境変数でも設定できます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します

--keyring-provider keyring-provider--keyring-provider keyring-provider

The keyring provider to use for storage of credentials.資格情報の保存に使用するキーレリングプロバイダー。

Only --keyring-provider native is supported for login, which uses the system keyring via an integration built into uv.loginには、システムキーレングを使用するためにuvに組み込まれた統合を介して、--keyring-provider nativeのみがサポートされています。

May also be set with the UV_KEYRING_PROVIDER environment variable.UV_KEYRING_PROVIDER環境変数を使用して設定することもできます。

Possible values:可能な値：

disabled: Do not use keyring for credential lookupdisabled: 資格情報の検索にキーレリングを使用しない
subprocess: Use the keyring command for credential lookupsubprocess: 資格情報の検索にkeyringコマンドを使用する

--managed-python--managed-python

Require use of uv-managed Python versions.uv管理のPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理しているPythonバージョンを使用することを好みます。ただし、uvが管理するPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数で設定することもできます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、特にシステムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したいことがあります。

May also be set with the UV_NATIVE_TLS environment variable.UV_NATIVE_TLS環境変数で設定することもできます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の期間中は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.UV_NO_CACHE環境変数で設定することもできます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml、uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.UV_NO_CONFIG 環境変数で設定することもできます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON 環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバー。

May also be set with the UV_NO_PROGRESS environment variable.また、UV_NO_PROGRESS 環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.また、UV_OFFLINE 環境変数で設定することもできます。

--password password--password password

The password to use for the service.サービスに使用するパスワード。

Use - to read the password from stdin.標準入力からパスワードを読み取るには - を使用します。

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.作業ディレクトリを完全に変更するには --directory を参照してください。

This setting has no effect when used in the uv pip interface.この設定は uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数を使用して設定することもできます。

--quiet, -q--quiet、-q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uvは標準出力に何も出力しないサイレントモードを有効にします。

--token, -t token--token, -t token

The token to use for the service.サービスに使用するトークン。

The username will be set to __token__.ユーザー名は __token__ に設定されます。

Use - to read the token from stdin.- を使用して標準入力からトークンを読み取ります。

--username, -u username--username, -u username

The username to use for the serviceサービスに使用するユーザー名。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)細かいログ設定は RUST_LOG 環境変数を使用して構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv auth logoutuv auth logout

Logout of a serviceサービスからログアウトします

Usage使用法

uv auth logout [OPTIONS] <SERVICE>

Arguments引数

SERVICESERVICE: The domain or URL of the service to logout fromログアウトするサービスのドメインまたはURL

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正な接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホストポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、検証されたソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数で設定することもできます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvに、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されています。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数で設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末への出力時に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力がサポートされている端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用するuv.tomlファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数を使用して設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数でも設定できます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--keyring-provider keyring-provider--keyring-provider keyring-provider

The keyring provider to use for storage of credentials.資格情報の保存に使用するキーレングプロバイダー。

Only --keyring-provider native is supported for logout, which uses the system keyring via an integration built into uv.logoutには、システムキーレングを使用するためにuvに組み込まれた統合を介して、--keyring-provider nativeのみがサポートされています。

May also be set with the UV_KEYRING_PROVIDER environment variable.UV_KEYRING_PROVIDER環境変数でも設定できます。

Possible values:可能な値：

disabled: Do not use keyring for credential lookupdisabled: キーリングを使用して資格情報を検索しない
subprocess: Use the keyring command for credential lookupsubprocess: 資格情報の検索にkeyringコマンドを使用する

--managed-python--managed-python

Require use of uv-managed Python versions.uv管理のPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンの使用を優先します。ただし、uv管理のPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、いくつかのケースでは、プラットフォームのネイティブ証明書ストアを使用したい場合があります。特に、システムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合です。

May also be set with the UV_NATIVE_TLS environment variable.また、UV_NATIVE_TLS 環境変数で設定することもできます。

--no-cache, --no-cache-dir, -n--no-cache、--no-cache-dir、-n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.また、UV_NO_CACHE 環境変数で設定することもできます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml、uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.また、UV_NO_CONFIG 環境変数で設定することもできます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数で設定することもできます。

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に歩いていくことで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用される場合、効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数で設定することもできます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uvがstdoutに出力を行わないサイレントモードが有効になります。

--username, -u username--username, -u username

The username to logoutログアウトするためのユーザー名

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)RUST_LOG 環境変数を使用して、細かいログ設定を行うことができます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv auth tokenuv auth token

Show the authentication token for a serviceサービスの認証トークンを表示します

Usage使用法

uv auth token [OPTIONS] <SERVICE>

Arguments引数

SERVICESERVICE: The domain or URL of the service to lookup検索するサービスのドメインまたはURL

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回提供することができます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホストポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告: このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.また、UV_INSECURE_HOST 環境変数で設定することもできます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.デフォルトでは、macOSおよびLinuxでは $XDG_CACHE_HOME/uv または $HOME/.cache/uv、Windowsでは %LOCALAPPDATA%\uv\cache になります。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dir を実行します。

May also be set with the UV_CACHE_DIR environment variable.また、UV_CACHE_DIR 環境変数で設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvはターミナルへの書き込み時に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力が端末またはサポートされているTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.uv.tomlファイルのパスを設定に使用します。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数を使用して設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数でも設定できます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--keyring-provider keyring-provider--keyring-provider keyring-provider

The keyring provider to use for reading credentials資格情報を読み取るために使用するキーレリングプロバイダー

May also be set with the UV_KEYRING_PROVIDER environment variable.UV_KEYRING_PROVIDER環境変数でも設定できます。

Possible values:可能な値：

disabled: Do not use keyring for credential lookupdisabled: 資格情報の検索にキーレリングを使用しない
subprocess: Use the keyring command for credential lookupsubprocess: 資格情報の検索にkeyringコマンドを使用する

--managed-python--managed-python

Require use of uv-managed Python versions.uvが管理するPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンを使用することを好みます。ただし、uvが管理するPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、特にシステムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したい場合があります。

May also be set with the UV_NATIVE_TLS environment variable.UV_NATIVE_TLS環境変数でも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用してください。

May also be set with the UV_NO_CACHE environment variable.これは、UV_NO_CACHE 環境変数でも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml, uv.toml）の発見を避けてください。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.これは、UV_NO_CONFIG 環境変数でも設定できます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.その代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.これは、UV_NO_MANAGED_PYTHON 環境変数でも設定できます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS 環境変数を使用して設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数を使用して設定することもできます。

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数を使用して設定することもできます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uv が stdout に出力しないサイレントモードを有効にします。

--username, -u username--username, -u ユーザー名

The username to lookup検索するユーザー名

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)細かいログ記録は、RUST_LOG 環境変数を使用して構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv auth diruv 認証ディレクトリ

Show the path to the uv credentials directory.uv 認証ディレクトリへのパスを表示します。

By default, credentials are stored in the uv data directory at $XDG_DATA_HOME/uv/credentials or $HOME/.local/share/uv/credentials on Unix and %APPDATA%\uv\data\credentials on Windows.デフォルトでは、認証情報は Unix の $XDG_DATA_HOME/uv/credentials または $HOME/.local/share/uv/credentials、Windows の %APPDATA%\uv\data\credentials にある uv データディレクトリに保存されます。

The credentials directory may be overridden with $UV_CREDENTIALS_DIR.認証情報ディレクトリは $UV_CREDENTIALS_DIR で上書きできます。

Credentials are only stored in this directory when the plaintext backend is used, as opposed to the native backend, which uses the system keyring.認証情報は、システムキーチェーンを使用するネイティブバックエンドとは異なり、プレーンテキストバックエンドが使用されている場合にのみこのディレクトリに保存されます。

Usage使用法

uv auth dir [OPTIONS] [SERVICE]

Arguments引数

SERVICESERVICE: The domain or URL of the service to lookup検索するサービスのドメインまたはURL

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回提供できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホストポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.また、UV_INSECURE_HOST 環境変数で設定することもできます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.デフォルトでは、macOSおよびLinuxでは $XDG_CACHE_HOME/uv または $HOME/.cache/uv、Windowsでは %LOCALAPPDATA%\uv\cache になります。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dir を実行します。

May also be set with the UV_CACHE_DIR environment variable.また、UV_CACHE_DIR 環境変数で設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末に書き込む際に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力が端末またはサポートされているTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.uv.tomlファイルのパスを設定に使用します。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数を使用して設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数でも設定できます。

--help, -h--help、-h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--managed-python--managed-python

Require use of uv-managed Python versions.uv-managed Pythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンの使用を優先します。ただし、uv-managed Pythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、プラットフォームのネイティブ証明書ストアを使用したいことがあります。特に、システムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合です。

May also be set with the UV_NATIVE_TLS environment variable.また、UV_NATIVE_TLS環境変数で設定することもできます。

--no-cache, --no-cache-dir, -n--no-cache、--no-cache-dir、-n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の期間中は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.また、UV_NO_CACHE環境変数で設定することもできます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml、uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.また、UV_NO_CONFIG環境変数で設定することもできます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv-managed Python バージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uv はシステム上の適切な Python バージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON 環境変数でも設定できます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS 環境変数でも設定できます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Python の自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数を使用して設定することもできます。

--project project--project project

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に歩いていくことで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用されると効果がありません。

May also be set with the UV_PROJECT environment variable.また、UV_PROJECT環境変数で設定することもできます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば-qq、uvはstdoutに出力を行わないサイレントモードを有効にします。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)RUST_LOG環境変数を使用して、細かいログ設定を行うことができます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv runuv run

Run a command or script.コマンドまたはスクリプトを実行します。

Ensures that the command runs in a Python environment.コマンドがPython環境で実行されることを保証します。

When used with a file ending in .py or an HTTP(S) URL, the file will be treated as a script and run with a Python interpreter, i.e., uv run file.py is equivalent to uv run python file.py. For URLs, the script is temporarily downloaded before execution. If the script contains inline dependency metadata, it will be installed into an isolated, ephemeral environment. When used with -, the input will be read from stdin, and treated as a Python script.ファイルが .py で終わるか、HTTP(S) URL の場合、そのファイルはスクリプトとして扱われ、Python インタプリタで実行されます。つまり、uv run file.py は uv run python file.py と同等です。URLの場合、スクリプトは実行前に一時的にダウンロードされます。スクリプトにインライン依存関係メタデータが含まれている場合、それは孤立した一時的な環境にインストールされます。- を使用すると、入力は stdin から読み取られ、Python スクリプトとして扱われます。

When used in a project, the project environment will be created and updated before invoking the command.プロジェクト内で使用される場合、コマンドを呼び出す前にプロジェクト環境が作成され、更新されます。

When used outside a project, if a virtual environment can be found in the current directory or a parent directory, the command will be run in that environment. Otherwise, the command will be run in the environment of the discovered interpreter.プロジェクト外で使用される場合、現在のディレクトリまたは親ディレクトリに仮想環境が見つかれば、その環境でコマンドが実行されます。そうでない場合、発見されたインタプリタの環境でコマンドが実行されます。

Arguments following the command (or script) are not interpreted as arguments to uv. All options to uv must be provided before the command, e.g., uv run --verbose foo. A -- can be used to separate the command from uv options for clarity, e.g., uv run --python 3.12 -- python.コマンド（またはスクリプト）の後に続く引数は、uv の引数として解釈されません。uv へのすべてのオプションはコマンドの前に提供する必要があります。例えば、uv run --verbose foo のようにです。-- を使用して、コマンドと uv オプションを明確に分けることができます。例えば、uv run --python 3.12 -- python のようにです。

Usage使用法

uv run [OPTIONS] [COMMAND]

Optionsオプション

--active--active

Prefer the active virtual environment over the project's virtual environment.プロジェクトの仮想環境よりもアクティブな仮想環境を優先します。

If the project virtual environment is active or no virtual environment is active, this has no effect.プロジェクトの仮想環境がアクティブであるか、アクティブな仮想環境がない場合、これは影響を与えません。

--all-extras--all-extras

Include all optional dependencies.すべてのオプション依存関係を含めます。

Optional dependencies are defined via project.optional-dependencies in a pyproject.toml.オプション依存関係は、project.optional-dependenciesをpyproject.tomlで定義します。

This option is only available when running in a project.このオプションは、プロジェクト内で実行しているときのみ利用可能です。

--all-groups--all-groups

Include dependencies from all dependency groups.すべての依存関係グループから依存関係を含めます。

--no-group can be used to exclude specific groups.--no-groupを使用して特定のグループを除外できます。

--all-packages--all-packages

Run the command with all workspace members installed.すべてのワークスペースメンバーがインストールされた状態でコマンドを実行します。

The workspace's environment (.venv) is updated to include all workspace members.ワークスペースの環境（.venv）は、すべてのワークスペースメンバーを含むように更新されます。

Any extras or groups specified via --extra, --group, or related options will be applied to all workspace members.--extra、--group、または関連オプションを介して指定された追加やグループは、すべてのワークスペースメンバーに適用されます。

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）を受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvに、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されています。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行してください。

May also be set with the UV_CACHE_DIR environment variable.環境変数 UV_CACHE_DIR でも設定できます。

--color color-choice--color color-choice

Control the use of color in output.出力の色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvはターミナルへの書き込み時に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: ターミナルまたはサポートのあるTTYに出力される場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--compile-bytecode, --compile--compile-bytecode, --compile

Compile Python files to bytecode after installation.インストール後にPythonファイルをバイトコードにコンパイルします。

By default, uv does not compile Python (.py) files to bytecode (__pycache__/*.pyc); instead, compilation is performed lazily the first time a module is imported. For use-cases in which start time is critical, such as CLI applications and Docker containers, this option can be enabled to trade longer installation times for faster start times.デフォルトでは、uvはPython（.py）ファイルをバイトコード（__pycache__/*.pyc）にコンパイルしません。代わりに、モジュールが初めてインポートされるときに遅延的にコンパイルが行われます。CLIアプリケーションやDockerコンテナなど、起動時間が重要なユースケースでは、このオプションを有効にすることで、長いインストール時間と引き換えに迅速な起動時間を得ることができます。

When enabled, uv will process the entire site-packages directory (including packages that are not being modified by the current operation) for consistency. Like pip, it will also ignore errors.有効にすると、uvは一貫性のためにサイトパッケージディレクトリ全体（現在の操作によって変更されていないパッケージを含む）を処理します。pipと同様に、エラーも無視します。

May also be set with the UV_COMPILE_BYTECODE environment variable.UV_COMPILE_BYTECODE環境変数で設定することもできます。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用するuv.tomlファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数で設定することもできます。

--config-setting, --config-settings, -C config-setting--config-setting, --config-settings, -C config-setting

Settings to pass to the PEP 517 build backend, specified as KEY=VALUE pairsPEP 517ビルドバックエンドに渡す設定で、KEY=VALUEペアとして指定します。

--config-settings-package, --config-settings-package config-settings-package--config-settings-package, --config-settings-package config-settings-package

Settings to pass to the PEP 517 build backend for a specific package, specified as PACKAGE:KEY=VALUE pairs特定のパッケージのためにPEP 517ビルドバックエンドに渡す設定で、PACKAGE:KEY=VALUEペアとして指定されます。

--default-index default-index--default-index default-index

The URL of the default package index (by default: https://pypi.org/simple).デフォルトのパッケージインデックスのURL（デフォルトでは: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリのいずれかを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --index flag.このフラグで指定されたインデックスは、--indexフラグを介して指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_DEFAULT_INDEX environment variable.UV_DEFAULT_INDEX環境変数を使用して設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準として解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.また、UV_WORKING_DIRECTORY 環境変数で設定することもできます。

--env-file env-file--env-file env-file

Load environment variables from a .env file..env ファイルから環境変数を読み込みます。

Can be provided multiple times, with subsequent files overriding values defined in previous files.複数回提供することができ、後のファイルが前のファイルで定義された値を上書きします。

May also be set with the UV_ENV_FILE environment variable.また、UV_ENV_FILE 環境変数で設定することもできます。

--exact--exact

Perform an exact sync, removing extraneous packages.正確な同期を行い、余分なパッケージを削除します。

When enabled, uv will remove any extraneous packages from the environment. By default, uv run will make the minimum necessary changes to satisfy the requirements.有効にすると、uvは環境から余分なパッケージを削除します。デフォルトでは、uv run は要件を満たすために最小限の変更を行います。

--exclude-newer exclude-newer--exclude-newer exclude-newer

Limit candidate packages to those that were uploaded prior to the given date.候補パッケージを指定された日付以前にアップロードされたものに制限します。

Accepts both RFC 3339 timestamps (e.g., 2006-12-02T02:07:43Z) and local dates in the same format (e.g., 2006-12-02) in your system's configured time zone.RFC 3339 タイムスタンプ（例：2006-12-02T02:07:43Z）と、システムの設定されたタイムゾーンでの同じ形式のローカル日付（例：2006-12-02）の両方を受け入れます。

May also be set with the UV_EXCLUDE_NEWER environment variable.UV_EXCLUDE_NEWER 環境変数で設定することもできます。

--exclude-newer-package exclude-newer-package--exclude-newer-package exclude-newer-package

Limit candidate packages for specific packages to those that were uploaded prior to the given date.特定のパッケージの候補パッケージを、指定された日付以前にアップロードされたものに制限します。

Accepts package-date pairs in the format PACKAGE=DATE, where DATE is an RFC 3339 timestamp (e.g., 2006-12-02T02:07:43Z) or local date (e.g., 2006-12-02) in your system's configured time zone.PACKAGE=DATE 形式のパッケージ日付ペアを受け入れます。ここで、DATE は RFC 3339 タイムスタンプ（例：2006-12-02T02:07:43Z）またはローカル日付（例：2006-12-02）で、システムの設定されたタイムゾーンでのものです。

Can be provided multiple times for different packages.異なるパッケージに対して複数回提供できます。

--extra extra--extra extra

Include optional dependencies from the specified extra name.指定されたエクストラ名からのオプション依存関係を含めます。

May be provided more than once.複数回提供することができます。

Optional dependencies are defined via project.optional-dependencies in a pyproject.toml.オプション依存関係は、pyproject.toml の project.optional-dependencies を介して定義されます。

This option is only available when running in a project.このオプションはプロジェクト内で実行している場合にのみ利用可能です。

--extra-index-url extra-index-url--extra-index-url extra-index-url

(Deprecated: use --index instead) Extra URLs of package indexes to use, in addition to --index-url.(非推奨: 代わりに --index を使用してください) --index-url に加えて使用するパッケージインデックスの追加URL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --index-url (which defaults to PyPI). When multiple --extra-index-url flags are provided, earlier values take priority.このフラグを介して提供されたすべてのインデックスは、--index-url（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の --extra-index-url フラグが提供される場合、先に指定された値が優先されます。

May also be set with the UV_EXTRA_INDEX_URL environment variable.UV_EXTRA_INDEX_URL 環境変数を使用して設定することもできます。

--find-links, -f find-links--find-links, -f find-links

Locations to search for candidate distributions, in addition to those found in the registry indexes.レジストリインデックスで見つかったものに加えて、候補の配布物を検索する場所。

If a path, the target must be a directory that contains packages as wheel files (.whl) or source distributions (e.g., .tar.gz or .zip) at the top level.パスの場合、ターゲットはトップレベルにホイールファイル（.whl）またはソース配布（例: .tar.gz または .zip）を含むディレクトリでなければなりません。

If a URL, the page must contain a flat list of links to package files adhering to the formats described above.URLの場合、ページは上記の形式に従ったパッケージファイルへのリンクのフラットリストを含む必要があります。

May also be set with the UV_FIND_LINKS environment variable.また、UV_FIND_LINKS 環境変数で設定することもできます。

--fork-strategy fork-strategy--fork-strategy fork-strategy

The strategy to use when selecting multiple versions of a given package across Python versions and platforms.特定のパッケージの複数のバージョンをPythonのバージョンやプラットフォームにわたって選択する際に使用する戦略。

By default, uv will optimize for selecting the latest version of each package for each supported Python version (requires-python), while minimizing the number of selected versions across platforms.デフォルトでは、uvは各サポートされているPythonバージョン（requires-python）に対して各パッケージの最新バージョンを選択するよう最適化し、プラットフォーム間で選択されたバージョンの数を最小限に抑えます。

Under fewest, uv will minimize the number of selected versions for each package, preferring older versions that are compatible with a wider range of supported Python versions or platforms.fewest の下では、uvは各パッケージの選択されたバージョンの数を最小限に抑え、より広範囲のサポートされているPythonバージョンやプラットフォームと互換性のある古いバージョンを優先します。

May also be set with the UV_FORK_STRATEGY environment variable.また、UV_FORK_STRATEGY 環境変数で設定することもできます。

Possible values:可能な値：

fewest: Optimize for selecting the fewest number of versions for each package. Older versions may be preferred if they are compatible with a wider range of supported Python versions or platformsfewest: 各パッケージのバージョン数を最小限に抑えるよう最適化します。より広範囲のサポートされているPythonバージョンやプラットフォームと互換性がある場合、古いバージョンが優先されることがあります。
requires-python: Optimize for selecting latest supported version of each package, for each supported Python versionrequires-python: 各サポートされているPythonバージョンに対して、各パッケージの最新のサポートされているバージョンを選択するよう最適化します。

--frozen--frozen

Run without updating the uv.lock file.uv.lock ファイルを更新せずに実行します。

Instead of checking if the lockfile is up-to-date, uses the versions in the lockfile as the source of truth. If the lockfile is missing, uv will exit with an error. If the pyproject.toml includes changes to dependencies that have not been included in the lockfile yet, they will not be present in the environment.ロックファイルが最新かどうかを確認する代わりに、ロックファイル内のバージョンを真実のソースとして使用します。ロックファイルが欠落している場合、uvはエラーで終了します。pyproject.toml にロックファイルにまだ含まれていない依存関係の変更が含まれている場合、それらは環境に存在しません。

May also be set with the UV_FROZEN environment variable.UV_FROZEN 環境変数で設定することもできます。

--group group--group group

Include dependencies from the specified dependency group.指定された依存関係グループから依存関係を含めます。

May be provided multiple times.複数回提供することができます。

--gui-script--gui-script

Run the given path as a Python GUI script.指定されたパスをPython GUIスクリプトとして実行します。

Using --gui-script will attempt to parse the path as a PEP 723 script and run it with pythonw.exe, irrespective of its extension. Only available on Windows.--gui-script を使用すると、パスをPEP 723スクリプトとして解析し、拡張子に関係なくpythonw.exeで実行しようとします。Windowsのみで利用可能です。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します

--index index--index index

The URLs to use when resolving dependencies, in addition to the default index.デフォルトのインデックスに加えて、依存関係を解決する際に使用するURL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式で配置されたローカルディレクトリのいずれかを受け入れます。

All indexes provided via this flag take priority over the index specified by --default-index (which defaults to PyPI). When multiple --index flags are provided, earlier values take priority.このフラグを介して提供されたすべてのインデックスは、--default-index（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の--indexフラグが提供される場合、早い値が優先されます。

Index names are not supported as values. Relative paths must be disambiguated from index names with ./ or ../ on Unix or .\\, ..\\, ./ or ../ on Windows.インデックス名は値としてサポートされていません。相対パスは、Unixでは./または../、Windowsでは.\\、..\\、./または../でインデックス名と区別する必要があります。

May also be set with the UV_INDEX environment variable.UV_INDEX環境変数を使用して設定することもできます。

--index-strategy index-strategy--index-strategy index-strategy

The strategy to use when resolving against multiple index URLs.複数のインデックスURLに対して解決する際に使用する戦略。

By default, uv will stop at the first index on which a given package is available, and limit resolutions to those present on that first index (first-index). This prevents "dependency confusion" attacks, whereby an attacker can upload a malicious package under the same name to an alternate index.デフォルトでは、uvは指定されたパッケージが利用可能な最初のインデックスで停止し、その最初のインデックスに存在するものに解決を制限します（first-index）。これにより、攻撃者が同じ名前の悪意のあるパッケージを別のインデックスにアップロードすることによる「依存関係の混乱」攻撃を防ぎます。

May also be set with the UV_INDEX_STRATEGY environment variable.また、UV_INDEX_STRATEGY 環境変数で設定することもできます。

Possible values:可能な値：

first-index: Only use results from the first index that returns a match for a given package namefirst-index: 指定されたパッケージ名に対して一致する最初のインデックスからの結果のみを使用します。
unsafe-first-match: Search for every package name across all indexes, exhausting the versions from the first index before moving on to the nextunsafe-first-match: すべてのインデックスで各パッケージ名を検索し、次のインデックスに移る前に最初のインデックスからのバージョンを使い切ります。
unsafe-best-match: Search for every package name across all indexes, preferring the "best" version found. If a package version is in multiple indexes, only look at the entry for the first indexunsafe-best-match: すべてのインデックスで各パッケージ名を検索し、見つかった「最良」のバージョンを優先します。パッケージバージョンが複数のインデックスに存在する場合、最初のインデックスのエントリのみを確認します。

--index-url, -i index-url--index-url, -i index-url

(Deprecated: use --default-index instead) The URL of the Python package index (by default: https://pypi.org/simple).(非推奨: 代わりに --default-index を使用してください) Python パッケージインデックスの URL (デフォルト: https://pypi.org/simple)。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503 (シンプルリポジトリ API) に準拠したリポジトリまたは同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --extra-index-url flag.このフラグで指定されたインデックスは、--extra-index-url フラグを介して指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_INDEX_URL environment variable.また、UV_INDEX_URL 環境変数で設定することもできます。

--isolated--isolated

Run the command in an isolated virtual environment.コマンドを孤立した仮想環境で実行します。

Usually, the project environment is reused for performance. This option forces a fresh environment to be used for the project, enforcing strict isolation between dependencies and declaration of requirements.通常、プロジェクト環境はパフォーマンスのために再利用されます。このオプションは、プロジェクトに新しい環境を強制的に使用させ、依存関係と要件の宣言の間に厳密な隔離を強制します。

An editable installation is still used for the project.プロジェクトには依然として編集可能なインストールが使用されます。

When used with --with or --with-requirements, the additional dependencies will still be layered in a second environment.--with または --with-requirements と一緒に使用されると、追加の依存関係はまだ2番目の環境にレイヤーされます。

May also be set with the UV_ISOLATED environment variable.UV_ISOLATED 環境変数で設定することもできます。

--keyring-provider keyring-provider--keyring-provider keyring-provider

Attempt to use keyring for authentication for index URLs.keyring を使用してインデックスURLの認証を試みます。

At present, only --keyring-provider subprocess is supported, which configures uv to use the keyring CLI to handle authentication.現在、--keyring-provider subprocess のみがサポートされており、uvが認証を処理するために keyring CLI を使用するように構成します。

Defaults to disabled.デフォルトは disabled です。

May also be set with the UV_KEYRING_PROVIDER environment variable.環境変数 UV_KEYRING_PROVIDER で設定することもできます。

Possible values:可能な値：

disabled: Do not use keyring for credential lookupdisabled: 認証情報の検索にキーレングを使用しない
subprocess: Use the keyring command for credential lookupsubprocess: 認証情報の検索に keyring コマンドを使用する

--link-mode link-mode--link-mode link-mode

The method to use when installing packages from the global cache.グローバルキャッシュからパッケージをインストールする際に使用する方法。

Defaults to clone (also known as Copy-on-Write) on macOS, and hardlink on Linux and Windows.macOSでは clone（コピーオンライトとも呼ばれる）にデフォルト設定され、LinuxおよびWindowsでは hardlink にデフォルト設定されています。

WARNING: The use of symlink link mode is discouraged, as they create tight coupling between the cache and the target environment. For example, clearing the cache (uv cache clean) will break all installed packages by way of removing the underlying source files. Use symlinks with caution.警告: シンボリックリンクモードの使用は推奨されません。キャッシュとターゲット環境の間に強い結合を作成するためです。たとえば、キャッシュをクリアする (uv cache clean) と、基盤となるソースファイルが削除されるため、すべてのインストールされたパッケージが壊れます。シンボリックリンクは注意して使用してください。

May also be set with the UV_LINK_MODE environment variable.環境変数 UV_LINK_MODE で設定することもできます。

Possible values:可能な値：

clone: Clone (i.e., copy-on-write) packages from the wheel into the site-packages directoryclone: ホイールからsite-packagesディレクトリにパッケージをクローン（すなわち、コピーオンライト）します。
copy: Copy packages from the wheel into the site-packages directorycopy: ホイールからsite-packagesディレクトリにパッケージをコピーします。
hardlink: Hard link packages from the wheel into the site-packages directoryhardlink: ホイールからsite-packagesディレクトリにパッケージをハードリンクします。
symlink: Symbolically link packages from the wheel into the site-packages directorysymlink: ホイールからsite-packagesディレクトリにパッケージをシンボリックリンクします。

--locked--locked

Assert that the uv.lock will remain unchanged.uv.lockが変更されないことを保証します。

Requires that the lockfile is up-to-date. If the lockfile is missing or needs to be updated, uv will exit with an error.ロックファイルが最新である必要があります。ロックファイルが欠落しているか、更新が必要な場合、uvはエラーで終了します。

May also be set with the UV_LOCKED environment variable.UV_LOCKED環境変数でも設定できます。

--managed-python--managed-python

Require use of uv-managed Python versions.uv管理のPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理しているPythonバージョンを使用することを好みます。ただし、uvが管理しているPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON 環境変数で設定することもできます。

--module, -m--module, -m

Run a Python module.Pythonモジュールを実行します。

Equivalent to python -m <module>.python -m <module> と同等です。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、特にシステムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したいことがあります。

May also be set with the UV_NATIVE_TLS environment variable.UV_NATIVE_TLS 環境変数で設定することもできます。

--no-binary--no-binary

Don't install pre-built wheels.事前にビルドされたホイールをインストールしないでください。

The given packages will be built and installed from source. The resolver will still use pre-built wheels to extract package metadata, if available.指定されたパッケージはソースからビルドされ、インストールされます。リゾルバーは、利用可能な場合、パッケージメタデータを抽出するために事前にビルドされたホイールを使用します。

May also be set with the UV_NO_BINARY environment variable.UV_NO_BINARY 環境変数でも設定できます。

--no-binary-package no-binary-package--no-binary-package no-binary-package

Don't install pre-built wheels for a specific package特定のパッケージに対して事前にビルドされたホイールをインストールしないでください。

May also be set with the UV_NO_BINARY_PACKAGE environment variable.UV_NO_BINARY_PACKAGE 環境変数でも設定できます。

--no-build--no-build

Don't build source distributions.ソース配布物をビルドしないでください。

When enabled, resolving will not run arbitrary Python code. The cached wheels of already-built source distributions will be reused, but operations that require building distributions will exit with an error.有効にすると、リゾルビングは任意のPythonコードを実行しません。すでにビルドされたソース配布物のキャッシュされたホイールは再利用されますが、配布物をビルドする必要がある操作はエラーで終了します。

May also be set with the UV_NO_BUILD environment variable.環境変数 UV_NO_BUILD でも設定できます。

--no-build-isolation--no-build-isolation

Disable isolation when building source distributions.ソース配布物をビルドする際に隔離を無効にします。

Assumes that build dependencies specified by PEP 518 are already installed.PEP 518 で指定されたビルド依存関係がすでにインストールされていると仮定します。

May also be set with the UV_NO_BUILD_ISOLATION environment variable.環境変数 UV_NO_BUILD_ISOLATION でも設定できます。

--no-build-isolation-package no-build-isolation-package--no-build-isolation-package no-build-isolation-package

Disable isolation when building source distributions for a specific package.特定のパッケージのソース配布物をビルドする際に隔離を無効にします。

Assumes that the packages' build dependencies specified by PEP 518 are already installed.そのパッケージのビルド依存関係が PEP 518 で指定されていると仮定します。

--no-build-package no-build-package--no-build-package no-build-package

Don't build source distributions for a specific package特定のパッケージのソース配布物をビルドしません

May also be set with the UV_NO_BUILD_PACKAGE environment variable.環境変数 UV_NO_BUILD_PACKAGE でも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.環境変数 UV_NO_CACHE でも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml, uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.環境変数 UV_NO_CONFIG でも設定できます。

--no-default-groups--no-default-groups

Ignore the default dependency groups.デフォルトの依存関係グループを無視します。

uv includes the groups defined in tool.uv.default-groups by default. This disables that option, however, specific groups can still be included with --group.uvはデフォルトでtool.uv.default-groupsで定義されたグループを含みます。ただし、このオプションは無効になり、特定のグループは--groupで含めることができます。

May also be set with the UV_NO_DEFAULT_GROUPS environment variable.UV_NO_DEFAULT_GROUPS環境変数で設定することもできます。

--no-dev--no-dev

Disable the development dependency group.開発依存関係グループを無効にします。

This option is an alias of --no-group dev. See --no-default-groups to disable all default groups instead.このオプションは--no-group devのエイリアスです。すべてのデフォルトグループを無効にするには--no-default-groupsを参照してください。

This option is only available when running in a project.このオプションはプロジェクト内で実行しているときのみ利用可能です。

May also be set with the UV_NO_DEV environment variable.UV_NO_DEV環境変数で設定することもできます。

--no-editable--no-editable

Install any editable dependencies, including the project and any workspace members, as non-editableプロジェクトおよびワークスペースメンバーを含むすべての編集可能な依存関係を非編集可能としてインストールします。

May also be set with the UV_NO_EDITABLE environment variable.UV_NO_EDITABLE環境変数で設定することもできます。

--no-env-file--no-env-file

Avoid reading environment variables from a .env file.envファイルから環境変数を読み込まないようにします

May also be set with the UV_NO_ENV_FILE environment variable.UV_NO_ENV_FILE環境変数でも設定可能です。

--no-extra no-extra--no-extra no-extra

Exclude the specified optional dependencies, if --all-extras is supplied.指定されたオプションの依存関係を除外します。--all-extrasが指定されている場合。

May be provided multiple times.複数回提供可能です。

--no-group no-group--no-group no-group

Disable the specified dependency group.指定された依存関係グループを無効にします。

This option always takes precedence over default groups, --all-groups, and --group.このオプションは常にデフォルトグループ、--all-groups、および--groupよりも優先されます。

May be provided multiple times.複数回提供可能です。

May also be set with the UV_NO_GROUP environment variable.また、UV_NO_GROUP 環境変数で設定することもできます。

--no-index--no-index

Ignore the registry index (e.g., PyPI), instead relying on direct URL dependencies and those provided via --find-linksレジストリインデックス（例：PyPI）を無視し、代わりに直接URL依存関係と--find-linksを介して提供されるものに依存します。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.また、UV_NO_MANAGED_PYTHON 環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなど。

May also be set with the UV_NO_PROGRESS environment variable.環境変数 UV_NO_PROGRESS でも設定できます。

--no-project, --no_workspace--no-project, --no_workspace

Avoid discovering the project or workspace.プロジェクトやワークスペースの発見を避けます。

Instead of searching for projects in the current directory and parent directories, run in an isolated, ephemeral environment populated by the --with requirements.現在のディレクトリや親ディレクトリでプロジェクトを検索する代わりに、--with 要件で構成された孤立した一時的な環境で実行します。

If a virtual environment is active or found in a current or parent directory, it will be used as if there was no project or workspace.仮想環境がアクティブであるか、現在または親ディレクトリに見つかった場合、プロジェクトやワークスペースがないかのように使用されます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--no-sources--no-sources

Ignore the tool.uv.sources table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any workspace, Git, URL, or local path sources依存関係を解決する際に tool.uv.sources テーブルを無視します。ワークスペース、Git、URL、またはローカルパスソースを使用するのではなく、標準準拠の公開可能なパッケージメタデータに対してロックするために使用されます。

May also be set with the UV_NO_SOURCES environment variable.環境変数 UV_NO_SOURCES でも設定できます。

--no-sync--no-sync

Avoid syncing the virtual environment.仮想環境の同期を避けます。

Implies --frozen, as the project dependencies will be ignored (i.e., the lockfile will not be updated, since the environment will not be synced regardless).--frozenを暗示します。プロジェクトの依存関係は無視されるため（つまり、環境は同期されないため、ロックファイルは更新されません）。

May also be set with the UV_NO_SYNC environment variable.UV_NO_SYNC環境変数でも設定できます。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE環境変数でも設定できます。

--only-dev--only-dev

Only include the development dependency group.開発依存関係グループのみを含めます。

The project and its dependencies will be omitted.プロジェクトとその依存関係は省略されます。

This option is an alias for --only-group dev. Implies --no-default-groups.このオプションは --only-group dev のエイリアスです。 --no-default-groups を含意します。

--only-group only-group--only-group only-group

Only include dependencies from the specified dependency group.指定された依存関係グループからの依存関係のみを含めます。

The project and its dependencies will be omitted.プロジェクトとその依存関係は省略されます。

May be provided multiple times. Implies --no-default-groups.複数回提供することができます。 --no-default-groups を含意します。

--package package--package package

Run the command in a specific package in the workspace.ワークスペース内の特定のパッケージでコマンドを実行します。

If the workspace member does not exist, uv will exit with an error.ワークスペースメンバーが存在しない場合、uvはエラーで終了します。

--prerelease prerelease--prerelease prerelease

The strategy to use when considering pre-release versions.プレリリースバージョンを考慮する際に使用する戦略。

By default, uv will accept pre-releases for packages that only publish pre-releases, along with first-party requirements that contain an explicit pre-release marker in the declared specifiers (if-necessary-or-explicit).デフォルトでは、uvはプレリリースのみを公開するパッケージと、宣言された指定子に明示的なプレリリースマーカーを含むファーストパーティの要件に対してプレリリースを受け入れます（if-necessary-or-explicit）。

May also be set with the UV_PRERELEASE environment variable.UV_PRERELEASE環境変数で設定することもできます。

Possible values:可能な値：

disallow: Disallow all pre-release versionsdisallow: すべてのプレリリースバージョンを禁止する
allow: Allow all pre-release versionsallow: すべてのプレリリースバージョンを許可する
if-necessary: Allow pre-release versions if all versions of a package are pre-releaseif-necessary: すべてのバージョンがプレリリースである場合にプレリリースバージョンを許可する
explicit: Allow pre-release versions for first-party packages with explicit pre-release markers in their version requirementsexplicit: バージョン要件に明示的なプレリリースマーカーを持つファーストパーティパッケージに対してプレリリースバージョンを許可する
if-necessary-or-explicit: Allow pre-release versions if all versions of a package are pre-release, or if the package has an explicit pre-release marker in its version requirementsif-necessary-or-explicit: すべてのバージョンがプレリリースである場合、またはパッケージのバージョン要件に明示的なプレリリースマーカーがある場合にプレリリースバージョンを許可する

--project project--project project

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用される場合、効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数を使用して設定することもできます。

--python, -p python--python、-p python

The Python interpreter to use for the run environment.実行環境で使用するPythonインタープリター。

If the interpreter request is satisfied by a discovered environment, the environment will be used.インタープリターのリクエストが発見された環境によって満たされる場合、その環境が使用されます。

See uv python to view supported request formats.サポートされているリクエスト形式を表示するには、uv python を参照してください。

May also be set with the UV_PYTHON environment variable.また、UV_PYTHON 環境変数で設定することもできます。

--python-platform python-platform--python-platform python-platform

The platform for which requirements should be installed.要件をインストールする対象プラットフォーム。

Represented as a "target triple", a string that describes the target platform in terms of its CPU, vendor, and operating system name, like x86_64-unknown-linux-gnu or aarch64-apple-darwin.CPU、ベンダー、およびオペレーティングシステム名に関してターゲットプラットフォームを説明する文字列である「ターゲットトリプル」として表されます。例: x86_64-unknown-linux-gnu または aarch64-apple-darwin。

When targeting macOS (Darwin), the default minimum version is 13.0. Use MACOSX_DEPLOYMENT_TARGET to specify a different minimum version, e.g., 14.0.macOS (Darwin) をターゲットにする場合、デフォルトの最小バージョンは 13.0 です。異なる最小バージョンを指定するには MACOSX_DEPLOYMENT_TARGET を使用します。例: 14.0。

When targeting iOS, the default minimum version is 13.0. Use IPHONEOS_DEPLOYMENT_TARGET to specify a different minimum version, e.g., 14.0.iOS をターゲットにする場合、デフォルトの最小バージョンは 13.0 です。異なる最小バージョンを指定するには IPHONEOS_DEPLOYMENT_TARGET を使用します。例: 14.0。

When targeting Android, the default minimum Android API level is 24. Use ANDROID_API_LEVEL to specify a different minimum version, e.g., 26.Android をターゲットにする場合、デフォルトの最小 Android API レベルは 24 です。異なる最小バージョンを指定するには ANDROID_API_LEVEL を使用します。例: 26。

WARNING: When specified, uv will select wheels that are compatible with the target platform; as a result, the installed distributions may not be compatible with the current platform. Conversely, any distributions that are built from source may be incompatible with the target platform, as they will be built for the current platform. The --python-platform option is intended for advanced use cases.警告: 指定された場合、uv は ターゲット プラットフォームと互換性のあるホイールを選択します。その結果、インストールされたディストリビューションは 現在の プラットフォームと互換性がない可能性があります。逆に、ソースからビルドされたディストリビューションは ターゲット プラットフォームと互換性がない可能性があります。なぜなら、それらは 現在の プラットフォーム用にビルドされるからです。--python-platform オプションは高度な使用ケースを想定しています。

Possible values:可能な値:

windows: An alias for x86_64-pc-windows-msvc, the default target for Windowswindows: x86_64-pc-windows-msvc のエイリアスで、Windows のデフォルトターゲットです
linux: An alias for x86_64-unknown-linux-gnu, the default target for Linuxlinux: x86_64-unknown-linux-gnuのエイリアスで、Linuxのデフォルトターゲットです。
macos: An alias for aarch64-apple-darwin, the default target for macOSmacos: aarch64-apple-darwinのエイリアスで、macOSのデフォルトターゲットです。
x86_64-pc-windows-msvc: A 64-bit x86 Windows targetx86_64-pc-windows-msvc: 64ビットx86 Windowsターゲットです。
aarch64-pc-windows-msvc: An ARM64 Windows targetaarch64-pc-windows-msvc: ARM64 Windowsターゲットです。
i686-pc-windows-msvc: A 32-bit x86 Windows targeti686-pc-windows-msvc: 32ビットx86 Windowsターゲットです。
x86_64-unknown-linux-gnu: An x86 Linux target. Equivalent to x86_64-manylinux_2_28x86_64-unknown-linux-gnu: x86 Linuxターゲットです。x86_64-manylinux_2_28と同等です。
aarch64-apple-darwin: An ARM-based macOS target, as seen on Apple Silicon devicesaarch64-apple-darwin: Apple Siliconデバイスで見られるARMベースのmacOSターゲットです。
x86_64-apple-darwin: An x86 macOS targetx86_64-apple-darwin: x86 macOSターゲットです。
aarch64-unknown-linux-gnu: An ARM64 Linux target. Equivalent to aarch64-manylinux_2_28aarch64-unknown-linux-gnu: ARM64 Linuxターゲットです。aarch64-manylinux_2_28と同等です。
aarch64-unknown-linux-musl: An ARM64 Linux targetaarch64-unknown-linux-musl: ARM64 Linuxターゲットです。
x86_64-unknown-linux-musl: An x86_64 Linux targetx86_64-unknown-linux-musl: x86_64 Linux ターゲット
riscv64-unknown-linux: A RISCV64 Linux targetriscv64-unknown-linux: RISCV64 Linux ターゲット
x86_64-manylinux2014: An x86_64 target for the manylinux2014 platform. Equivalent to x86_64-manylinux_2_17x86_64-manylinux2014: x86_64 ターゲット for manylinux2014 プラットフォーム。x86_64-manylinux_2_17 と同等
x86_64-manylinux_2_17: An x86_64 target for the manylinux_2_17 platformx86_64-manylinux_2_17: x86_64 ターゲット for manylinux_2_17 プラットフォーム
x86_64-manylinux_2_28: An x86_64 target for the manylinux_2_28 platformx86_64-manylinux_2_28: x86_64 ターゲット for manylinux_2_28 プラットフォーム
x86_64-manylinux_2_31: An x86_64 target for the manylinux_2_31 platformx86_64-manylinux_2_31: x86_64 ターゲット for manylinux_2_31 プラットフォーム
x86_64-manylinux_2_32: An x86_64 target for the manylinux_2_32 platformx86_64-manylinux_2_32: x86_64 ターゲット for manylinux_2_32 プラットフォーム
x86_64-manylinux_2_33: An x86_64 target for the manylinux_2_33 platformx86_64-manylinux_2_33: x86_64 ターゲット for manylinux_2_33 プラットフォーム
x86_64-manylinux_2_34: An x86_64 target for the manylinux_2_34 platformx86_64-manylinux_2_34: x86_64 ターゲット for manylinux_2_34 プラットフォーム
x86_64-manylinux_2_35: An x86_64 target for the manylinux_2_35 platformx86_64-manylinux_2_35: x86_64 ターゲット for manylinux_2_35 プラットフォーム
x86_64-manylinux_2_36: An x86_64 target for the manylinux_2_36 platformx86_64-manylinux_2_36: x86_64 ターゲットの manylinux_2_36 プラットフォーム
x86_64-manylinux_2_37: An x86_64 target for the manylinux_2_37 platformx86_64-manylinux_2_37: x86_64 ターゲットの manylinux_2_37 プラットフォーム
x86_64-manylinux_2_38: An x86_64 target for the manylinux_2_38 platformx86_64-manylinux_2_38: x86_64 ターゲットの manylinux_2_38 プラットフォーム
x86_64-manylinux_2_39: An x86_64 target for the manylinux_2_39 platformx86_64-manylinux_2_39: x86_64 ターゲットの manylinux_2_39 プラットフォーム
x86_64-manylinux_2_40: An x86_64 target for the manylinux_2_40 platformx86_64-manylinux_2_40: x86_64 ターゲットの manylinux_2_40 プラットフォーム
aarch64-manylinux2014: An ARM64 target for the manylinux2014 platform. Equivalent to aarch64-manylinux_2_17aarch64-manylinux2014: ARM64 ターゲットの manylinux2014 プラットフォーム。aarch64-manylinux_2_17 と同等
aarch64-manylinux_2_17: An ARM64 target for the manylinux_2_17 platformaarch64-manylinux_2_17: ARM64 ターゲットの manylinux_2_17 プラットフォーム
aarch64-manylinux_2_28: An ARM64 target for the manylinux_2_28 platformaarch64-manylinux_2_28: ARM64 ターゲットの manylinux_2_28 プラットフォーム
aarch64-manylinux_2_31: An ARM64 target for the manylinux_2_31 platformaarch64-manylinux_2_31: ARM64 ターゲットの manylinux_2_31 プラットフォーム
aarch64-manylinux_2_32: An ARM64 target for the manylinux_2_32 platformaarch64-manylinux_2_32: ARM64 ターゲットの manylinux_2_32 プラットフォーム
aarch64-manylinux_2_33: An ARM64 target for the manylinux_2_33 platformaarch64-manylinux_2_33: manylinux_2_33 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_34: An ARM64 target for the manylinux_2_34 platformaarch64-manylinux_2_34: manylinux_2_34 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_35: An ARM64 target for the manylinux_2_35 platformaarch64-manylinux_2_35: manylinux_2_35 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_36: An ARM64 target for the manylinux_2_36 platformaarch64-manylinux_2_36: manylinux_2_36 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_37: An ARM64 target for the manylinux_2_37 platformaarch64-manylinux_2_37: manylinux_2_37 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_38: An ARM64 target for the manylinux_2_38 platformaarch64-manylinux_2_38: manylinux_2_38 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_39: An ARM64 target for the manylinux_2_39 platformaarch64-manylinux_2_39: manylinux_2_39 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_40: An ARM64 target for the manylinux_2_40 platformaarch64-manylinux_2_40: manylinux_2_40 プラットフォーム用の ARM64 ターゲット
aarch64-linux-android: An ARM64 Android targetaarch64-linux-android: ARM64 Android ターゲット
x86_64-linux-android: An x86_64 Android targetx86_64-linux-android: x86_64 Android ターゲット
wasm32-pyodide2024: A wasm32 target using the Pyodide 2024 platform. Meant for use with Python 3.12wasm32-pyodide2024: Pyodide 2024プラットフォームを使用したwasm32ターゲット。Python 3.12と一緒に使用することを意図しています。
arm64-apple-ios: An ARM64 target for iOS devicearm64-apple-ios: iOSデバイス用のARM64ターゲット
arm64-apple-ios-simulator: An ARM64 target for iOS simulatorarm64-apple-ios-simulator: iOSシミュレーター用のARM64ターゲット
x86_64-apple-ios-simulator: An x86_64 target for iOS simulatorx86_64-apple-ios-simulator: iOSシミュレーター用のx86_64ターゲット

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば-qq、uvはstdoutに出力を行わないサイレントモードを有効にします。

--refresh--refresh

Refresh all cached dataすべてのキャッシュデータを更新します。

--refresh-package refresh-package--refresh-package refresh-package

Refresh cached data for a specific package特定のパッケージのキャッシュデータを更新する

--reinstall, --force-reinstall--reinstall, --force-reinstall

Reinstall all packages, regardless of whether they're already installed. Implies --refreshすべてのパッケージを再インストールします。すでにインストールされているかどうかに関係ありません。--refreshを含意します。

--reinstall-package reinstall-package--reinstall-package reinstall-package

Reinstall a specific package, regardless of whether it's already installed. Implies --refresh-package特定のパッケージを再インストールします。すでにインストールされているかどうかに関係ありません。--refresh-packageを含意します。

--resolution resolution--resolution resolution

The strategy to use when selecting between the different compatible versions for a given package requirement.特定のパッケージ要件に対して異なる互換バージョンを選択する際に使用する戦略。

By default, uv will use the latest compatible version of each package (highest).デフォルトでは、uvは各パッケージの最新の互換バージョンを使用します（highest）。

May also be set with the UV_RESOLUTION environment variable.UV_RESOLUTION環境変数で設定することもできます。

Possible values:可能な値：

highest: Resolve the highest compatible version of each packagehighest: 各パッケージの最高の互換性のあるバージョンを解決します
lowest: Resolve the lowest compatible version of each packagelowest: 各パッケージの最低の互換性のあるバージョンを解決します
lowest-direct: Resolve the lowest compatible version of any direct dependencies, and the highest compatible version of any transitive dependencieslowest-direct: 直接の依存関係の最低の互換性のあるバージョンを解決し、間接の依存関係の最高の互換性のあるバージョンを解決します

--script, -s--script, -s

Run the given path as a Python script.指定されたパスをPythonスクリプトとして実行します。

Using --script will attempt to parse the path as a PEP 723 script, irrespective of its extension.--scriptを使用すると、拡張子に関係なく、パスをPEP 723スクリプトとして解析しようとします。

--upgrade, -U--upgrade, -U

Allow package upgrades, ignoring pinned versions in any existing output file. Implies --refreshパッケージのアップグレードを許可し、既存の出力ファイルの固定されたバージョンを無視します。--refreshを含意します

--upgrade-package, -P upgrade-package--upgrade-package, -P upgrade-package

Allow upgrades for a specific package, ignoring pinned versions in any existing output file. Implies --refresh-package特定のパッケージのアップグレードを許可し、既存の出力ファイルの固定されたバージョンを無視します。--refresh-packageを含意します

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)環境変数 RUST_LOG を使用して、詳細なロギングを構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

--with, -w with--with, -w with

Run with the given packages installed.指定されたパッケージがインストールされた状態で実行します。

When used in a project, these dependencies will be layered on top of the project environment in a separate, ephemeral environment. These dependencies are allowed to conflict with those specified by the project.プロジェクトで使用されると、これらの依存関係はプロジェクト環境の上に別の一時的な環境としてレイヤーされます。これらの依存関係は、プロジェクトによって指定されたものと競合することが許可されています。

--with-editable with-editable--with-editable with-editable

Run with the given packages installed in editable mode.指定されたパッケージが編集可能モードでインストールされた状態で実行します。

When used in a project, these dependencies will be layered on top of the project environment in a separate, ephemeral environment. These dependencies are allowed to conflict with those specified by the project.プロジェクトで使用されると、これらの依存関係はプロジェクト環境の上に別の一時的な環境としてレイヤーされます。これらの依存関係は、プロジェクトによって指定されたものと競合することが許可されています。

--with-requirements with-requirements--with-requirements with-requirements

Run with the packages listed in the given files.指定されたファイルにリストされたパッケージで実行します。

The following formats are supported: requirements.txt, .py files with inline metadata, and pylock.toml.サポートされているフォーマットは次の通りです: requirements.txt、インラインメタデータを含む.pyファイル、およびpylock.toml。

The same environment semantics as --with apply.--withと同じ環境セマンティクスが適用されます。

Using pyproject.toml, setup.py, or setup.cfg files is not allowed.pyproject.toml、setup.py、またはsetup.cfgファイルの使用は許可されていません。

uv inituv init

Create a new project.新しいプロジェクトを作成します。

Follows the pyproject.toml specification.pyproject.toml仕様に従います。

If a pyproject.toml already exists at the target, uv will exit with an error.ターゲットにpyproject.tomlが既に存在する場合、uvはエラーで終了します。

If a pyproject.toml is found in any of the parent directories of the target path, the project will be added as a workspace member of the parent.ターゲットパスの親ディレクトリのいずれかにpyproject.tomlが見つかった場合、プロジェクトは親のワークスペースメンバーとして追加されます。

Some project state is not created until needed, e.g., the project virtual environment (.venv) and lockfile (uv.lock) are lazily created during the first sync.一部のプロジェクト状態は必要になるまで作成されません。例えば、プロジェクトの仮想環境（.venv）やロックファイル（uv.lock）は、最初の同期中に遅延作成されます。

Usage使用法

uv init [OPTIONS] [PATH]

Arguments引数

PATHPATH

The path to use for the project/script.プロジェクト/スクリプトに使用するパス。

Defaults to the current working directory when initializing an app or library; required when initializing a script. Accepts relative and absolute paths.アプリまたはライブラリを初期化する際は現在の作業ディレクトリがデフォルトとなり、スクリプトを初期化する際は必須です。相対パスと絶対パスの両方を受け付けます。

If a pyproject.toml is found in any of the parent directories of the target path, the project will be added as a workspace member of the parent, unless --no-workspace is provided.ターゲットパスの親ディレクトリのいずれかにpyproject.tomlが見つかった場合、--no-workspaceが指定されていない限り、プロジェクトは親のワークスペースメンバーとして追加されます。

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回指定することができます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、検証されたソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--app, --application--app、--application

Create a project for an application.アプリケーションのためのプロジェクトを作成します。

This is the default behavior if --lib is not requested.--libが要求されていない場合、これはデフォルトの動作です。

This project kind is for web servers, scripts, and command-line interfaces.このプロジェクトの種類は、ウェブサーバー、スクリプト、およびコマンドラインインターフェース用です。

By default, an application is not intended to be built and distributed as a Python package. The --package option can be used to create an application that is distributable, e.g., if you want to distribute a command-line interface via PyPI.デフォルトでは、アプリケーションはPythonパッケージとしてビルドおよび配布されることを意図していません。--packageオプションを使用すると、コマンドラインインターフェースをPyPI経由で配布したい場合などに、配布可能なアプリケーションを作成できます。

--author-from author-from--author-from author-from

Fill in the authors field in the pyproject.toml.pyproject.tomlのauthorsフィールドを記入します。

By default, uv will attempt to infer the author information from some sources (e.g., Git) (auto). Use --author-from git to only infer from Git configuration. Use --author-from none to avoid inferring the author information.デフォルトでは、uvは一部のソース（例：Git）から著者情報を推測しようとします（auto）。Git設定からのみ推測するには、--author-from gitを使用してください。著者情報の推測を避けるには、--author-from noneを使用してください。

Possible values:可能な値：

auto: Fetch the author information from some sources (e.g., Git) automaticallyauto: 一部のソース（例：Git）から著者情報を自動的に取得します
git: Fetch the author information from Git configuration onlygit: Git設定からのみ著者情報を取得します
none: Do not infer the author informationnone: 著者情報を推測しません

--bare--bare

Only create a pyproject.toml.のみpyproject.tomlを作成します。

Disables creating extra files like README.md, the src/ tree, .python-version files, etc.README.md、src/ツリー、.python-versionファイルなどの追加ファイルの作成を無効にします。

--build-backend build-backend--build-backend build-backend

Initialize a build-backend of choice for the project.プロジェクトのために選択したビルドバックエンドを初期化します。

Implicitly sets --package.--packageを暗黙的に設定します。

May also be set with the UV_INIT_BUILD_BACKEND environment variable.UV_INIT_BUILD_BACKEND環境変数でも設定できます。

Possible values:可能な値：

uv: Use uv as the project build backenduv: プロジェクトのビルドバックエンドとしてuvを使用します
hatch: Use hatchling as the project build backendhatch: プロジェクトのビルドバックエンドとしてhatchlingを使用します
flit: Use flit-core as the project build backendflit: プロジェクトのビルドバックエンドとしてflit-coreを使用します
pdm: Use pdm-backend as the project build backendpdm: プロジェクトのビルドバックエンドとしてpdm-backendを使用します
poetry: Use poetry-core as the project build backendpoetry: プロジェクトのビルドバックエンドとしてpoetry-coreを使用します
setuptools: Use setuptools as the project build backendsetuptools: プロジェクトのビルドバックエンドとしてsetuptoolsを使用します
maturin: Use maturin as the project build backendmaturin: プロジェクトのビルドバックエンドとしてmaturinを使用します
scikit: Use scikit-build-core as the project build backendscikit: プロジェクトのビルドバックエンドとしてscikit-build-coreを使用します

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvに、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されています。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数を使用して設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvはターミナルへの書き込み時に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力が端末またはサポートされているTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.uv.tomlファイルのパスを設定して、構成に使用します。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの構成はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数を使用して設定することもできます。

--description description--description description

Set the project descriptionプロジェクトの説明を設定します。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数でも設定できます。

--help, -h--help、-h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--lib, --library--lib、--library

Create a project for a library.ライブラリのためのプロジェクトを作成します。

A library is a project that is intended to be built and distributed as a Python package.ライブラリは、Pythonパッケージとして構築および配布されることを意図したプロジェクトです。

--managed-python--managed-python

Require use of uv-managed Python versions.uvが管理するPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンの使用を優先します。ただし、uvが管理するPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON 環境変数で設定することもできます。

--name name--name name

The name of the project.プロジェクトの名前。

Defaults to the name of the directory.ディレクトリの名前がデフォルトになります。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンス（特にmacOSで）が向上します。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、特にシステムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したいことがあります。

May also be set with the UV_NATIVE_TLS environment variable.環境変数 UV_NATIVE_TLS でも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.環境変数 UV_NO_CACHE でも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml, uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.環境変数 UV_NO_CONFIG でも設定できます。

--no-description--no-description

Disable the description for the projectプロジェクトの説明を無効にします。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv-managed Python バージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uv はシステム上の適切な Python バージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON 環境変数を使用して設定することもできます。

--no-package--no-package

Do not set up the project to be built as a Python package.プロジェクトを Python パッケージとしてビルドするように設定しません。

Does not include a [build-system] for the project.プロジェクトのための [build-system] は含まれていません。

This is the default behavior when using --app.--app を使用する際のデフォルトの動作です。

--no-pin-python--no-pin-python

Do not create a .python-version file for the project.プロジェクトのための .python-version ファイルを作成しません。

By default, uv will create a .python-version file containing the minor version of the discovered Python interpreter, which will cause subsequent uv commands to use that version.デフォルトでは、uvは発見されたPythonインタプリタのマイナーバージョンを含む.python-versionファイルを作成します。これにより、以降のuvコマンドはそのバージョンを使用します。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS環境変数でも設定できます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--no-readme--no-readme

Do not create a README.md fileREADME.mdファイルを作成しません。

--no-workspace, --no-project--no-workspace, --no-project

Avoid discovering a workspace and create a standalone project.ワークスペースを検出せず、スタンドアロンプロジェクトを作成します。

By default, uv searches for workspaces in the current directory or any parent directory.デフォルトでは、uvは現在のディレクトリまたは親ディレクトリ内のワークスペースを検索します。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE環境変数を使用して設定することもできます。

--package--package

Set up the project to be built as a Python package.プロジェクトをPythonパッケージとしてビルドするように設定します。

Defines a [build-system] for the project.プロジェクトのための[build-system]を定義します。

This is the default behavior when using --lib or --build-backend.これは、--libまたは--build-backendを使用する際のデフォルトの動作です。

When using --app, this will include a [project.scripts] entrypoint and use a src/ project structure.--appを使用すると、[project.scripts]エントリポイントが含まれ、src/プロジェクト構造が使用されます。

--project project--project project

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべてのpyproject.toml、uv.toml、および.python-versionファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見され、プロジェクトの仮想環境（.venv）も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.--directoryを参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pipインターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT環境変数を使用して設定することもできます。

--python, -p python--python、-p python

The Python interpreter to use to determine the minimum supported Python version.最小サポートされるPythonバージョンを決定するために使用するPythonインタプリタ。

See uv python to view supported request formats.サポートされているリクエスト形式を表示するには、uv pythonを参照してください。

May also be set with the UV_PYTHON environment variable.UV_PYTHON環境変数を使用して設定することもできます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば-qq、uvはstdoutに出力を行わないサイレントモードを有効にします。

--script--script

Create a script.スクリプトを作成します。

A script is a standalone file with embedded metadata enumerating its dependencies, along with any Python version requirements, as defined in the PEP 723 specification.スクリプトは、その依存関係を列挙する埋め込まれたメタデータを持つスタンドアロンファイルであり、PEP 723仕様で定義されたPythonバージョン要件を含みます。

PEP 723 scripts can be executed directly with uv run.PEP 723スクリプトは、uv runで直接実行できます。

By default, adds a requirement on the system Python version; use --python to specify an alternative Python version requirement.デフォルトでは、システムPythonバージョンに対する要件が追加されます。代わりのPythonバージョン要件を指定するには--pythonを使用してください。

--vcs vcs--vcs vcs

Initialize a version control system for the project.プロジェクトのためにバージョン管理システムを初期化します。

By default, uv will initialize a Git repository (git). Use --vcs none to explicitly avoid initializing a version control system.デフォルトでは、uvはGitリポジトリを初期化します (git)。バージョン管理システムの初期化を明示的に避けるには、--vcs noneを使用してください。

Possible values:可能な値:

git: Use Git for version controlgit: バージョン管理にGitを使用します
none: Do not use any version control systemnone: バージョン管理システムを使用しません

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)RUST_LOG環境変数を使用して、詳細なロギングを構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv adduv add

Add dependencies to the project.プロジェクトに依存関係を追加します。

Dependencies are added to the project's pyproject.toml file.依存関係はプロジェクトの pyproject.toml ファイルに追加されます。

If a given dependency exists already, it will be updated to the new version specifier unless it includes markers that differ from the existing specifier in which case another entry for the dependency will be added.指定された依存関係がすでに存在する場合、それは新しいバージョン指定に更新されます。ただし、既存の指定と異なるマーカーが含まれている場合は、その依存関係の別のエントリが追加されます。

The lockfile and project environment will be updated to reflect the added dependencies. To skip updating the lockfile, use --frozen. To skip updating the environment, use --no-sync.ロックファイルとプロジェクト環境は、追加された依存関係を反映するように更新されます。ロックファイルの更新をスキップするには --frozen を使用します。環境の更新をスキップするには --no-sync を使用します。

If any of the requested dependencies cannot be found, uv will exit with an error, unless the --frozen flag is provided, in which case uv will add the dependencies verbatim without checking that they exist or are compatible with the project.要求された依存関係のいずれかが見つからない場合、--frozen フラグが提供されていない限り、uvはエラーで終了します。この場合、uvは依存関係をそのまま追加し、存在するかどうかやプロジェクトとの互換性を確認しません。

uv will search for a project in the current directory or any parent directory. If a project cannot be found, uv will exit with an error.uvは現在のディレクトリまたは親ディレクトリ内でプロジェクトを検索します。プロジェクトが見つからない場合、uvはエラーで終了します。

Usage使用法

uv add [OPTIONS] <PACKAGES|--requirements <REQUIREMENTS>>

Arguments引数

PACKAGESPACKAGES: The packages to add, as PEP 508 requirements (e.g., ruff==0.5.0)追加するパッケージ、PEP 508 要件として（例： ruff==0.5.0）

Optionsオプション

--active--active

Prefer the active virtual environment over the project's virtual environment.プロジェクトの仮想環境よりもアクティブな仮想環境を優先します。

If the project virtual environment is active or no virtual environment is active, this has no effect.プロジェクトの仮想環境がアクティブであるか、仮想環境がアクティブでない場合、これは効果がありません。

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回提供できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例: localhost）、ホスト-ポートペア（例: localhost:8080）、またはURL（例: https://localhost）のいずれかを受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告: このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--bounds bounds--bounds 境界

The kind of version specifier to use when adding dependencies.依存関係を追加する際に使用するバージョン指定子の種類。

When adding a dependency to the project, if no constraint or URL is provided, a constraint is added based on the latest compatible version of the package. By default, a lower bound constraint is used, e.g., >=1.2.3.プロジェクトに依存関係を追加する際、制約やURLが提供されていない場合、パッケージの最新の互換性のあるバージョンに基づいて制約が追加されます。デフォルトでは、下限制約が使用されます。例: >=1.2.3。

When --frozen is provided, no resolution is performed, and dependencies are always added without constraints.--frozen が提供されると、解決は行われず、依存関係は常に制約なしで追加されます。

This option is in preview and may change in any future release.このオプションはプレビュー中であり、将来のリリースで変更される可能性があります。

Possible values:可能な値:

lower: Only a lower bound, e.g., >=1.2.3lower: 下限のみ、例: >=1.2.3
major: Allow the same major version, similar to the semver caret, e.g., >=1.2.3, <2.0.0major: 同じメジャーバージョンを許可、semverのキャレットに似ています。例: >=1.2.3, <2.0.0
minor: Allow the same minor version, similar to the semver tilde, e.g., >=1.2.3, <1.3.0minor: 同じマイナーバージョンを許可、semverのチルダに似ています。例: >=1.2.3, <1.3.0
exact: Pin the exact version, e.g., ==1.2.3exact: 正確なバージョンを固定、例: ==1.2.3

--branch branch--branch ブランチ

Branch to use when adding a dependency from Git依存関係をGitから追加する際に使用するブランチ

--cache-dir cache-dir--cache-dir キャッシュディレクトリ

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.デフォルトでは、$XDG_CACHE_HOME/uv または $HOME/.cache/uv（macOSおよびLinux）、および %LOCALAPPDATA%\uv\cache（Windows）になります。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR 環境変数を使用して設定することもできます。

--color color-choice--color 色の選択

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvはターミナルに書き込む際に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: ターミナルまたはTTYがサポートしている場合にのみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--compile-bytecode, --compile--compile-bytecode、--compile

Compile Python files to bytecode after installation.インストール後にPythonファイルをバイトコードにコンパイルします。

By default, uv does not compile Python (.py) files to bytecode (__pycache__/*.pyc); instead, compilation is performed lazily the first time a module is imported. For use-cases in which start time is critical, such as CLI applications and Docker containers, this option can be enabled to trade longer installation times for faster start times.デフォルトでは、uvはPython（.py）ファイルをバイトコード（__pycache__/*.pyc）にコンパイルしません。代わりに、モジュールが初めてインポートされるときに遅延的にコンパイルが行われます。CLIアプリケーションやDockerコンテナなど、起動時間が重要なユースケースでは、このオプションを有効にして、長いインストール時間と引き換えに速い起動時間を得ることができます。

When enabled, uv will process the entire site-packages directory (including packages that are not being modified by the current operation) for consistency. Like pip, it will also ignore errors.有効にすると、uvは一貫性のためにサイトパッケージディレクトリ全体（現在の操作によって変更されていないパッケージを含む）を処理します。pipのように、エラーも無視します。

May also be set with the UV_COMPILE_BYTECODE environment variable.UV_COMPILE_BYTECODE環境変数を使用して設定することもできます。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.uv.tomlファイルのパスを設定に使用します。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数で設定することもできます。

--config-setting, --config-settings, -C config-setting--config-setting, --config-settings, -C config-setting

Settings to pass to the PEP 517 build backend, specified as KEY=VALUE pairsPEP 517ビルドバックエンドに渡す設定で、KEY=VALUEペアとして指定します。

--config-settings-package, --config-settings-package config-settings-package--config-settings-package, --config-settings-package config-settings-package

Settings to pass to the PEP 517 build backend for a specific package, specified as PACKAGE:KEY=VALUE pairs特定のパッケージのためにPEP 517ビルドバックエンドに渡す設定で、PACKAGE:KEY=VALUEペアとして指定します。

--constraints, --constraint, -c constraints--constraints, --constraint, -c constraints

Constrain versions using the given requirements files.指定された要件ファイルを使用してバージョンを制約します。

Constraints files are requirements.txt-like files that only control the version of a requirement that's installed. The constraints will not be added to the project's pyproject.toml file, but will be respected during dependency resolution.制約ファイルはrequirements.txtのようなファイルで、インストールされる要件のバージョンのみを制御します。制約はプロジェクトのpyproject.tomlファイルには追加されませんが、依存関係の解決中には尊重されます。

This is equivalent to pip's --constraint option.これはpipの--constraintオプションと同等です。

May also be set with the UV_CONSTRAINT environment variable.また、UV_CONSTRAINT環境変数で設定することもできます。

--default-index default-index--default-index default-index

The URL of the default package index (by default: https://pypi.org/simple).デフォルトのパッケージインデックスのURL（デフォルトでは: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --index flag.このフラグで指定されたインデックスは、--indexフラグで指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_DEFAULT_INDEX environment variable.また、UV_DEFAULT_INDEX環境変数で設定することもできます。

--dev--dev

Add the requirements to the development dependency group.要件を開発依存関係グループに追加します。

This option is an alias for --group dev.このオプションは--group devのエイリアスです。

May also be set with the UV_DEV environment variable.また、UV_DEV 環境変数で設定することもできます。

--directory directory--directory ディレクトリ

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--project を参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.また、UV_WORKING_DIRECTORY 環境変数で設定することもできます。

--editable--editable

Add the requirements as editable要件を編集可能として追加します。

--exclude-newer exclude-newer--exclude-newer exclude-newer

Limit candidate packages to those that were uploaded prior to the given date.候補パッケージを、指定された日付以前にアップロードされたものに制限します。

Accepts both RFC 3339 timestamps (e.g., 2006-12-02T02:07:43Z) and local dates in the same format (e.g., 2006-12-02) in your system's configured time zone.RFC 3339 タイムスタンプ（例：2006-12-02T02:07:43Z）と、システムの設定されたタイムゾーンでの同じ形式のローカル日付（例：2006-12-02）の両方を受け入れます。

May also be set with the UV_EXCLUDE_NEWER environment variable.UV_EXCLUDE_NEWER 環境変数で設定することもできます。

--exclude-newer-package exclude-newer-package--exclude-newer-package exclude-newer-package

Limit candidate packages for specific packages to those that were uploaded prior to the given date.特定のパッケージの候補パッケージを、指定された日付以前にアップロードされたものに制限します。

Accepts package-date pairs in the format PACKAGE=DATE, where DATE is an RFC 3339 timestamp (e.g., 2006-12-02T02:07:43Z) or local date (e.g., 2006-12-02) in your system's configured time zone.PACKAGE=DATE 形式のパッケージ日付ペアを受け入れます。ここで、DATE は RFC 3339 タイムスタンプ（例：2006-12-02T02:07:43Z）またはローカル日付（例：2006-12-02）で、システムの設定されたタイムゾーンでのものです。

Can be provided multiple times for different packages.異なるパッケージのために複数回提供できます。

--extra extra--extra extra

Extras to enable for the dependency.依存関係のために有効にする追加機能。

May be provided more than once.複数回提供することができます。

To add this dependency to an optional extra instead, see --optional.この依存関係をオプショナルな追加に追加するには、--optional を参照してください。

--extra-index-url extra-index-url--extra-index-url extra-index-url

(Deprecated: use --index instead) Extra URLs of package indexes to use, in addition to --index-url.(非推奨: 代わりに --index を使用してください) --index-url に加えて使用するパッケージインデックスの追加URL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --index-url (which defaults to PyPI). When multiple --extra-index-url flags are provided, earlier values take priority.このフラグを介して提供されたすべてのインデックスは、--index-url（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の --extra-index-url フラグが提供される場合、早い値が優先されます。

May also be set with the UV_EXTRA_INDEX_URL environment variable.UV_EXTRA_INDEX_URL 環境変数でも設定できます。

--find-links, -f find-links--find-links, -f find-links

Locations to search for candidate distributions, in addition to those found in the registry indexes.レジストリインデックスで見つかったものに加えて、候補の配布物を検索する場所。

If a path, the target must be a directory that contains packages as wheel files (.whl) or source distributions (e.g., .tar.gz or .zip) at the top level.パスの場合、ターゲットはトップレベルにホイールファイル（.whl）またはソース配布（例: .tar.gz または .zip）を含むディレクトリでなければなりません。

If a URL, the page must contain a flat list of links to package files adhering to the formats described above.URLの場合、ページは上記の形式に従ったパッケージファイルへのリンクのフラットリストを含む必要があります。

May also be set with the UV_FIND_LINKS environment variable.UV_FIND_LINKS 環境変数でも設定できます。

--fork-strategy fork-strategy--fork-strategy fork-strategy

The strategy to use when selecting multiple versions of a given package across Python versions and platforms.特定のパッケージの複数のバージョンをPythonのバージョンやプラットフォームにわたって選択する際に使用する戦略。

By default, uv will optimize for selecting the latest version of each package for each supported Python version (requires-python), while minimizing the number of selected versions across platforms.デフォルトでは、uvは各サポートされているPythonバージョン（requires-python）ごとに各パッケージの最新バージョンを選択することを最適化し、プラットフォーム間で選択されたバージョンの数を最小限に抑えます。

Under fewest, uv will minimize the number of selected versions for each package, preferring older versions that are compatible with a wider range of supported Python versions or platforms.fewestの下では、uvは各パッケージの選択されたバージョンの数を最小限に抑え、より広範囲のサポートされているPythonバージョンやプラットフォームと互換性のある古いバージョンを優先します。

May also be set with the UV_FORK_STRATEGY environment variable.UV_FORK_STRATEGY環境変数を使用して設定することもできます。

Possible values:可能な値：

fewest: Optimize for selecting the fewest number of versions for each package. Older versions may be preferred if they are compatible with a wider range of supported Python versions or platformsfewest: 各パッケージの選択されたバージョンの数を最小限に抑えることを最適化します。より広範囲のサポートされているPythonバージョンやプラットフォームと互換性がある場合、古いバージョンが優先されることがあります。
requires-python: Optimize for selecting latest supported version of each package, for each supported Python versionrequires-python: 各サポートされているPythonバージョンごとに、各パッケージの最新のサポートされているバージョンを選択することを最適化します。

--frozen--frozen

Add dependencies without re-locking the project.プロジェクトを再ロックすることなく依存関係を追加します。

The project environment will not be synced.プロジェクト環境は同期されません。

May also be set with the UV_FROZEN environment variable.また、UV_FROZEN 環境変数で設定することもできます。

--group group--group group

Add the requirements to the specified dependency group.指定された依存関係グループに要件を追加します。

These requirements will not be included in the published metadata for the project.これらの要件は、プロジェクトの公開メタデータには含まれません。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--index index--index index

The URLs to use when resolving dependencies, in addition to the default index.デフォルトのインデックスに加えて、依存関係を解決するために使用するURL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリまたは同じ形式でレイアウトされたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --default-index (which defaults to PyPI). When multiple --index flags are provided, earlier values take priority.このフラグで提供されるすべてのインデックスは、--default-index（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の--indexフラグが提供される場合、先に指定された値が優先されます。

Index names are not supported as values. Relative paths must be disambiguated from index names with ./ or ../ on Unix or .\\, ..\\, ./ or ../ on Windows.インデックス名は値としてサポートされていません。相対パスは、Unixでは./または../で、Windowsでは.\\、..\\、./または../でインデックス名と区別する必要があります。

May also be set with the UV_INDEX environment variable.UV_INDEX環境変数で設定することもできます。

--index-strategy index-strategy--index-strategy index-strategy

The strategy to use when resolving against multiple index URLs.複数のインデックスURLに対して解決する際に使用する戦略。

By default, uv will stop at the first index on which a given package is available, and limit resolutions to those present on that first index (first-index). This prevents "dependency confusion" attacks, whereby an attacker can upload a malicious package under the same name to an alternate index.デフォルトでは、uvは指定されたパッケージが利用可能な最初のインデックスで停止し、その最初のインデックスに存在するものに解決を制限します（first-index）。これにより、攻撃者が別のインデックスに同じ名前の悪意のあるパッケージをアップロードすることによる「依存関係の混乱」攻撃を防ぎます。

May also be set with the UV_INDEX_STRATEGY environment variable.UV_INDEX_STRATEGY環境変数で設定することもできます。

Possible values:可能な値：

first-index: Only use results from the first index that returns a match for a given package namefirst-index: 指定されたパッケージ名に一致する最初のインデックスからの結果のみを使用します。
unsafe-first-match: Search for every package name across all indexes, exhausting the versions from the first index before moving on to the nextunsafe-first-match: すべてのインデックスで各パッケージ名を検索し、次のインデックスに移動する前に最初のインデックスからのバージョンを使い果たします。
unsafe-best-match: Search for every package name across all indexes, preferring the "best" version found. If a package version is in multiple indexes, only look at the entry for the first indexunsafe-best-match: すべてのインデックスでパッケージ名を検索し、見つかった「最良」のバージョンを優先します。パッケージバージョンが複数のインデックスに存在する場合、最初のインデックスのエントリのみを確認します。

--index-url, -i index-url--index-url, -i index-url

(Deprecated: use --default-index instead) The URL of the Python package index (by default: https://pypi.org/simple).(非推奨: 代わりに --default-index を使用してください) PythonパッケージインデックスのURL（デフォルト: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --extra-index-url flag.このフラグで指定されたインデックスは、--extra-index-url フラグで指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_INDEX_URL environment variable.UV_INDEX_URL 環境変数を使用して設定することもできます。

--keyring-provider keyring-provider--keyring-provider keyring-provider

Attempt to use keyring for authentication for index URLs.keyring を使用してインデックスURLの認証を試みます。

At present, only --keyring-provider subprocess is supported, which configures uv to use the keyring CLI to handle authentication.現在、--keyring-provider subprocess のみがサポートされており、uvが認証を処理するために keyring CLI を使用するように構成します。

Defaults to disabled.デフォルトは disabled です。

May also be set with the UV_KEYRING_PROVIDER environment variable.環境変数 UV_KEYRING_PROVIDER でも設定できます。

Possible values:可能な値:

disabled: Do not use keyring for credential lookupdisabled: 認証情報の検索にキーチェーンを使用しない
subprocess: Use the keyring command for credential lookupsubprocess: 認証情報の検索に keyring コマンドを使用する

--link-mode link-mode--link-mode link-mode

The method to use when installing packages from the global cache.グローバルキャッシュからパッケージをインストールする際に使用する方法。

Defaults to clone (also known as Copy-on-Write) on macOS, and hardlink on Linux and Windows.macOSでは clone（コピーオンライトとも呼ばれる）がデフォルトで、LinuxおよびWindowsでは hardlink がデフォルトです。

WARNING: The use of symlink link mode is discouraged, as they create tight coupling between the cache and the target environment. For example, clearing the cache (uv cache clean) will break all installed packages by way of removing the underlying source files. Use symlinks with caution.警告: シンボリックリンクモードの使用は推奨されません。キャッシュとターゲット環境の間に強い結合を生じさせるためです。たとえば、キャッシュをクリアする (uv cache clean) と、基盤となるソースファイルが削除されることで、すべてのインストールされたパッケージが壊れます。シンボリックリンクは注意して使用してください。

May also be set with the UV_LINK_MODE environment variable.環境変数 UV_LINK_MODE でも設定できます。

Possible values:可能な値:

clone: Clone (i.e., copy-on-write) packages from the wheel into the site-packages directoryclone: ホイールからsite-packagesディレクトリにパッケージをクローン（コピーオンライト）します
copy: Copy packages from the wheel into the site-packages directorycopy: ホイールからsite-packagesディレクトリにパッケージをコピーします
hardlink: Hard link packages from the wheel into the site-packages directoryhardlink: ホイールからsite-packagesディレクトリにパッケージをハードリンクします
symlink: Symbolically link packages from the wheel into the site-packages directorysymlink: ホイールからsite-packagesディレクトリにパッケージをシンボリックリンクします

--locked--locked

Assert that the uv.lock will remain unchanged.uv.lockが変更されないことを保証します。

Requires that the lockfile is up-to-date. If the lockfile is missing or needs to be updated, uv will exit with an error.ロックファイルが最新である必要があります。ロックファイルが欠落しているか、更新が必要な場合、uvはエラーで終了します。

May also be set with the UV_LOCKED environment variable.UV_LOCKED環境変数でも設定できます。

--managed-python--managed-python

Require use of uv-managed Python versions.uv管理のPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理しているPythonバージョンを使用することを好みます。ただし、uvが管理しているPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.環境変数 UV_MANAGED_PYTHON でも設定できます。

--marker, -m marker--marker, -m marker

Apply this marker to all added packagesこのマーカーをすべての追加パッケージに適用します。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされた webpki-roots クレートから証明書を読み込みます。webpki-roots はMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、プラットフォームのネイティブ証明書ストアを使用したいことがあります。特に、システムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合です。

May also be set with the UV_NATIVE_TLS environment variable.環境変数 UV_NATIVE_TLS でも設定できます。

--no-binary--no-binary

Don't install pre-built wheels.プリビルドのホイールをインストールしないでください。

The given packages will be built and installed from source. The resolver will still use pre-built wheels to extract package metadata, if available.指定されたパッケージはソースからビルドされ、インストールされます。リゾルバーは、利用可能な場合、パッケージメタデータを抽出するためにプリビルドのホイールを使用します。

May also be set with the UV_NO_BINARY environment variable.UV_NO_BINARY 環境変数で設定することもできます。

--no-binary-package no-binary-package--no-binary-package no-binary-package

Don't install pre-built wheels for a specific package特定のパッケージに対してプリビルドのホイールをインストールしないでください。

May also be set with the UV_NO_BINARY_PACKAGE environment variable.UV_NO_BINARY_PACKAGE 環境変数で設定することもできます。

--no-build--no-build

Don't build source distributions.ソースディストリビューションをビルドしないでください。

When enabled, resolving will not run arbitrary Python code. The cached wheels of already-built source distributions will be reused, but operations that require building distributions will exit with an error.有効にすると、リゾルビングは任意のPythonコードを実行しません。既にビルドされたソースディストリビューションのキャッシュされたホイールが再利用されますが、ディストリビューションのビルドを必要とする操作はエラーで終了します。

May also be set with the UV_NO_BUILD environment variable.UV_NO_BUILD 環境変数で設定することもできます。

--no-build-isolation--no-build-isolation

Disable isolation when building source distributions.ソース配布物をビルドする際に隔離を無効にします。

Assumes that build dependencies specified by PEP 518 are already installed.PEP 518で指定されたビルド依存関係がすでにインストールされていると仮定します。

May also be set with the UV_NO_BUILD_ISOLATION environment variable.UV_NO_BUILD_ISOLATION 環境変数でも設定できます。

--no-build-isolation-package no-build-isolation-package--no-build-isolation-package no-build-isolation-package

Disable isolation when building source distributions for a specific package.特定のパッケージのソース配布物をビルドする際に隔離を無効にします。

Assumes that the packages' build dependencies specified by PEP 518 are already installed.そのパッケージのビルド依存関係がPEP 518で指定されていると仮定します。

--no-build-package no-build-package--no-build-package no-build-package

Don't build source distributions for a specific package特定のパッケージのソース配布物をビルドしません。

May also be set with the UV_NO_BUILD_PACKAGE environment variable.UV_NO_BUILD_PACKAGE 環境変数でも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.UV_NO_CACHE 環境変数でも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml, uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.UV_NO_CONFIG 環境変数でも設定できます。

--no-index--no-index

Ignore the registry index (e.g., PyPI), instead relying on direct URL dependencies and those provided via --find-linksレジストリインデックス（例：PyPI）を無視し、直接URL依存関係および--find-linksを介して提供されるものに依存します。

--no-install-local--no-install-local

Do not install local path dependenciesローカルパス依存関係をインストールしない

Skips the current project, workspace members, and any other local (path or editable) packages. Only remote/indexed dependencies are installed. Useful in Docker builds to cache heavy third-party dependencies first and layer local packages separately.現在のプロジェクト、ワークスペースメンバー、およびその他のローカル（パスまたは編集可能）パッケージをスキップします。リモート/インデックスされた依存関係のみがインストールされます。Dockerビルドで重いサードパーティ依存関係を最初にキャッシュし、ローカルパッケージを別にレイヤー化するのに便利です。

The inverse --only-install-local can be used to install only local packages, excluding all remote dependencies.逆の--only-install-localを使用すると、すべてのリモート依存関係を除外してのみローカルパッケージをインストールできます。

--no-install-package no-install-package--no-install-package no-install-package

Do not install the given package(s).指定されたパッケージをインストールしない。

By default, all project's dependencies are installed into the environment. The --no-install-package option allows exclusion of specific packages. Note this can result in a broken environment, and should be used with caution.デフォルトでは、すべてのプロジェクトの依存関係が環境にインストールされます。--no-install-packageオプションを使用すると、特定のパッケージを除外できます。これにより環境が壊れる可能性があるため、注意して使用する必要があります。

The inverse --only-install-package can be used to install only the specified packages, excluding all others.逆の--only-install-packageを使用すると、他のすべてを除外してのみ指定されたパッケージをインストールできます。

--no-install-project--no-install-project

Do not install the current project.現在のプロジェクトをインストールしない。

By default, the current project is installed into the environment with all of its dependencies. The --no-install-project option allows the project to be excluded, but all of its dependencies are still installed. This is particularly useful in situations like building Docker images where installing the project separately from its dependencies allows optimal layer caching.デフォルトでは、現在のプロジェクトはそのすべての依存関係とともに環境にインストールされます。--no-install-projectオプションを使用すると、プロジェクトを除外できますが、そのすべての依存関係はまだインストールされます。これは、プロジェクトを依存関係とは別にインストールすることで最適なレイヤーキャッシングを可能にするDockerイメージのビルドなどの状況で特に便利です。

The inverse --only-install-project can be used to install only the project itself, excluding all dependencies.逆の --only-install-project は、すべての依存関係を除外して、プロジェクト自体のみ をインストールするために使用できます。

--no-install-workspace--no-install-workspace

Do not install any workspace members, including the current project.現在のプロジェクトを含む、ワークスペースメンバーをインストールしません。

By default, all workspace members and their dependencies are installed into the environment. The --no-install-workspace option allows exclusion of all the workspace members while retaining their dependencies. This is particularly useful in situations like building Docker images where installing the workspace separately from its dependencies allows optimal layer caching.デフォルトでは、すべてのワークスペースメンバーとその依存関係が環境にインストールされます。 --no-install-workspace オプションを使用すると、依存関係を保持しながらすべてのワークスペースメンバーを除外できます。これは、依存関係とは別にワークスペースをインストールすることで最適なレイヤーキャッシングを可能にするDockerイメージのビルドなどの状況で特に便利です。

The inverse --only-install-workspace can be used to install only workspace members, excluding all other dependencies.逆の --only-install-workspace は、すべての他の依存関係を除外して、ワークスペースメンバーのみ をインストールするために使用できます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON 環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS 環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--no-sources--no-sources

Ignore the tool.uv.sources table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any workspace, Git, URL, or local path sources依存関係を解決する際に tool.uv.sources テーブルを無視します。これは、ワークスペース、Git、URL、またはローカルパスソースを使用するのではなく、標準準拠の公開可能なパッケージメタデータに対してロックするために使用されます。

May also be set with the UV_NO_SOURCES environment variable.UV_NO_SOURCES 環境変数で設定することもできます。

--no-sync--no-sync

Avoid syncing the virtual environment仮想環境の同期を避けます。

May also be set with the UV_NO_SYNC environment variable.環境変数 UV_NO_SYNC でも設定できます。

--no-workspace--no-workspace

Don't add the dependency as a workspace member.依存関係をワークスペースメンバーとして追加しません。

By default, when adding a dependency that's a local path and is within the workspace directory, uv will add it as a workspace member; pass --no-workspace to add the package as direct path dependency instead.デフォルトでは、ローカルパスの依存関係を追加する際、ワークスペースディレクトリ内にある場合、uvはそれをワークスペースメンバーとして追加します。--no-workspace を渡すことで、パッケージを直接パス依存関係として追加できます。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.環境変数 UV_OFFLINE でも設定できます。

--optional optional--optional optional

Add the requirements to the package's optional dependencies for the specified extra.指定されたエクストラのパッケージのオプショナル依存関係に要件を追加します。

The group may then be activated when installing the project with the --extra flag.グループは、--extra フラグを使用してプロジェクトをインストールする際にアクティブ化される場合があります。

To enable an optional extra for this requirement instead, see --extra.この要件のオプションの追加機能を有効にするには、--extra を参照してください。

--package package--package パッケージ

Add the dependency to a specific package in the workspaceワークスペース内の特定のパッケージに依存関係を追加します。

--prerelease prerelease--prerelease プレリリース

The strategy to use when considering pre-release versions.プレリリースバージョンを考慮する際に使用する戦略。

By default, uv will accept pre-releases for packages that only publish pre-releases, along with first-party requirements that contain an explicit pre-release marker in the declared specifiers (if-necessary-or-explicit).デフォルトでは、uvはプレリリースのみを公開するパッケージと、宣言された指定子に明示的なプレリリースマーカーを含むファーストパーティの要件に対してプレリリースを受け入れます (if-necessary-or-explicit)。

May also be set with the UV_PRERELEASE environment variable.UV_PRERELEASE 環境変数を使用して設定することもできます。

Possible values:可能な値：

disallow: Disallow all pre-release versionsdisallow: すべてのプレリリースバージョンを禁止します。
allow: Allow all pre-release versionsallow: すべてのプレリリースバージョンを許可します
if-necessary: Allow pre-release versions if all versions of a package are pre-releaseif-necessary: すべてのバージョンがプレリリースである場合にプレリリースバージョンを許可します
explicit: Allow pre-release versions for first-party packages with explicit pre-release markers in their version requirementsexplicit: バージョン要件に明示的なプレリリースマーカーがあるファーストパーティパッケージに対してプレリリースバージョンを許可します
if-necessary-or-explicit: Allow pre-release versions if all versions of a package are pre-release, or if the package has an explicit pre-release marker in its version requirementsif-necessary-or-explicit: すべてのバージョンがプレリリースである場合、またはパッケージにバージョン要件に明示的なプレリリースマーカーがある場合にプレリリースバージョンを許可します

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.また、UV_PROJECT 環境変数で設定することもできます。

--python, -p python--python, -p python

The Python interpreter to use for resolving and syncing.解決および同期に使用する Python インタプリタ。

See uv python for details on Python discovery and supported request formats.Python の発見およびサポートされているリクエスト形式の詳細については、uv python を参照してください。

May also be set with the UV_PYTHON environment variable.また、UV_PYTHON 環境変数で設定することもできます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uv が stdout に出力を行わないサイレントモードを有効にします。

--raw, --raw-sources--raw, --raw-sources

Add a dependency as provided.提供された依存関係を追加します。

By default, uv will use the tool.uv.sources section to record source information for Git, local, editable, and direct URL requirements. When --raw is provided, uv will add source requirements to project.dependencies, rather than tool.uv.sources.デフォルトでは、uvはtool.uv.sourcesセクションを使用して、Git、ローカル、編集可能、直接URLの要件に関するソース情報を記録します。--rawが提供されると、uvはtool.uv.sourcesではなく、project.dependenciesにソース要件を追加します。

Additionally, by default, uv will add bounds to your dependency, e.g., foo>=1.0.0. When --raw is provided, uv will add the dependency without bounds.さらに、デフォルトでは、uvは依存関係に境界を追加します。例えば、foo>=1.0.0。--rawが提供されると、uvは境界なしで依存関係を追加します。

--refresh--refresh

Refresh all cached dataすべてのキャッシュデータを更新します

--refresh-package refresh-package--refresh-package refresh-package

Refresh cached data for a specific package特定のパッケージのキャッシュデータを更新します

--reinstall, --force-reinstall--reinstall, --force-reinstall

Reinstall all packages, regardless of whether they're already installed. Implies --refreshすべてのパッケージを再インストールします。すでにインストールされているかどうかに関係ありません。--refreshを含意します。

--reinstall-package reinstall-package--reinstall-package reinstall-package

Reinstall a specific package, regardless of whether it's already installed. Implies --refresh-package特定のパッケージを再インストールします。すでにインストールされているかどうかに関係ありません。--refresh-packageを含意します。

--requirements, --requirement, -r requirements--requirements, --requirement, -r requirements

Add the packages listed in the given files.指定されたファイルにリストされているパッケージを追加します。

The following formats are supported: requirements.txt, .py files with inline metadata, pylock.toml, pyproject.toml, setup.py, and setup.cfg.サポートされているフォーマットは次のとおりです: requirements.txt, .py ファイルのインラインメタデータ, pylock.toml, pyproject.toml, setup.py, および setup.cfg。

--resolution resolution--resolution resolution

The strategy to use when selecting between the different compatible versions for a given package requirement.特定のパッケージ要件に対して異なる互換バージョンを選択する際に使用する戦略。

By default, uv will use the latest compatible version of each package (highest).デフォルトでは、uvは各パッケージの最新の互換バージョンを使用します (highest)。

May also be set with the UV_RESOLUTION environment variable.また、UV_RESOLUTION 環境変数で設定することもできます。

Possible values:可能な値:

highest: Resolve the highest compatible version of each packagehighest: 各パッケージの最高の互換バージョンを解決します
lowest: Resolve the lowest compatible version of each packagelowest: 各パッケージの最低の互換バージョンを解決します
lowest-direct: Resolve the lowest compatible version of any direct dependencies, and the highest compatible version of any transitive dependencieslowest-direct: 直接依存関係の中で最も互換性のあるバージョンを解決し、間接依存関係の中で最も高い互換性のあるバージョンを解決します。

--rev rev--rev rev

Commit to use when adding a dependency from GitGitから依存関係を追加する際に使用するコミット。

--script script--script script

Add the dependency to the specified Python script, rather than to a project.依存関係をプロジェクトではなく、指定されたPythonスクリプトに追加します。

If provided, uv will add the dependency to the script's inline metadata table, in adherence with PEP 723. If no such inline metadata table is present, a new one will be created and added to the script. When executed via uv run, uv will create a temporary environment for the script with all inline dependencies installed.提供された場合、uvはPEP 723に従ってスクリプトのインラインメタデータテーブルに依存関係を追加します。そのようなインラインメタデータテーブルが存在しない場合は、新しいものが作成され、スクリプトに追加されます。uv runを介して実行されると、uvはすべてのインライン依存関係がインストールされたスクリプト用の一時環境を作成します。

--tag tag--tag tag

Tag to use when adding a dependency from GitGitから依存関係を追加する際に使用するタグ。

--upgrade, -U--upgrade, -U

Allow package upgrades, ignoring pinned versions in any existing output file. Implies --refreshパッケージのアップグレードを許可し、既存の出力ファイルに固定されたバージョンを無視します。--refreshを暗示します。

--upgrade-package, -P upgrade-package--upgrade-package, -P upgrade-package

Allow upgrades for a specific package, ignoring pinned versions in any existing output file. Implies --refresh-package特定のパッケージのアップグレードを許可し、既存の出力ファイルの固定バージョンを無視します。--refresh-packageを暗示します。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)細かいログ記録は、RUST_LOG 環境変数を使用して設定できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

--workspace--workspace

Add the dependency as a workspace member.依存関係をワークスペースメンバーとして追加します。

By default, uv will add path dependencies that are within the workspace directory as workspace members. When used with a path dependency, the package will be added to the workspace's members list in the root pyproject.toml file.デフォルトでは、uvはワークスペースディレクトリ内のパス依存関係をワークスペースメンバーとして追加します。パス依存関係と共に使用されると、パッケージはルートのpyproject.tomlファイルのワークスペースのmembersリストに追加されます。

uv removeuv remove

Remove dependencies from the project.プロジェクトから依存関係を削除します。

Dependencies are removed from the project's pyproject.toml file.依存関係はプロジェクトの pyproject.toml ファイルから削除されます。

If multiple entries exist for a given dependency, i.e., each with different markers, all of the entries will be removed.特定の依存関係に対して複数のエントリが存在する場合、すなわちそれぞれ異なるマーカーを持つ場合、すべてのエントリが削除されます。

The lockfile and project environment will be updated to reflect the removed dependencies. To skip updating the lockfile, use --frozen. To skip updating the environment, use --no-sync.ロックファイルとプロジェクト環境は削除された依存関係を反映するように更新されます。ロックファイルの更新をスキップするには --frozen を使用します。環境の更新をスキップするには --no-sync を使用します。

If any of the requested dependencies are not present in the project, uv will exit with an error.要求された依存関係のいずれかがプロジェクトに存在しない場合、uvはエラーで終了します。

If a package has been manually installed in the environment, i.e., with uv pip install, it will not be removed by uv remove.環境に手動でインストールされたパッケージ、すなわち uv pip install を使用してインストールされた場合、uv remove では削除されません。

uv will search for a project in the current directory or any parent directory. If a project cannot be found, uv will exit with an error.uvは現在のディレクトリまたは任意の親ディレクトリでプロジェクトを検索します。プロジェクトが見つからない場合、uvはエラーで終了します。

Usage使用法

uv remove [OPTIONS] <PACKAGES>...

Arguments引数

PACKAGESPACKAGES: The names of the dependencies to remove (e.g., ruff)削除する依存関係の名前（例： ruff）

Optionsオプション

--active--active

Prefer the active virtual environment over the project's virtual environment.プロジェクトの仮想環境よりもアクティブな仮想環境を優先します。

If the project virtual environment is active or no virtual environment is active, this has no effect.プロジェクトの仮想環境がアクティブであるか、仮想環境がアクティブでない場合、これは効果がありません。

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回提供できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告: このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.デフォルトは $XDG_CACHE_HOME/uv または $HOME/.cache/uv（macOSおよびLinuxの場合）、および %LOCALAPPDATA%\uv\cache（Windowsの場合）です。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR 環境変数を使用して設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末への書き込み時に自動的に色のサポートを検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力が色のサポートを持つ端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 環境に関係なくカラー出力を有効にします
never: Disables colored outputnever: カラー出力を無効にします

--compile-bytecode, --compile--compile-bytecode, --compile

Compile Python files to bytecode after installation.インストール後にPythonファイルをバイトコードにコンパイルします。

By default, uv does not compile Python (.py) files to bytecode (__pycache__/*.pyc); instead, compilation is performed lazily the first time a module is imported. For use-cases in which start time is critical, such as CLI applications and Docker containers, this option can be enabled to trade longer installation times for faster start times.デフォルトでは、uvはPython（.py）ファイルをバイトコード（__pycache__/*.pyc）にコンパイルしません。代わりに、モジュールが初めてインポートされるときに遅延コンパイルが行われます。CLIアプリケーションやDockerコンテナなど、起動時間が重要なユースケースでは、このオプションを有効にすることで、長いインストール時間と引き換えに速い起動時間を得ることができます。

When enabled, uv will process the entire site-packages directory (including packages that are not being modified by the current operation) for consistency. Like pip, it will also ignore errors.有効にすると、uvは整合性のためにサイトパッケージディレクトリ全体（現在の操作によって変更されていないパッケージを含む）を処理します。pipのように、エラーも無視します。

May also be set with the UV_COMPILE_BYTECODE environment variable.UV_COMPILE_BYTECODE環境変数でも設定できます。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用するuv.tomlファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.また、UV_CONFIG_FILE 環境変数で設定することもできます。

--config-setting, --config-settings, -C config-setting--config-setting, --config-settings, -C config-setting

Settings to pass to the PEP 517 build backend, specified as KEY=VALUE pairsPEP 517 ビルドバックエンドに渡す設定で、KEY=VALUE ペアとして指定します。

--config-settings-package, --config-settings-package config-settings-package--config-settings-package, --config-settings-package config-settings-package

Settings to pass to the PEP 517 build backend for a specific package, specified as PACKAGE:KEY=VALUE pairs特定のパッケージに対して PEP 517 ビルドバックエンドに渡す設定で、PACKAGE:KEY=VALUE ペアとして指定します。

--default-index default-index--default-index default-index

The URL of the default package index (by default: https://pypi.org/simple).デフォルトのパッケージインデックスの URL（デフォルト: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリ API）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --index flag.このフラグで指定されたインデックスは、--index フラグで指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_DEFAULT_INDEX environment variable.また、UV_DEFAULT_INDEX 環境変数で設定することもできます。

--dev--dev

Remove the packages from the development dependency group.開発依存関係グループからパッケージを削除します。

This option is an alias for --group dev.このオプションは --group dev のエイリアスです。

May also be set with the UV_DEV environment variable.UV_DEV 環境変数で設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--project を参照してプロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY 環境変数で設定することもできます。

--exclude-newer exclude-newer--exclude-newer exclude-newer

Limit candidate packages to those that were uploaded prior to the given date.候補パッケージを指定された日付以前にアップロードされたものに制限します。

Accepts both RFC 3339 timestamps (e.g., 2006-12-02T02:07:43Z) and local dates in the same format (e.g., 2006-12-02) in your system's configured time zone.RFC 3339 タイムスタンプ（例：2006-12-02T02:07:43Z）と、システムの設定されたタイムゾーンでの同じ形式のローカル日付（例：2006-12-02）の両方を受け入れます。

May also be set with the UV_EXCLUDE_NEWER environment variable.UV_EXCLUDE_NEWER 環境変数で設定することもできます。

--exclude-newer-package exclude-newer-package--exclude-newer-package exclude-newer-package

Limit candidate packages for specific packages to those that were uploaded prior to the given date.特定のパッケージの候補パッケージを指定された日付以前にアップロードされたものに制限します。

Accepts package-date pairs in the format PACKAGE=DATE, where DATE is an RFC 3339 timestamp (e.g., 2006-12-02T02:07:43Z) or local date (e.g., 2006-12-02) in your system's configured time zone.パッケージ-日付ペアを PACKAGE=DATE の形式で受け入れます。ここで DATE は RFC 3339 タイムスタンプ（例：2006-12-02T02:07:43Z）またはローカル日付（例：2006-12-02）で、システムの設定されたタイムゾーンに基づきます。

Can be provided multiple times for different packages.異なるパッケージのために複数回提供することができます。

--extra-index-url extra-index-url--extra-index-url extra-index-url

(Deprecated: use --index instead) Extra URLs of package indexes to use, in addition to --index-url.(非推奨：代わりに --index を使用してください) --index-url に加えて使用するパッケージインデックスの追加URL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式で配置されたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --index-url (which defaults to PyPI). When multiple --extra-index-url flags are provided, earlier values take priority.このフラグで提供されるすべてのインデックスは、--index-url（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の--extra-index-urlフラグが提供される場合、先に指定された値が優先されます。

May also be set with the UV_EXTRA_INDEX_URL environment variable.UV_EXTRA_INDEX_URL環境変数を使用して設定することもできます。

--find-links, -f find-links--find-links, -f find-links

Locations to search for candidate distributions, in addition to those found in the registry indexes.レジストリインデックスで見つかったものに加えて、候補となる配布物を検索する場所。

If a path, the target must be a directory that contains packages as wheel files (.whl) or source distributions (e.g., .tar.gz or .zip) at the top level.パスの場合、ターゲットはトップレベルにホイールファイル（.whl）またはソース配布（例：.tar.gzまたは.zip）を含むディレクトリでなければなりません。

If a URL, the page must contain a flat list of links to package files adhering to the formats described above.URLの場合、そのページは上記の形式に従ったパッケージファイルへのリンクのフラットリストを含む必要があります。

May also be set with the UV_FIND_LINKS environment variable.UV_FIND_LINKS環境変数を使用して設定することもできます。

--fork-strategy fork-strategy--fork-strategy fork-strategy

The strategy to use when selecting multiple versions of a given package across Python versions and platforms.特定のパッケージの複数のバージョンをPythonのバージョンやプラットフォームにわたって選択する際に使用する戦略。

By default, uv will optimize for selecting the latest version of each package for each supported Python version (requires-python), while minimizing the number of selected versions across platforms.デフォルトでは、uvは各サポートされているPythonバージョン（requires-python）に対して各パッケージの最新バージョンを選択することを最適化し、プラットフォーム間で選択されるバージョンの数を最小限に抑えます。

Under fewest, uv will minimize the number of selected versions for each package, preferring older versions that are compatible with a wider range of supported Python versions or platforms.fewestの下で、uvは各パッケージの選択されたバージョンの数を最小限に抑え、より広範囲のサポートされているPythonバージョンやプラットフォームと互換性のある古いバージョンを優先します。

May also be set with the UV_FORK_STRATEGY environment variable.UV_FORK_STRATEGY環境変数を使用して設定することもできます。

Possible values:可能な値：

fewest: Optimize for selecting the fewest number of versions for each package. Older versions may be preferred if they are compatible with a wider range of supported Python versions or platformsfewest: 各パッケージのバージョン数を最小限に抑えるよう最適化します。より広範囲のサポートされているPythonバージョンやプラットフォームと互換性がある場合、古いバージョンが優先されることがあります。
requires-python: Optimize for selecting latest supported version of each package, for each supported Python versionrequires-python: 各サポートされているPythonバージョンに対して、各パッケージの最新のサポートバージョンを選択するよう最適化します。

--frozen--frozen

Remove dependencies without re-locking the project.プロジェクトの依存関係を再ロックせずに削除します。

The project environment will not be synced.プロジェクト環境は同期されません。

May also be set with the UV_FROZEN environment variable.UV_FROZEN環境変数を使用して設定することもできます。

--group group--group group

Remove the packages from the specified dependency group指定された依存関係グループからパッケージを削除します

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します

--index index--index index

The URLs to use when resolving dependencies, in addition to the default index.デフォルトのインデックスに加えて、依存関係を解決する際に使用するURL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式で配置されたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --default-index (which defaults to PyPI). When multiple --index flags are provided, earlier values take priority.このフラグを介して提供されたすべてのインデックスは、--default-index（デフォルトはPyPI）によって指定されたインデックスよりも優先されます。複数の--indexフラグが提供される場合、先に指定された値が優先されます。

Index names are not supported as values. Relative paths must be disambiguated from index names with ./ or ../ on Unix or .\\, ..\\, ./ or ../ on Windows.インデックス名は値としてサポートされていません。相対パスは、Unixでは./または../、Windowsでは.\\、..\\、./または../を使用してインデックス名と区別する必要があります。

May also be set with the UV_INDEX environment variable.UV_INDEX環境変数を使用して設定することもできます。

--index-strategy index-strategy--index-strategy index-strategy

The strategy to use when resolving against multiple index URLs.複数のインデックスURLに対して解決する際に使用する戦略。

By default, uv will stop at the first index on which a given package is available, and limit resolutions to those present on that first index (first-index). This prevents "dependency confusion" attacks, whereby an attacker can upload a malicious package under the same name to an alternate index.デフォルトでは、uvは指定されたパッケージが利用可能な最初のインデックスで停止し、その最初のインデックス（first-index）に存在するものに解決を制限します。これにより、攻撃者が別のインデックスに同じ名前の悪意のあるパッケージをアップロードすることによる「依存関係の混乱」攻撃を防ぎます。

May also be set with the UV_INDEX_STRATEGY environment variable.UV_INDEX_STRATEGY 環境変数で設定することもできます。

Possible values:可能な値：

first-index: Only use results from the first index that returns a match for a given package namefirst-index: 指定されたパッケージ名に対して一致を返す最初のインデックスからの結果のみを使用します。
unsafe-first-match: Search for every package name across all indexes, exhausting the versions from the first index before moving on to the nextunsafe-first-match: すべてのインデックスで各パッケージ名を検索し、次のインデックスに移る前に最初のインデックスからのバージョンを使い果たします。
unsafe-best-match: Search for every package name across all indexes, preferring the "best" version found. If a package version is in multiple indexes, only look at the entry for the first indexunsafe-best-match: すべてのインデックスで各パッケージ名を検索し、見つかった「最良」のバージョンを優先します。パッケージバージョンが複数のインデックスに存在する場合、最初のインデックスのエントリのみを確認します。

--index-url, -i index-url--index-url, -i index-url

(Deprecated: use --default-index instead) The URL of the Python package index (by default: https://pypi.org/simple).(非推奨: 代わりに --default-index を使用してください) PythonパッケージインデックスのURL（デフォルト: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリまたは同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --extra-index-url flag.このフラグによって指定されたインデックスは、--extra-index-urlフラグを介して指定された他のすべてのインデックスよりも低い優先度が与えられます。

May also be set with the UV_INDEX_URL environment variable.UV_INDEX_URL環境変数を使用して設定することもできます。

--keyring-provider keyring-provider--keyring-provider keyring-provider

Attempt to use keyring for authentication for index URLs.インデックスURLの認証にkeyringを使用しようとします。

At present, only --keyring-provider subprocess is supported, which configures uv to use the keyring CLI to handle authentication.現在のところ、--keyring-provider subprocessのみがサポートされており、これはuvが認証を処理するためにkeyring CLIを使用するように構成します。

Defaults to disabled.デフォルトはdisabledです。

May also be set with the UV_KEYRING_PROVIDER environment variable.UV_KEYRING_PROVIDER環境変数を使用して設定することもできます。

Possible values:可能な値：

disabled: Do not use keyring for credential lookupdisabled: 認証情報の検索にkeyringを使用しない
subprocess: Use the keyring command for credential lookupsubprocess: 認証情報の検索にkeyringコマンドを使用する

--link-mode link-mode--link-mode リンクモード

The method to use when installing packages from the global cache.グローバルキャッシュからパッケージをインストールする際に使用する方法。

Defaults to clone (also known as Copy-on-Write) on macOS, and hardlink on Linux and Windows.macOSではclone（コピーオンライトとも呼ばれる）にデフォルト設定されており、LinuxおよびWindowsではhardlinkにデフォルト設定されています。

WARNING: The use of symlink link mode is discouraged, as they create tight coupling between the cache and the target environment. For example, clearing the cache (uv cache clean) will break all installed packages by way of removing the underlying source files. Use symlinks with caution.警告: シンボリックリンクモードの使用は推奨されません。これはキャッシュとターゲット環境の間に強い結合を生じさせるためです。例えば、キャッシュをクリアする（uv cache clean）と、基盤となるソースファイルが削除されることで、すべてのインストールされたパッケージが壊れます。シンボリックリンクは注意して使用してください。

May also be set with the UV_LINK_MODE environment variable.UV_LINK_MODE 環境変数でも設定できます。

Possible values:可能な値:

clone: Clone (i.e., copy-on-write) packages from the wheel into the site-packages directoryclone: ホイールからsite-packagesディレクトリにパッケージをクローン（すなわち、コピーオンライト）します。
copy: Copy packages from the wheel into the site-packages directorycopy: ホイールからsite-packagesディレクトリにパッケージをコピーします。
hardlink: Hard link packages from the wheel into the site-packages directoryhardlink: ホイールからsite-packagesディレクトリにパッケージをハードリンクします。
symlink: Symbolically link packages from the wheel into the site-packages directorysymlink: ホイールからsite-packagesディレクトリにパッケージをシンボリックリンクします。

--locked--locked

Assert that the uv.lock will remain unchanged.uv.lockが変更されないことを確認します。

Requires that the lockfile is up-to-date. If the lockfile is missing or needs to be updated, uv will exit with an error.ロックファイルが最新である必要があります。ロックファイルが欠落しているか、更新が必要な場合、uvはエラーで終了します。

May also be set with the UV_LOCKED environment variable.UV_LOCKED環境変数で設定することもできます。

--managed-python--managed-python

Require use of uv-managed Python versions.uv管理のPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンの使用を優先します。ただし、uv管理のPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数で設定することもできます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、プラットフォームのネイティブ証明書ストアを使用したいことがあります。特に、システムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合です。

May also be set with the UV_NATIVE_TLS environment variable.UV_NATIVE_TLS環境変数で設定することもできます。

--no-binary--no-binary

Don't install pre-built wheels.事前にビルドされたホイールをインストールしません。

The given packages will be built and installed from source. The resolver will still use pre-built wheels to extract package metadata, if available.指定されたパッケージはソースからビルドされ、インストールされます。リゾルバは、利用可能な場合、パッケージメタデータを抽出するために事前にビルドされたホイールを使用します。

May also be set with the UV_NO_BINARY environment variable.UV_NO_BINARY環境変数で設定することもできます。

--no-binary-package no-binary-package--no-binary-package no-binary-package

Don't install pre-built wheels for a specific package特定のパッケージに対して事前にビルドされたホイールをインストールしません。

May also be set with the UV_NO_BINARY_PACKAGE environment variable.UV_NO_BINARY_PACKAGE環境変数で設定することもできます。

--no-build--no-build

Don't build source distributions.ソース配布物のビルドを行いません。

When enabled, resolving will not run arbitrary Python code. The cached wheels of already-built source distributions will be reused, but operations that require building distributions will exit with an error.有効にすると、解決時に任意のPythonコードは実行されません。すでにビルドされたソース配布物のキャッシュされたホイールが再利用されますが、配布物のビルドを必要とする操作はエラーで終了します。

May also be set with the UV_NO_BUILD environment variable.UV_NO_BUILD 環境変数でも設定できます。

--no-build-isolation--no-build-isolation

Disable isolation when building source distributions.ソース配布物のビルド時に隔離を無効にします。

Assumes that build dependencies specified by PEP 518 are already installed.PEP 518で指定されたビルド依存関係がすでにインストールされていると仮定します。

May also be set with the UV_NO_BUILD_ISOLATION environment variable.UV_NO_BUILD_ISOLATION 環境変数でも設定できます。

--no-build-isolation-package no-build-isolation-package--no-build-isolation-package no-build-isolation-package

Disable isolation when building source distributions for a specific package.特定のパッケージのソース配布物をビルドする際に隔離を無効にします。

Assumes that the packages' build dependencies specified by PEP 518 are already installed.PEP 518で指定されたパッケージのビルド依存関係がすでにインストールされていることを前提とします。

--no-build-package no-build-package--no-build-package no-build-package

Don't build source distributions for a specific package特定のパッケージのソース配布物をビルドしない

May also be set with the UV_NO_BUILD_PACKAGE environment variable.UV_NO_BUILD_PACKAGE 環境変数でも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.UV_NO_CACHE 環境変数でも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml, uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.環境変数 UV_NO_CONFIG でも設定できます。

--no-index--no-index

Ignore the registry index (e.g., PyPI), instead relying on direct URL dependencies and those provided via --find-linksレジストリインデックス（例：PyPI）を無視し、代わりに直接URL依存関係および --find-links を介して提供されるものに依存します。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.その代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.環境変数 UV_NO_MANAGED_PYTHON でも設定できます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなど。

May also be set with the UV_NO_PROGRESS environment variable.環境変数 UV_NO_PROGRESS でも設定できます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--no-sources--no-sources

Ignore the tool.uv.sources table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any workspace, Git, URL, or local path sources依存関係を解決する際に tool.uv.sources テーブルを無視します。これは、ワークスペース、Git、URL、またはローカルパスソースを使用するのではなく、標準準拠の公開可能なパッケージメタデータに対してロックするために使用されます。

May also be set with the UV_NO_SOURCES environment variable.環境変数 UV_NO_SOURCES でも設定できます。

--no-sync--no-sync

Avoid syncing the virtual environment after re-locking the projectプロジェクトの再ロック後に仮想環境の同期を避けます。

May also be set with the UV_NO_SYNC environment variable.環境変数 UV_NO_SYNC でも設定できます。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数を使用して設定することもできます。

--optional optional--optional オプショナル

Remove the packages from the project's optional dependencies for the specified extra指定された追加のためにプロジェクトのオプショナル依存関係からパッケージを削除します。

--package package--package パッケージ

Remove the dependencies from a specific package in the workspaceワークスペース内の特定のパッケージから依存関係を削除します。

--prerelease prerelease--prerelease プレリリース

The strategy to use when considering pre-release versions.プレリリースバージョンを考慮する際に使用する戦略。

By default, uv will accept pre-releases for packages that only publish pre-releases, along with first-party requirements that contain an explicit pre-release marker in the declared specifiers (if-necessary-or-explicit).デフォルトでは、uvはプレリリースのみを公開するパッケージと、宣言された指定子に明示的なプレリリースマーカーを含むファーストパーティの要件に対してプレリリースを受け入れます (if-necessary-or-explicit)。

May also be set with the UV_PRERELEASE environment variable.また、UV_PRERELEASE 環境変数で設定することもできます。

Possible values:可能な値：

disallow: Disallow all pre-release versionsdisallow: すべてのプレリリースバージョンを禁止する
allow: Allow all pre-release versionsallow: すべてのプレリリースバージョンを許可する
if-necessary: Allow pre-release versions if all versions of a package are pre-releaseif-necessary: すべてのバージョンがプレリリースである場合にプレリリースバージョンを許可する
explicit: Allow pre-release versions for first-party packages with explicit pre-release markers in their version requirementsexplicit: バージョン要件に明示的なプレリリースマーカーがあるファーストパーティパッケージに対してプレリリースバージョンを許可する
if-necessary-or-explicit: Allow pre-release versions if all versions of a package are pre-release, or if the package has an explicit pre-release marker in its version requirementsif-necessary-or-explicit: すべてのバージョンがプレリリースである場合、またはパッケージにバージョン要件に明示的なプレリリースマーカーがある場合にプレリリースバージョンを許可する

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見され、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.--directoryを参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pipインターフェースで使用されると効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT環境変数で設定することもできます。

--python, -p python--python, -p python

The Python interpreter to use for resolving and syncing.解決および同期に使用するPythonインタプリタ。

See uv python for details on Python discovery and supported request formats.Pythonの発見とサポートされているリクエスト形式の詳細については、uv pythonを参照してください。

May also be set with the UV_PYTHON environment variable.UV_PYTHON環境変数で設定することもできます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uvは標準出力に何も出力しないサイレントモードを有効にします。

--refresh--refresh

Refresh all cached dataすべてのキャッシュデータを更新します

--refresh-package refresh-package--refresh-package refresh-package

Refresh cached data for a specific package特定のパッケージのキャッシュデータを更新します

--reinstall, --force-reinstall--reinstall, --force-reinstall

Reinstall all packages, regardless of whether they're already installed. Implies --refreshすべてのパッケージを再インストールします。すでにインストールされているかどうかに関わらず。--refreshを含意します。

--reinstall-package reinstall-package--reinstall-package reinstall-package

Reinstall a specific package, regardless of whether it's already installed. Implies --refresh-package特定のパッケージを再インストールします。すでにインストールされているかどうかに関わらず。--refresh-packageを含意します。

--resolution resolution--resolution resolution

The strategy to use when selecting between the different compatible versions for a given package requirement.特定のパッケージ要件に対して異なる互換バージョンを選択する際に使用する戦略。

By default, uv will use the latest compatible version of each package (highest).デフォルトでは、uvは各パッケージの最新の互換バージョンを使用します（highest）。

May also be set with the UV_RESOLUTION environment variable.UV_RESOLUTION 環境変数で設定することもできます。

Possible values:可能な値：

highest: Resolve the highest compatible version of each packagehighest: 各パッケージの最高の互換バージョンを解決します
lowest: Resolve the lowest compatible version of each packagelowest: 各パッケージの最低の互換バージョンを解決します
lowest-direct: Resolve the lowest compatible version of any direct dependencies, and the highest compatible version of any transitive dependencieslowest-direct: 直接依存関係の最低の互換バージョンを解決し、間接依存関係の最高の互換バージョンを解決します

--script script--script script

Remove the dependency from the specified Python script, rather than from a project.プロジェクトからではなく、指定されたPythonスクリプトから依存関係を削除します。

If provided, uv will remove the dependency from the script's inline metadata table, in adherence with PEP 723.提供された場合、uvはPEP 723に従ってスクリプトのインラインメタデータテーブルから依存関係を削除します。

--upgrade, -U--upgrade, -U

Allow package upgrades, ignoring pinned versions in any existing output file. Implies --refreshパッケージのアップグレードを許可し、既存の出力ファイルに固定されたバージョンを無視します。--refreshを含みます。

--upgrade-package, -P upgrade-package--upgrade-package, -P upgrade-package

Allow upgrades for a specific package, ignoring pinned versions in any existing output file. Implies --refresh-package特定のパッケージのアップグレードを許可し、既存の出力ファイルに固定されたバージョンを無視します。--refresh-packageを含みます。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)環境変数RUST_LOGを使用して、詳細なロギングを構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv versionuv version

Read or update the project's versionプロジェクトのバージョンを読み取るか、更新します。

Usage使用法

uv version [OPTIONS] [VALUE]

Arguments引数

VALUEVALUE

Set the project version to this valueプロジェクトのバージョンをこの値に設定します

To update the project using semantic versioning components instead, use --bump.代わりにセマンティックバージョニングコンポーネントを使用してプロジェクトを更新するには、--bumpを使用します。

Optionsオプション

--active--active

Prefer the active virtual environment over the project's virtual environment.プロジェクトの仮想環境よりもアクティブな仮想環境を優先します。

If the project virtual environment is active or no virtual environment is active, this has no effect.プロジェクトの仮想環境がアクティブであるか、仮想環境がアクティブでない場合、これは影響を与えません。

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回提供できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホストポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、検証されたソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--bump bump[=value]--bump bump[=value]

Update the project version using the given semantics指定されたセマンティクスを使用してプロジェクトのバージョンを更新します。

This flag can be passed multiple times.このフラグは複数回渡すことができます。

Possible values:可能な値：

major: Increase the major version (e.g., 1.2.3 => 2.0.0)major: メジャーバージョンを増加させます（例：1.2.3 => 2.0.0）
minor: Increase the minor version (e.g., 1.2.3 => 1.3.0)minor: マイナーバージョンを増加させます（例：1.2.3 => 1.3.0）
patch: Increase the patch version (e.g., 1.2.3 => 1.2.4)patch: パッチバージョンを増加させます（例: 1.2.3 => 1.2.4）
stable: Move from a pre-release to stable version (e.g., 1.2.3b4.post5.dev6 => 1.2.3)stable: プレリリースから安定版に移行します（例: 1.2.3b4.post5.dev6 => 1.2.3）
alpha: Increase the alpha version (e.g., 1.2.3a4 => 1.2.3a5)alpha: アルファバージョンを増加させます（例: 1.2.3a4 => 1.2.3a5）
beta: Increase the beta version (e.g., 1.2.3b4 => 1.2.3b5)beta: ベータバージョンを増加させます（例: 1.2.3b4 => 1.2.3b5）
rc: Increase the rc version (e.g., 1.2.3rc4 => 1.2.3rc5)rc: リリース候補バージョンを増加させます（例: 1.2.3rc4 => 1.2.3rc5）
post: Increase the post version (e.g., 1.2.3.post5 => 1.2.3.post6)post: ポストバージョンを増加させます（例: 1.2.3.post5 => 1.2.3.post6）
dev: Increase the dev version (e.g., 1.2.3a4.dev6 => 1.2.3.dev7)dev: 開発バージョンを増加させます（例: 1.2.3a4.dev6 => 1.2.3.dev7）

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvにデフォルト設定され、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されます。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数を使用して設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力の色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末に書き込む際に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力がサポートされている端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--compile-bytecode, --compile--compile-bytecode, --compile

Compile Python files to bytecode after installation.インストール後にPythonファイルをバイトコードにコンパイルします。

By default, uv does not compile Python (.py) files to bytecode (__pycache__/*.pyc); instead, compilation is performed lazily the first time a module is imported. For use-cases in which start time is critical, such as CLI applications and Docker containers, this option can be enabled to trade longer installation times for faster start times.デフォルトでは、uvはPython（.py）ファイルをバイトコード（__pycache__/*.pyc）にコンパイルしません。代わりに、モジュールが初めてインポートされるときに遅延的にコンパイルが行われます。CLIアプリケーションやDockerコンテナなど、起動時間が重要なユースケースでは、このオプションを有効にすることで、長いインストール時間と引き換えに速い起動時間を得ることができます。

When enabled, uv will process the entire site-packages directory (including packages that are not being modified by the current operation) for consistency. Like pip, it will also ignore errors.有効にすると、uvは一貫性のためにサイトパッケージディレクトリ全体（現在の操作によって変更されていないパッケージを含む）を処理します。pipと同様に、エラーは無視されます。

May also be set with the UV_COMPILE_BYTECODE environment variable.環境変数UV_COMPILE_BYTECODEでも設定できます。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用するuv.tomlファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.環境変数UV_CONFIG_FILEでも設定できます。

--config-setting, --config-settings, -C config-setting--config-setting, --config-settings, -C config-setting

Settings to pass to the PEP 517 build backend, specified as KEY=VALUE pairsPEP 517ビルドバックエンドに渡す設定で、KEY=VALUEペアとして指定します。

--config-settings-package, --config-settings-package config-settings-package--config-settings-package, --config-settings-package config-settings-package

Settings to pass to the PEP 517 build backend for a specific package, specified as PACKAGE:KEY=VALUE pairs特定のパッケージのためにPEP 517ビルドバックエンドに渡す設定で、PACKAGE:KEY=VALUEペアとして指定されます。

--default-index default-index--default-index default-index

The URL of the default package index (by default: https://pypi.org/simple).デフォルトのパッケージインデックスのURL（デフォルトでは: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --index flag.このフラグで指定されたインデックスは、--indexフラグを介して指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_DEFAULT_INDEX environment variable.UV_DEFAULT_INDEX環境変数を使用して設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準として解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数でも設定できます。

--dry-run--dry-run

Don't write a new version to the pyproject.tomlpyproject.tomlに新しいバージョンを書き込まないでください。

Instead, the version will be displayed.代わりに、バージョンが表示されます。

--exclude-newer exclude-newer--exclude-newer exclude-newer

Limit candidate packages to those that were uploaded prior to the given date.候補パッケージを、指定された日付以前にアップロードされたものに制限します。

Accepts both RFC 3339 timestamps (e.g., 2006-12-02T02:07:43Z) and local dates in the same format (e.g., 2006-12-02) in your system's configured time zone.RFC 3339タイムスタンプ（例：2006-12-02T02:07:43Z）と、システムの設定されたタイムゾーンでの同じ形式のローカル日付（例：2006-12-02）の両方を受け入れます。

May also be set with the UV_EXCLUDE_NEWER environment variable.UV_EXCLUDE_NEWER環境変数でも設定できます。

--exclude-newer-package exclude-newer-package--exclude-newer-package exclude-newer-package

Limit candidate packages for specific packages to those that were uploaded prior to the given date.特定のパッケージに対する候補パッケージを、指定された日付以前にアップロードされたものに制限します。

Accepts package-date pairs in the format PACKAGE=DATE, where DATE is an RFC 3339 timestamp (e.g., 2006-12-02T02:07:43Z) or local date (e.g., 2006-12-02) in your system's configured time zone.PACKAGE=DATE形式のパッケージ-日付ペアを受け入れます。ここで、DATEはRFC 3339タイムスタンプ（例：2006-12-02T02:07:43Z）またはローカル日付（例：2006-12-02）で、システムの設定されたタイムゾーンに基づきます。

Can be provided multiple times for different packages.異なるパッケージのために複数回提供できます。

--extra-index-url extra-index-url--extra-index-url extra-index-url

(Deprecated: use --index instead) Extra URLs of package indexes to use, in addition to --index-url.(非推奨：代わりに--indexを使用してください) --index-urlに加えて使用するパッケージインデックスの追加URL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --index-url (which defaults to PyPI). When multiple --extra-index-url flags are provided, earlier values take priority.このフラグを介して提供されたすべてのインデックスは、--index-url（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の--extra-index-urlフラグが提供される場合、早い値が優先されます。

May also be set with the UV_EXTRA_INDEX_URL environment variable.UV_EXTRA_INDEX_URL環境変数で設定することもできます。

--find-links, -f find-links--find-links, -f find-links

Locations to search for candidate distributions, in addition to those found in the registry indexes.レジストリインデックスで見つかったものに加えて、候補配布を検索する場所。

If a path, the target must be a directory that contains packages as wheel files (.whl) or source distributions (e.g., .tar.gz or .zip) at the top level.パスの場合、ターゲットは最上位にホイールファイル（.whl）またはソース配布（例：.tar.gzまたは.zip）を含むディレクトリでなければなりません。

If a URL, the page must contain a flat list of links to package files adhering to the formats described above.URLの場合、ページは上記の形式に従ったパッケージファイルへのリンクのフラットリストを含む必要があります。

May also be set with the UV_FIND_LINKS environment variable.UV_FIND_LINKS 環境変数を使用して設定することもできます。

--fork-strategy fork-strategy--fork-strategy fork-strategy

The strategy to use when selecting multiple versions of a given package across Python versions and platforms.特定のパッケージの複数のバージョンをPythonのバージョンやプラットフォームにわたって選択する際に使用する戦略。

By default, uv will optimize for selecting the latest version of each package for each supported Python version (requires-python), while minimizing the number of selected versions across platforms.デフォルトでは、uvは各サポートされているPythonバージョン（requires-python）に対して各パッケージの最新バージョンを選択することを最適化し、プラットフォーム間で選択されたバージョンの数を最小限に抑えます。

Under fewest, uv will minimize the number of selected versions for each package, preferring older versions that are compatible with a wider range of supported Python versions or platforms.fewest の下では、uvは各パッケージの選択されたバージョンの数を最小限に抑え、より広範囲のサポートされているPythonバージョンやプラットフォームと互換性のある古いバージョンを優先します。

May also be set with the UV_FORK_STRATEGY environment variable.UV_FORK_STRATEGY 環境変数を使用して設定することもできます。

Possible values:可能な値：

fewest: Optimize for selecting the fewest number of versions for each package. Older versions may be preferred if they are compatible with a wider range of supported Python versions or platformsfewest: 各パッケージのバージョンの数を最小限に抑えることを最適化します。より広範囲のサポートされているPythonバージョンやプラットフォームと互換性がある場合、古いバージョンが優先されることがあります。
requires-python: Optimize for selecting latest supported version of each package, for each supported Python versionrequires-python: 各サポートされているPythonバージョンに対して、各パッケージの最新のサポートバージョンを選択するよう最適化します。

--frozen--frozen

Update the version without re-locking the project.プロジェクトのバージョンを再ロックせずに更新します。

The project environment will not be synced.プロジェクト環境は同期されません。

May also be set with the UV_FROZEN environment variable.UV_FROZEN 環境変数でも設定できます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--index index--index index

The URLs to use when resolving dependencies, in addition to the default index.デフォルトのインデックスに加えて、依存関係を解決するために使用するURL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリまたは同じ形式でレイアウトされたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --default-index (which defaults to PyPI). When multiple --index flags are provided, earlier values take priority.このフラグで提供されるすべてのインデックスは、--default-index（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の--indexフラグが提供される場合、先に指定された値が優先されます。

Index names are not supported as values. Relative paths must be disambiguated from index names with ./ or ../ on Unix or .\\, ..\\, ./ or ../ on Windows.インデックス名は値としてサポートされていません。相対パスは、Unixでは./または../で、Windowsでは.\\、..\\、./または../でインデックス名と区別する必要があります。

May also be set with the UV_INDEX environment variable.UV_INDEX環境変数でも設定できます。

--index-strategy index-strategy--index-strategy index-strategy

The strategy to use when resolving against multiple index URLs.複数のインデックスURLに対して解決する際に使用する戦略。

By default, uv will stop at the first index on which a given package is available, and limit resolutions to those present on that first index (first-index). This prevents "dependency confusion" attacks, whereby an attacker can upload a malicious package under the same name to an alternate index.デフォルトでは、uvは指定されたパッケージが利用可能な最初のインデックスで停止し、その最初のインデックスに存在するものに解決を制限します（first-index）。これにより、攻撃者が別のインデックスに同じ名前の悪意のあるパッケージをアップロードすることによる「依存関係の混乱」攻撃を防ぎます。

May also be set with the UV_INDEX_STRATEGY environment variable.UV_INDEX_STRATEGY環境変数でも設定できます。

Possible values:可能な値：

first-index: Only use results from the first index that returns a match for a given package namefirst-index: 指定されたパッケージ名に一致する最初のインデックスからの結果のみを使用します。
unsafe-first-match: Search for every package name across all indexes, exhausting the versions from the first index before moving on to the nextunsafe-first-match: すべてのインデックスで各パッケージ名を検索し、次のインデックスに移動する前に最初のインデックスからのバージョンを使い果たします。
unsafe-best-match: Search for every package name across all indexes, preferring the "best" version found. If a package version is in multiple indexes, only look at the entry for the first indexunsafe-best-match: すべてのインデックスでパッケージ名を検索し、見つかった「最良」のバージョンを優先します。パッケージのバージョンが複数のインデックスに存在する場合、最初のインデックスのエントリのみを参照します。

--index-url, -i index-url--index-url, -i index-url

(Deprecated: use --default-index instead) The URL of the Python package index (by default: https://pypi.org/simple).(非推奨: 代わりに --default-index を使用してください) PythonパッケージインデックスのURL（デフォルト: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --extra-index-url flag.このフラグで指定されたインデックスは、--extra-index-urlフラグで指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_INDEX_URL environment variable.UV_INDEX_URL 環境変数で設定することもできます。

--keyring-provider keyring-provider--keyring-provider keyring-provider

Attempt to use keyring for authentication for index URLs.keyringを使用してインデックスURLの認証を試みます。

At present, only --keyring-provider subprocess is supported, which configures uv to use the keyring CLI to handle authentication.現在のところ、--keyring-provider subprocess のみがサポートされており、これはuvが認証を処理するためにkeyring CLIを使用するように構成します。

Defaults to disabled.デフォルトはdisabledです。

May also be set with the UV_KEYRING_PROVIDER environment variable.環境変数 UV_KEYRING_PROVIDER でも設定可能です。

Possible values:可能な値:

disabled: Do not use keyring for credential lookupdisabled: 認証情報の検索にキーレリングを使用しない
subprocess: Use the keyring command for credential lookupsubprocess: 認証情報の検索に keyring コマンドを使用する

--link-mode link-mode--link-mode link-mode

The method to use when installing packages from the global cache.グローバルキャッシュからパッケージをインストールする際に使用する方法。

Defaults to clone (also known as Copy-on-Write) on macOS, and hardlink on Linux and Windows.macOSでは clone（コピーオンライトとも呼ばれる）がデフォルトで、LinuxおよびWindowsでは hardlink がデフォルトです。

WARNING: The use of symlink link mode is discouraged, as they create tight coupling between the cache and the target environment. For example, clearing the cache (uv cache clean) will break all installed packages by way of removing the underlying source files. Use symlinks with caution.警告: シンボリックリンクモードの使用は推奨されません。キャッシュとターゲット環境の間に強い結合を生じさせるためです。例えば、キャッシュをクリアする (uv cache clean) と、基盤となるソースファイルが削除されることで、すべてのインストールされたパッケージが壊れます。シンボリックリンクは注意して使用してください。

May also be set with the UV_LINK_MODE environment variable.環境変数 UV_LINK_MODE でも設定可能です。

Possible values:可能な値:

clone: Clone (i.e., copy-on-write) packages from the wheel into the site-packages directoryclone: ホイールからsite-packagesディレクトリにパッケージをクローン（すなわち、コピーオンライト）します。
copy: Copy packages from the wheel into the site-packages directorycopy: ホイールからsite-packagesディレクトリにパッケージをコピーします。
hardlink: Hard link packages from the wheel into the site-packages directoryhardlink: ホイールからsite-packagesディレクトリにパッケージをハードリンクします。
symlink: Symbolically link packages from the wheel into the site-packages directorysymlink: ホイールからsite-packagesディレクトリにパッケージをシンボリックリンクします。

--locked--locked

Assert that the uv.lock will remain unchanged.uv.lockが変更されないことを保証します。

Requires that the lockfile is up-to-date. If the lockfile is missing or needs to be updated, uv will exit with an error.ロックファイルが最新である必要があります。ロックファイルが欠落しているか、更新が必要な場合、uvはエラーで終了します。

May also be set with the UV_LOCKED environment variable.UV_LOCKED環境変数で設定することもできます。

--managed-python--managed-python

Require use of uv-managed Python versions.uv管理のPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理しているPythonバージョンを使用することを好みます。ただし、uvが管理しているPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.また、UV_MANAGED_PYTHON環境変数で設定することもできます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、特にシステムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したいことがあります。

May also be set with the UV_NATIVE_TLS environment variable.また、UV_NATIVE_TLS環境変数で設定することもできます。

--no-binary--no-binary

Don't install pre-built wheels.事前にビルドされたホイールをインストールしません。

The given packages will be built and installed from source. The resolver will still use pre-built wheels to extract package metadata, if available.指定されたパッケージはソースからビルドされ、インストールされます。リゾルバは、利用可能な場合、パッケージメタデータを抽出するために事前にビルドされたホイールを使用します。

May also be set with the UV_NO_BINARY environment variable.環境変数 UV_NO_BINARY でも設定できます。

--no-binary-package no-binary-package--no-binary-package no-binary-package

Don't install pre-built wheels for a specific package特定のパッケージに対してプリビルドのホイールをインストールしない

May also be set with the UV_NO_BINARY_PACKAGE environment variable.環境変数 UV_NO_BINARY_PACKAGE でも設定できます。

--no-build--no-build

Don't build source distributions.ソース配布物をビルドしない。

When enabled, resolving will not run arbitrary Python code. The cached wheels of already-built source distributions will be reused, but operations that require building distributions will exit with an error.有効にすると、解決時に任意のPythonコードが実行されません。既にビルドされたソース配布物のキャッシュされたホイールが再利用されますが、配布物のビルドを必要とする操作はエラーで終了します。

May also be set with the UV_NO_BUILD environment variable.環境変数 UV_NO_BUILD でも設定できます。

--no-build-isolation--no-build-isolation

Disable isolation when building source distributions.ソース配布物をビルドする際にアイソレーションを無効にします。

Assumes that build dependencies specified by PEP 518 are already installed.PEP 518で指定されたビルド依存関係がすでにインストールされていることを前提とします。

May also be set with the UV_NO_BUILD_ISOLATION environment variable.環境変数 UV_NO_BUILD_ISOLATION でも設定できます。

--no-build-isolation-package no-build-isolation-package--no-build-isolation-package no-build-isolation-package

Disable isolation when building source distributions for a specific package.特定のパッケージのソース配布物をビルドする際に隔離を無効にします。

Assumes that the packages' build dependencies specified by PEP 518 are already installed.パッケージのビルド依存関係がPEP 518で指定されていることを前提とします。

--no-build-package no-build-package--no-build-package no-build-package

Don't build source distributions for a specific package特定のパッケージのソース配布物をビルドしません。

May also be set with the UV_NO_BUILD_PACKAGE environment variable.環境変数 UV_NO_BUILD_PACKAGE でも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.環境変数 UV_NO_CACHE でも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml, uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.環境変数 UV_NO_CONFIG でも設定できます。

--no-index--no-index

Ignore the registry index (e.g., PyPI), instead relying on direct URL dependencies and those provided via --find-linksレジストリインデックス（例：PyPI）を無視し、代わりに直接URL依存関係および --find-links を介して提供されるものに依存します。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.その代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.環境変数 UV_NO_MANAGED_PYTHON でも設定できます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.環境変数 UV_NO_PROGRESS でも設定できます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--no-sources--no-sources

Ignore the tool.uv.sources table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any workspace, Git, URL, or local path sources依存関係を解決する際に tool.uv.sources テーブルを無視します。ワークスペース、Git、URL、またはローカルパスソースを使用するのではなく、標準準拠の公開可能なパッケージメタデータに対してロックするために使用されます。

May also be set with the UV_NO_SOURCES environment variable.環境変数 UV_NO_SOURCES でも設定できます。

--no-sync--no-sync

Avoid syncing the virtual environment after re-locking the projectプロジェクトの再ロック後に仮想環境の同期を避ける

May also be set with the UV_NO_SYNC environment variable.UV_NO_SYNC 環境変数でも設定可能です。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数でも設定可能です。

--output-format output-format--output-format output-format

The format of the output出力のフォーマット

[default: text][デフォルト: text]

Possible values:可能な値:

text: Display the version as plain texttext: バージョンをプレーンテキストとして表示
json: Display the version as JSONjson: バージョンをJSONとして表示

--package package--package package

Update the version of a specific package in the workspaceワークスペース内の特定のパッケージのバージョンを更新

--prerelease prerelease--prerelease prerelease

The strategy to use when considering pre-release versions.プレリリースバージョンを考慮する際に使用する戦略。

By default, uv will accept pre-releases for packages that only publish pre-releases, along with first-party requirements that contain an explicit pre-release marker in the declared specifiers (if-necessary-or-explicit).デフォルトでは、uvはプレリリースのみを公開するパッケージと、宣言された指定子に明示的なプレリリースマーカーを含むファーストパーティの要件に対してプレリリースを受け入れます (if-necessary-or-explicit)。

May also be set with the UV_PRERELEASE environment variable.UV_PRERELEASE 環境変数で設定することもできます。

Possible values:可能な値:

disallow: Disallow all pre-release versionsdisallow: すべてのプレリリースバージョンを拒否します
allow: Allow all pre-release versionsallow: すべてのプレリリースバージョンを許可します
if-necessary: Allow pre-release versions if all versions of a package are pre-releaseif-necessary: パッケージのすべてのバージョンがプレリリースである場合にプレリリースバージョンを許可します
explicit: Allow pre-release versions for first-party packages with explicit pre-release markers in their version requirementsexplicit: バージョン要件に明示的なプレリリースマーカーがあるファーストパーティパッケージに対してプレリリースバージョンを許可します
if-necessary-or-explicit: Allow pre-release versions if all versions of a package are pre-release, or if the package has an explicit pre-release marker in its version requirementsif-necessary-or-explicit: パッケージのすべてのバージョンがプレリリースである場合、またはパッケージにバージョン要件に明示的なプレリリースマーカーがある場合にプレリリースバージョンを許可します

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数でも設定できます。

--python, -p python--python, -p python

The Python interpreter to use for resolving and syncing.解決と同期に使用するPythonインタプリタ。

See uv python for details on Python discovery and supported request formats.Pythonの発見とサポートされているリクエスト形式の詳細については、uv pythonを参照してください。

May also be set with the UV_PYTHON environment variable.UV_PYTHON 環境変数でも設定できます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば-qq、uvはstdoutに出力を行わないサイレントモードを有効にします。

--refresh--refresh

Refresh all cached dataすべてのキャッシュデータを更新

--refresh-package refresh-package--refresh-package refresh-package

Refresh cached data for a specific package特定のパッケージのキャッシュデータを更新

--reinstall, --force-reinstall--reinstall, --force-reinstall

Reinstall all packages, regardless of whether they're already installed. Implies --refreshすべてのパッケージを再インストールします。すでにインストールされているかどうかに関係なく。--refreshを含意します。

--reinstall-package reinstall-package--reinstall-package reinstall-package

Reinstall a specific package, regardless of whether it's already installed. Implies --refresh-package特定のパッケージを再インストールします。すでにインストールされているかどうかに関係なく。--refresh-packageを含意します。

--resolution resolution--resolution resolution

The strategy to use when selecting between the different compatible versions for a given package requirement.特定のパッケージ要件に対して異なる互換バージョンを選択する際に使用する戦略。

By default, uv will use the latest compatible version of each package (highest).デフォルトでは、uvは各パッケージの最新の互換バージョンを使用します (highest)。

May also be set with the UV_RESOLUTION environment variable.環境変数 UV_RESOLUTION で設定することもできます。

Possible values:可能な値：

highest: Resolve the highest compatible version of each packagehighest: 各パッケージの最高互換バージョンを解決します
lowest: Resolve the lowest compatible version of each packagelowest: 各パッケージの最低互換バージョンを解決します
lowest-direct: Resolve the lowest compatible version of any direct dependencies, and the highest compatible version of any transitive dependencieslowest-direct: 直接依存関係の最低互換バージョンを解決し、間接依存関係の最高互換バージョンを解決します

--short--short

Only show the versionバージョンのみを表示

By default, uv will show the project name before the version.デフォルトでは、uvはバージョンの前にプロジェクト名を表示します。

--upgrade, -U--upgrade, -U

Allow package upgrades, ignoring pinned versions in any existing output file. Implies --refreshパッケージのアップグレードを許可し、既存の出力ファイルに固定されたバージョンを無視します。--refreshを含意します

--upgrade-package, -P upgrade-package--upgrade-package, -P upgrade-package

Allow upgrades for a specific package, ignoring pinned versions in any existing output file. Implies --refresh-package特定のパッケージのアップグレードを許可し、既存の出力ファイルに固定されたバージョンを無視します。--refresh-packageを暗示します。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)RUST_LOG環境変数を使用して、詳細なログ記録を構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv syncuv sync

Update the project's environment.プロジェクトの環境を更新します。

Syncing ensures that all project dependencies are installed and up-to-date with the lockfile.同期は、すべてのプロジェクト依存関係がインストールされ、ロックファイルと最新であることを保証します。

By default, an exact sync is performed: uv removes packages that are not declared as dependencies of the project. Use the --inexact flag to keep extraneous packages. Note that if an extraneous package conflicts with a project dependency, it will still be removed. Additionally, if --no-build-isolation is used, uv will not remove extraneous packages to avoid removing possible build dependencies.デフォルトでは、正確な同期が実行されます：uvはプロジェクトの依存関係として宣言されていないパッケージを削除します。余分なパッケージを保持するには、--inexactフラグを使用します。余分なパッケージがプロジェクトの依存関係と競合する場合、それでも削除されることに注意してください。さらに、--no-build-isolationが使用されている場合、uvは可能なビルド依存関係を削除しないように余分なパッケージを削除しません。

If the project virtual environment (.venv) does not exist, it will be created.プロジェクトの仮想環境（.venv）が存在しない場合は、作成されます。

The project is re-locked before syncing unless the --locked or --frozen flag is provided.プロジェクトは、--locked または --frozen フラグが提供されない限り、同期の前に再ロックされます。

uv will search for a project in the current directory or any parent directory. If a project cannot be found, uv will exit with an error.uvは、現在のディレクトリまたは親ディレクトリ内でプロジェクトを検索します。プロジェクトが見つからない場合、uvはエラーで終了します。

Note that, when installing from a lockfile, uv will not provide warnings for yanked package versions.ロックファイルからインストールする際、uvはyankedパッケージバージョンに対して警告を提供しないことに注意してください。

Usage使用法

uv sync [OPTIONS]

Optionsオプション

--active--active

Sync dependencies to the active virtual environment.アクティブな仮想環境に依存関係を同期します。

Instead of creating or updating the virtual environment for the project or script, the active virtual environment will be preferred, if the VIRTUAL_ENV environment variable is set.プロジェクトやスクリプトのために仮想環境を作成または更新する代わりに、VIRTUAL_ENV 環境変数が設定されている場合は、アクティブな仮想環境が優先されます。

--all-extras--all-extras

Include all optional dependencies.すべてのオプショナル依存関係を含めます。

When two or more extras are declared as conflicting in tool.uv.conflicts, using this flag will always result in an error.2つ以上のエクストラがtool.uv.conflictsで競合すると宣言されている場合、このフラグを使用すると常にエラーが発生します。

Note that all optional dependencies are always included in the resolution; this option only affects the selection of packages to install.すべてのオプション依存関係は常に解決に含まれることに注意してください。このオプションは、インストールするパッケージの選択にのみ影響します。

--all-groups--all-groups

Include dependencies from all dependency groups.すべての依存グループから依存関係を含めます。

--no-group can be used to exclude specific groups.--no-groupを使用して特定のグループを除外できます。

--all-packages--all-packages

Sync all packages in the workspace.ワークスペース内のすべてのパッケージを同期します。

The workspace's environment (.venv) is updated to include all workspace members.ワークスペースの環境（.venv）は、すべてのワークスペースメンバーを含むように更新されます。

Any extras or groups specified via --extra, --group, or related options will be applied to all workspace members.--extra、--group、または関連オプションを介して指定されたエクストラやグループは、すべてのワークスペースメンバーに適用されます。

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host、--trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正な接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数で設定することもできます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvに、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されています。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を確認するには、uv cache dirを実行してください。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数で設定することもできます。

--check--check

Check if the Python environment is synchronized with the project.Python環境がプロジェクトと同期しているか確認します。

If the environment is not up to date, uv will exit with an error.環境が最新でない場合、uvはエラーで終了します。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末への書き込み時に自動的に色のサポートを検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力が端末またはサポートのあるTTYに向けられている場合のみ、カラー出力を有効にします
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします
never: Disables colored outputnever: カラー出力を無効にします

--compile-bytecode, --compile--compile-bytecode, --compile

Compile Python files to bytecode after installation.インストール後にPythonファイルをバイトコードにコンパイルします。

By default, uv does not compile Python (.py) files to bytecode (__pycache__/*.pyc); instead, compilation is performed lazily the first time a module is imported. For use-cases in which start time is critical, such as CLI applications and Docker containers, this option can be enabled to trade longer installation times for faster start times.デフォルトでは、uvはPython（.py）ファイルをバイトコード（__pycache__/*.pyc）にコンパイルしません。代わりに、モジュールが初めてインポートされるときに遅延的にコンパイルが行われます。CLIアプリケーションやDockerコンテナなど、起動時間が重要なユースケースでは、このオプションを有効にすることで、長いインストール時間と引き換えに速い起動時間を得ることができます。

When enabled, uv will process the entire site-packages directory (including packages that are not being modified by the current operation) for consistency. Like pip, it will also ignore errors.有効にすると、uvは整合性のためにサイトパッケージディレクトリ全体（現在の操作によって変更されていないパッケージを含む）を処理します。pipのように、エラーも無視します。

May also be set with the UV_COMPILE_BYTECODE environment variable.UV_COMPILE_BYTECODE環境変数でも設定できます。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用するuv.tomlファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数でも設定できます。

--config-setting, --config-settings, -C config-setting--config-setting, --config-settings, -C config-setting

Settings to pass to the PEP 517 build backend, specified as KEY=VALUE pairsPEP 517ビルドバックエンドに渡す設定で、KEY=VALUEペアとして指定します。

--config-settings-package, --config-settings-package config-settings-package--config-settings-package, --config-settings-package config-settings-package

Settings to pass to the PEP 517 build backend for a specific package, specified as PACKAGE:KEY=VALUE pairs特定のパッケージに対してPEP 517ビルドバックエンドに渡す設定で、PACKAGE:KEY=VALUEペアとして指定します。

--default-index default-index--default-index default-index

The URL of the default package index (by default: https://pypi.org/simple).デフォルトのパッケージインデックスのURL（デフォルトでは: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリまたは同じ形式で配置されたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --index flag.このフラグで指定されたインデックスは、--indexフラグで指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_DEFAULT_INDEX environment variable.UV_DEFAULT_INDEX環境変数で設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数でも設定できます。

--dry-run--dry-run

Perform a dry run, without writing the lockfile or modifying the project environment.ロックファイルを書き込まず、プロジェクト環境を変更せずにドライランを実行します。

In dry-run mode, uv will resolve the project's dependencies and report on the resulting changes to both the lockfile and the project environment, but will not modify either.ドライランモードでは、uvはプロジェクトの依存関係を解決し、ロックファイルとプロジェクト環境の結果としての変更を報告しますが、いずれも変更しません。

--exclude-newer exclude-newer--exclude-newer exclude-newer

Limit candidate packages to those that were uploaded prior to the given date.候補パッケージを、指定された日付以前にアップロードされたものに制限します。

Accepts both RFC 3339 timestamps (e.g., 2006-12-02T02:07:43Z) and local dates in the same format (e.g., 2006-12-02) in your system's configured time zone.RFC 3339タイムスタンプ（例：2006-12-02T02:07:43Z）と、システムの設定されたタイムゾーンでの同じ形式のローカル日付（例：2006-12-02）の両方を受け入れます。

May also be set with the UV_EXCLUDE_NEWER environment variable.UV_EXCLUDE_NEWER環境変数でも設定できます。

--exclude-newer-package exclude-newer-package--exclude-newer-package exclude-newer-package

Limit candidate packages for specific packages to those that were uploaded prior to the given date.特定のパッケージの候補パッケージを、指定された日付以前にアップロードされたものに制限します。

Accepts package-date pairs in the format PACKAGE=DATE, where DATE is an RFC 3339 timestamp (e.g., 2006-12-02T02:07:43Z) or local date (e.g., 2006-12-02) in your system's configured time zone.パッケージ-日付のペアを PACKAGE=DATE の形式で受け入れます。ここで DATE はRFC 3339タイムスタンプ（例：2006-12-02T02:07:43Z）またはローカル日付（例：2006-12-02）で、システムの設定されたタイムゾーンに基づきます。

Can be provided multiple times for different packages.異なるパッケージのために複数回提供できます。

--extra extra--extra extra

Include optional dependencies from the specified extra name.指定されたエクストラ名からオプションの依存関係を含めます。

May be provided more than once.複数回提供することができます。

When multiple extras or groups are specified that appear in tool.uv.conflicts, uv will report an error.複数のエクストラまたはグループが tool.uv.conflicts に指定されている場合、uvはエラーを報告します。

Note that all optional dependencies are always included in the resolution; this option only affects the selection of packages to install.すべてのオプションの依存関係は常に解決に含まれることに注意してください。このオプションは、インストールするパッケージの選択にのみ影響します。

--extra-index-url extra-index-url--extra-index-url extra-index-url

(Deprecated: use --index instead) Extra URLs of package indexes to use, in addition to --index-url.(非推奨: 代わりに --index を使用してください) --index-url に加えて使用するパッケージインデックスの追加URL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --index-url (which defaults to PyPI). When multiple --extra-index-url flags are provided, earlier values take priority.このフラグを介して提供されるすべてのインデックスは、指定された --index-url（デフォルトはPyPI）よりも優先されます。複数の --extra-index-url フラグが提供される場合、早い値が優先されます。

May also be set with the UV_EXTRA_INDEX_URL environment variable.UV_EXTRA_INDEX_URL 環境変数で設定することもできます。

--find-links, -f find-links--find-links, -f find-links

Locations to search for candidate distributions, in addition to those found in the registry indexes.レジストリインデックスで見つかったものに加えて、候補の配布物を検索する場所。

If a path, the target must be a directory that contains packages as wheel files (.whl) or source distributions (e.g., .tar.gz or .zip) at the top level.パスの場合、ターゲットはトップレベルにホイールファイル（.whl）またはソース配布（例: .tar.gz または .zip）を含むディレクトリでなければなりません。

If a URL, the page must contain a flat list of links to package files adhering to the formats described above.URLの場合、ページは上記の形式に従ったパッケージファイルへのリンクのフラットリストを含む必要があります。

May also be set with the UV_FIND_LINKS environment variable.UV_FIND_LINKS 環境変数で設定することもできます。

--fork-strategy fork-strategy--fork-strategy fork-strategy

The strategy to use when selecting multiple versions of a given package across Python versions and platforms.特定のパッケージの複数のバージョンをPythonのバージョンやプラットフォームにわたって選択する際に使用する戦略。

By default, uv will optimize for selecting the latest version of each package for each supported Python version (requires-python), while minimizing the number of selected versions across platforms.デフォルトでは、uvは各サポートされているPythonバージョン（requires-python）ごとに各パッケージの最新バージョンを選択することを最適化し、プラットフォーム間で選択されたバージョンの数を最小限に抑えます。

Under fewest, uv will minimize the number of selected versions for each package, preferring older versions that are compatible with a wider range of supported Python versions or platforms.fewestの下では、uvは各パッケージの選択されたバージョンの数を最小限に抑え、より広範囲のサポートされているPythonバージョンやプラットフォームと互換性のある古いバージョンを優先します。

May also be set with the UV_FORK_STRATEGY environment variable.UV_FORK_STRATEGY環境変数で設定することもできます。

Possible values:可能な値：

fewest: Optimize for selecting the fewest number of versions for each package. Older versions may be preferred if they are compatible with a wider range of supported Python versions or platformsfewest: 各パッケージのバージョン数を最小限に抑えることを最適化します。より広範囲のサポートされているPythonバージョンやプラットフォームと互換性がある場合、古いバージョンが優先されることがあります。
requires-python: Optimize for selecting latest supported version of each package, for each supported Python versionrequires-python: 各サポートされているPythonバージョンごとに各パッケージの最新のサポートバージョンを選択することを最適化します。

--frozen--frozen

Sync without updating the uv.lock file.uv.lockファイルを更新せずに同期します。

Instead of checking if the lockfile is up-to-date, uses the versions in the lockfile as the source of truth. If the lockfile is missing, uv will exit with an error. If the pyproject.toml includes changes to dependencies that have not been included in the lockfile yet, they will not be present in the environment.ロックファイルが最新かどうかを確認する代わりに、ロックファイル内のバージョンを真実の源として使用します。ロックファイルが欠けている場合、uvはエラーで終了します。pyproject.tomlにロックファイルにまだ含まれていない依存関係の変更が含まれている場合、それらは環境に存在しません。

May also be set with the UV_FROZEN environment variable.また、UV_FROZEN 環境変数で設定することもできます。

--group group--group グループ

Include dependencies from the specified dependency group.指定された依存関係グループから依存関係を含めます。

When multiple extras or groups are specified that appear in tool.uv.conflicts, uv will report an error.複数のエクストラまたはグループが指定され、tool.uv.conflicts に表示される場合、uv はエラーを報告します。

May be provided multiple times.複数回提供することができます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--index index--index インデックス

The URLs to use when resolving dependencies, in addition to the default index.デフォルトのインデックスに加えて、依存関係を解決する際に使用するURL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --default-index (which defaults to PyPI). When multiple --index flags are provided, earlier values take priority.このフラグで提供されるすべてのインデックスは、--default-index（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の--indexフラグが提供される場合、先に指定された値が優先されます。

Index names are not supported as values. Relative paths must be disambiguated from index names with ./ or ../ on Unix or .\\, ..\\, ./ or ../ on Windows.インデックス名は値としてサポートされていません。相対パスは、Unixでは./または../で、Windowsでは.\\、..\\、./または../でインデックス名と区別する必要があります。

May also be set with the UV_INDEX environment variable.UV_INDEX環境変数でも設定できます。

--index-strategy index-strategy--index-strategy index-strategy

The strategy to use when resolving against multiple index URLs.複数のインデックスURLに対して解決する際に使用する戦略。

By default, uv will stop at the first index on which a given package is available, and limit resolutions to those present on that first index (first-index). This prevents "dependency confusion" attacks, whereby an attacker can upload a malicious package under the same name to an alternate index.デフォルトでは、uvは指定されたパッケージが利用可能な最初のインデックスで停止し、その最初のインデックスに存在するものに解決を制限します（first-index）。これにより、攻撃者が別のインデックスに同じ名前の悪意のあるパッケージをアップロードすることによる「依存関係の混乱」攻撃を防ぎます。

May also be set with the UV_INDEX_STRATEGY environment variable.UV_INDEX_STRATEGY環境変数でも設定できます。

Possible values:可能な値：

first-index: Only use results from the first index that returns a match for a given package namefirst-index: 指定されたパッケージ名に一致する最初のインデックスからの結果のみを使用します。
unsafe-first-match: Search for every package name across all indexes, exhausting the versions from the first index before moving on to the nextunsafe-first-match: すべてのインデックスで各パッケージ名を検索し、次のインデックスに移動する前に最初のインデックスからのバージョンを使い果たします。
unsafe-best-match: Search for every package name across all indexes, preferring the "best" version found. If a package version is in multiple indexes, only look at the entry for the first indexunsafe-best-match: すべてのインデックスでパッケージ名を検索し、見つかった「最良」のバージョンを優先します。パッケージのバージョンが複数のインデックスに存在する場合、最初のインデックスのエントリのみを確認します。

--index-url, -i index-url--index-url, -i index-url

(Deprecated: use --default-index instead) The URL of the Python package index (by default: https://pypi.org/simple).(非推奨: 代わりに --default-index を使用してください) PythonパッケージインデックスのURL（デフォルト: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式で配置されたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --extra-index-url flag.このフラグで指定されたインデックスは、--extra-index-url フラグで指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_INDEX_URL environment variable.UV_INDEX_URL 環境変数で設定することもできます。

--inexact, --no-exact--inexact, --no-exact

Do not remove extraneous packages present in the environment.環境に存在する余分なパッケージを削除しません。

When enabled, uv will make the minimum necessary changes to satisfy the requirements. By default, syncing will remove any extraneous packages from the environment有効にすると、uvは要件を満たすために必要最小限の変更を行います。デフォルトでは、同期は環境から余分なパッケージを削除します。

--keyring-provider keyring-provider--keyring-provider keyring-provider

Attempt to use keyring for authentication for index URLs.インデックスURLの認証にkeyringを使用しようとしています。

At present, only --keyring-provider subprocess is supported, which configures uv to use the keyring CLI to handle authentication.現在のところ、--keyring-provider subprocessのみがサポートされており、これはuvが認証を処理するためにkeyring CLIを使用するように設定します。

Defaults to disabled.デフォルトはdisabledです。

May also be set with the UV_KEYRING_PROVIDER environment variable.UV_KEYRING_PROVIDER環境変数で設定することもできます。

Possible values:可能な値：

disabled: Do not use keyring for credential lookupdisabled: 認証情報の検索にkeyringを使用しない
subprocess: Use the keyring command for credential lookupsubprocess: 認証情報の検索にkeyringコマンドを使用する

--link-mode link-mode--link-mode link-mode

The method to use when installing packages from the global cache.グローバルキャッシュからパッケージをインストールする際に使用する方法。

Defaults to clone (also known as Copy-on-Write) on macOS, and hardlink on Linux and Windows.macOSではデフォルトでclone（コピーオンライトとも呼ばれる）、LinuxおよびWindowsではhardlinkです。

WARNING: The use of symlink link mode is discouraged, as they create tight coupling between the cache and the target environment. For example, clearing the cache (uv cache clean) will break all installed packages by way of removing the underlying source files. Use symlinks with caution.警告: シンボリックリンクモードの使用は推奨されません。これはキャッシュとターゲット環境の間に強い結合を生じさせるためです。例えば、キャッシュをクリアする（uv cache clean）と、基盤となるソースファイルが削除されることで、すべてのインストールされたパッケージが壊れます。シンボリックリンクは注意して使用してください。

May also be set with the UV_LINK_MODE environment variable.また、UV_LINK_MODE 環境変数で設定することもできます。

Possible values:可能な値:

clone: Clone (i.e., copy-on-write) packages from the wheel into the site-packages directoryclone: ホイールからsite-packagesディレクトリにパッケージをクローン（すなわち、コピーオンライト）します。
copy: Copy packages from the wheel into the site-packages directorycopy: ホイールからsite-packagesディレクトリにパッケージをコピーします。
hardlink: Hard link packages from the wheel into the site-packages directoryhardlink: ホイールからsite-packagesディレクトリにパッケージをハードリンクします。
symlink: Symbolically link packages from the wheel into the site-packages directorysymlink: ホイールからsite-packagesディレクトリにパッケージをシンボリックリンクします。

--locked--locked

Assert that the uv.lock will remain unchanged.uv.lockが変更されないことを保証します。

Requires that the lockfile is up-to-date. If the lockfile is missing or needs to be updated, uv will exit with an error.ロックファイルが最新である必要があります。ロックファイルが欠落しているか、更新が必要な場合、uvはエラーで終了します。

May also be set with the UV_LOCKED environment variable.環境変数 UV_LOCKED でも設定できます。

--managed-python--managed-python

Require use of uv-managed Python versions.uv管理のPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンの使用を優先します。ただし、uv管理のPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.環境変数 UV_MANAGED_PYTHON でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされた webpki-roots クレートから証明書を読み込みます。webpki-roots はMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、特にシステムの証明書ストアに含まれる企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したいことがあります。

May also be set with the UV_NATIVE_TLS environment variable.環境変数 UV_NATIVE_TLS でも設定できます。

--no-binary--no-binary

Don't install pre-built wheels.事前にビルドされたホイールをインストールしないでください。

The given packages will be built and installed from source. The resolver will still use pre-built wheels to extract package metadata, if available.指定されたパッケージはソースからビルドされ、インストールされます。リゾルバは、利用可能な場合、パッケージメタデータを抽出するために事前にビルドされたホイールを使用します。

May also be set with the UV_NO_BINARY environment variable.UV_NO_BINARY 環境変数で設定することもできます。

--no-binary-package no-binary-package--no-binary-package no-binary-package

Don't install pre-built wheels for a specific package特定のパッケージに対して事前にビルドされたホイールをインストールしないでください。

May also be set with the UV_NO_BINARY_PACKAGE environment variable.UV_NO_BINARY_PACKAGE 環境変数で設定することもできます。

--no-build--no-build

Don't build source distributions.ソース配布物をビルドしないでください。

When enabled, resolving will not run arbitrary Python code. The cached wheels of already-built source distributions will be reused, but operations that require building distributions will exit with an error.有効にすると、リゾルビングは任意のPythonコードを実行しません。すでにビルドされたソース配布物のキャッシュされたホイールは再利用されますが、配布物のビルドを必要とする操作はエラーで終了します。

May also be set with the UV_NO_BUILD environment variable.環境変数 UV_NO_BUILD でも設定できます。

--no-build-isolation--no-build-isolation

Disable isolation when building source distributions.ソース配布物をビルドする際に隔離を無効にします。

Assumes that build dependencies specified by PEP 518 are already installed.PEP 518 で指定されたビルド依存関係がすでにインストールされていると仮定します。

May also be set with the UV_NO_BUILD_ISOLATION environment variable.環境変数 UV_NO_BUILD_ISOLATION でも設定できます。

--no-build-isolation-package no-build-isolation-package--no-build-isolation-package no-build-isolation-package

Disable isolation when building source distributions for a specific package.特定のパッケージのソース配布物をビルドする際に隔離を無効にします。

Assumes that the packages' build dependencies specified by PEP 518 are already installed.そのパッケージのビルド依存関係が PEP 518 で指定されていると仮定します。

--no-build-package no-build-package--no-build-package no-build-package

Don't build source distributions for a specific package特定のパッケージのソース配布物をビルドしません。

May also be set with the UV_NO_BUILD_PACKAGE environment variable.環境変数 UV_NO_BUILD_PACKAGE でも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.環境変数 UV_NO_CACHE でも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル (pyproject.toml, uv.toml) の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.環境変数 UV_NO_CONFIG でも設定できます。

--no-default-groups--no-default-groups

Ignore the default dependency groups.デフォルトの依存関係グループを無視します。

uv includes the groups defined in tool.uv.default-groups by default. This disables that option, however, specific groups can still be included with --group.uvはデフォルトでtool.uv.default-groupsで定義されたグループを含みます。ただし、このオプションは無効になり、特定のグループは--groupで含めることができます。

May also be set with the UV_NO_DEFAULT_GROUPS environment variable.また、UV_NO_DEFAULT_GROUPS環境変数で設定することもできます。

--no-dev--no-dev

Disable the development dependency group.開発依存関係グループを無効にします。

This option is an alias of --no-group dev. See --no-default-groups to disable all default groups instead.このオプションは--no-group devのエイリアスです。すべてのデフォルトグループを無効にするには--no-default-groupsを参照してください。

May also be set with the UV_NO_DEV environment variable.また、UV_NO_DEV環境変数で設定することもできます。

--no-editable--no-editable

Install any editable dependencies, including the project and any workspace members, as non-editableプロジェクトおよびワークスペースメンバーを含む、すべての編集可能な依存関係を非編集可能としてインストールします。

May also be set with the UV_NO_EDITABLE environment variable.また、UV_NO_EDITABLE環境変数で設定することもできます。

--no-extra no-extra--no-extra no-extra

Exclude the specified optional dependencies, if --all-extras is supplied.指定されたオプションの依存関係を除外します。--all-extrasが指定されている場合。

May be provided multiple times.複数回指定することができます。

--no-group no-group--no-group no-group

Disable the specified dependency group.指定された依存関係グループを無効にします。

This option always takes precedence over default groups, --all-groups, and --group.このオプションは常にデフォルトグループ、--all-groups、および--groupよりも優先されます。

May be provided multiple times.複数回指定することができます。

May also be set with the UV_NO_GROUP environment variable.また、UV_NO_GROUP環境変数で設定することもできます。

--no-index--no-index

Ignore the registry index (e.g., PyPI), instead relying on direct URL dependencies and those provided via --find-linksレジストリインデックス（例：PyPI）を無視し、直接URL依存関係および--find-linksを介して提供されるものに依存します。

--no-install-local--no-install-local

Do not install local path dependenciesローカルパス依存関係をインストールしない

Skips the current project, workspace members, and any other local (path or editable) packages. Only remote/indexed dependencies are installed. Useful in Docker builds to cache heavy third-party dependencies first and layer local packages separately.現在のプロジェクト、ワークスペースメンバー、およびその他のローカル（パスまたは編集可能）パッケージをスキップします。リモート/インデックスされた依存関係のみがインストールされます。Dockerビルドで重いサードパーティ依存関係を最初にキャッシュし、ローカルパッケージを別にレイヤー化するのに便利です。

The inverse --only-install-local can be used to install only local packages, excluding all remote dependencies.逆の--only-install-localを使用すると、すべてのリモート依存関係を除外してのみローカルパッケージをインストールできます。

--no-install-package no-install-package--no-install-package no-install-package

Do not install the given package(s).指定されたパッケージをインストールしない。

By default, all of the project's dependencies are installed into the environment. The --no-install-package option allows exclusion of specific packages. Note this can result in a broken environment, and should be used with caution.デフォルトでは、プロジェクトのすべての依存関係が環境にインストールされます。--no-install-packageオプションを使用すると、特定のパッケージを除外できます。これにより環境が壊れる可能性があるため、注意して使用する必要があります。

The inverse --only-install-package can be used to install only the specified packages, excluding all others.逆の--only-install-packageを使用すると、他のすべてを除外してのみ指定されたパッケージをインストールできます。

--no-install-project--no-install-project

Do not install the current project.現在のプロジェクトをインストールしない。

By default, the current project is installed into the environment with all of its dependencies. The --no-install-project option allows the project to be excluded, but all of its dependencies are still installed. This is particularly useful in situations like building Docker images where installing the project separately from its dependencies allows optimal layer caching.デフォルトでは、現在のプロジェクトはそのすべての依存関係とともに環境にインストールされます。--no-install-projectオプションを使用すると、プロジェクトを除外できますが、そのすべての依存関係はまだインストールされます。これは、プロジェクトを依存関係とは別にインストールすることで最適なレイヤーキャッシングを可能にするDockerイメージのビルドなどの状況で特に便利です。

The inverse --only-install-project can be used to install only the project itself, excluding all dependencies.逆の --only-install-project は、すべての依存関係を除外して、プロジェクト自体のみ をインストールするために使用できます。

--no-install-workspace--no-install-workspace

Do not install any workspace members, including the root project.ルートプロジェクトを含む、ワークスペースメンバーを一切インストールしません。

By default, all workspace members and their dependencies are installed into the environment. The --no-install-workspace option allows exclusion of all the workspace members while retaining their dependencies. This is particularly useful in situations like building Docker images where installing the workspace separately from its dependencies allows optimal layer caching.デフォルトでは、すべてのワークスペースメンバーとその依存関係が環境にインストールされます。--no-install-workspace オプションを使用すると、依存関係を保持しながらすべてのワークスペースメンバーを除外できます。これは、依存関係とは別にワークスペースをインストールすることで最適なレイヤーキャッシングを可能にするDockerイメージのビルドなどの状況で特に便利です。

The inverse --only-install-workspace can be used to install only workspace members, excluding all other dependencies.逆の --only-install-workspace は、すべての他の依存関係を除外して、ワークスペースメンバーのみ をインストールするために使用できます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上で適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON 環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS 環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--no-sources--no-sources

Ignore the tool.uv.sources table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any workspace, Git, URL, or local path sources依存関係を解決する際に tool.uv.sources テーブルを無視します。これは、ワークスペース、Git、URL、またはローカルパスソースを使用するのではなく、標準準拠の公開可能なパッケージメタデータに対してロックするために使用されます。

May also be set with the UV_NO_SOURCES environment variable.UV_NO_SOURCES 環境変数で設定することもできます。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.環境変数 UV_OFFLINE でも設定できます。

--only-dev--only-dev

Only include the development dependency group.開発依存関係グループのみを含めます。

The project and its dependencies will be omitted.プロジェクトとその依存関係は省略されます。

This option is an alias for --only-group dev. Implies --no-default-groups.このオプションは --only-group dev のエイリアスです。 --no-default-groups を含意します。

--only-group only-group--only-group only-group

Only include dependencies from the specified dependency group.指定された依存関係グループからのみ依存関係を含めます。

The project and its dependencies will be omitted.プロジェクトとその依存関係は省略されます。

May be provided multiple times. Implies --no-default-groups.複数回提供できます。 --no-default-groups を含意します。

--output-format output-format--output-format 出力形式

Select the output format出力形式を選択してください

[default: text][デフォルト: text]

Possible values:可能な値:

text: Display the result in a human-readable formattext: 結果を人間が読みやすい形式で表示します
json: Display the result in JSON formatjson: 結果をJSON形式で表示します

--package package--package パッケージ

Sync for specific packages in the workspace.ワークスペース内の特定のパッケージを同期します。

The workspace's environment (.venv) is updated to reflect the subset of dependencies declared by the specified workspace member packages.ワークスペースの環境（.venv）は、指定されたワークスペースメンバーのパッケージによって宣言された依存関係のサブセットを反映するように更新されます。

If any workspace member does not exist, uv will exit with an error.ワークスペースメンバーが存在しない場合、uvはエラーで終了します。

--prerelease prerelease--prerelease プレリリース

The strategy to use when considering pre-release versions.プレリリースバージョンを考慮する際に使用する戦略。

By default, uv will accept pre-releases for packages that only publish pre-releases, along with first-party requirements that contain an explicit pre-release marker in the declared specifiers (if-necessary-or-explicit).デフォルトでは、uvはプレリリースのみを公開するパッケージと、宣言された指定子に明示的なプレリリースマーカーを含むファーストパーティの要件に対してプレリリースを受け入れます (if-necessary-or-explicit)。

May also be set with the UV_PRERELEASE environment variable.また、UV_PRERELEASE 環境変数で設定することもできます。

Possible values:可能な値：

disallow: Disallow all pre-release versionsdisallow: すべてのプレリリースバージョンを禁止する
allow: Allow all pre-release versionsallow: すべてのプレリリースバージョンを許可する
if-necessary: Allow pre-release versions if all versions of a package are pre-releaseif-necessary: パッケージのすべてのバージョンがプレリリースである場合にプレリリースバージョンを許可する
explicit: Allow pre-release versions for first-party packages with explicit pre-release markers in their version requirementsexplicit: バージョン要件に明示的なプレリリースマーカーを持つファーストパーティパッケージに対してプレリリースバージョンを許可する
if-necessary-or-explicit: Allow pre-release versions if all versions of a package are pre-release, or if the package has an explicit pre-release marker in its version requirementsif-necessary-or-explicit: パッケージのすべてのバージョンがプレリリースである場合、またはパッケージのバージョン要件に明示的なプレリリースマーカーがある場合にプレリリースバージョンを許可する

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見され、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用される場合、効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数を使用して設定することもできます。

--python, -p python--python, -p python

The Python interpreter to use for the project environment.プロジェクト環境で使用するPythonインタープリタ。

By default, the first interpreter that meets the project's requires-python constraint is used.デフォルトでは、プロジェクトの requires-python 制約を満たす最初のインタープリタが使用されます。

If a Python interpreter in a virtual environment is provided, the packages will not be synced to the given environment. The interpreter will be used to create a virtual environment in the project.仮想環境にPythonインタプリタが提供されている場合、パッケージは指定された環境に同期されません。インタプリタはプロジェクト内で仮想環境を作成するために使用されます。

See uv python for details on Python discovery and supported request formats.uv pythonを参照して、Pythonの発見とサポートされているリクエスト形式の詳細を確認してください。

May also be set with the UV_PYTHON environment variable.UV_PYTHON環境変数を使用して設定することもできます。

--python-platform python-platform--python-platform python-platform

The platform for which requirements should be installed.要件をインストールすべきプラットフォーム。

Represented as a "target triple", a string that describes the target platform in terms of its CPU, vendor, and operating system name, like x86_64-unknown-linux-gnu or aarch64-apple-darwin.CPU、ベンダー、およびオペレーティングシステム名に関してターゲットプラットフォームを説明する文字列である「ターゲットトリプル」として表されます。例：x86_64-unknown-linux-gnuやaarch64-apple-darwin。

When targeting macOS (Darwin), the default minimum version is 13.0. Use MACOSX_DEPLOYMENT_TARGET to specify a different minimum version, e.g., 14.0.macOS（Darwin）をターゲットにする場合、デフォルトの最小バージョンは13.0です。異なる最小バージョンを指定するにはMACOSX_DEPLOYMENT_TARGETを使用します。例：14.0。

When targeting iOS, the default minimum version is 13.0. Use IPHONEOS_DEPLOYMENT_TARGET to specify a different minimum version, e.g., 14.0.iOSをターゲットにする場合、デフォルトの最小バージョンは13.0です。異なる最小バージョンを指定するにはIPHONEOS_DEPLOYMENT_TARGETを使用します。例：14.0。

When targeting Android, the default minimum Android API level is 24. Use ANDROID_API_LEVEL to specify a different minimum version, e.g., 26.Androidをターゲットにする場合、デフォルトの最小Android APIレベルは24です。異なる最小バージョンを指定するにはANDROID_API_LEVELを使用します。例：26。

WARNING: When specified, uv will select wheels that are compatible with the target platform; as a result, the installed distributions may not be compatible with the current platform. Conversely, any distributions that are built from source may be incompatible with the target platform, as they will be built for the current platform. The --python-platform option is intended for advanced use cases.警告：指定された場合、uvはターゲットプラットフォームと互換性のあるホイールを選択します。その結果、インストールされたディストリビューションは現在のプラットフォームと互換性がない可能性があります。逆に、ソースからビルドされたディストリビューションはターゲットプラットフォームと互換性がない可能性があります。なぜなら、それらは現在のプラットフォーム用にビルドされるからです。--python-platformオプションは、高度な使用ケースを想定しています。

Possible values:可能な値:

windows: An alias for x86_64-pc-windows-msvc, the default target for Windowswindows: x86_64-pc-windows-msvcのエイリアスで、Windowsのデフォルトターゲット
linux: An alias for x86_64-unknown-linux-gnu, the default target for Linuxlinux: x86_64-unknown-linux-gnuのエイリアスで、Linuxのデフォルトターゲット
macos: An alias for aarch64-apple-darwin, the default target for macOSmacos: aarch64-apple-darwinのエイリアスで、macOSのデフォルトターゲット
x86_64-pc-windows-msvc: A 64-bit x86 Windows targetx86_64-pc-windows-msvc: 64ビットx86 Windowsターゲット
aarch64-pc-windows-msvc: An ARM64 Windows targetaarch64-pc-windows-msvc: ARM64 Windowsターゲット
i686-pc-windows-msvc: A 32-bit x86 Windows targeti686-pc-windows-msvc: 32ビットx86 Windowsターゲット
x86_64-unknown-linux-gnu: An x86 Linux target. Equivalent to x86_64-manylinux_2_28x86_64-unknown-linux-gnu: x86 Linuxターゲット。x86_64-manylinux_2_28と同等
aarch64-apple-darwin: An ARM-based macOS target, as seen on Apple Silicon devicesaarch64-apple-darwin: Apple Siliconデバイスで見られるARMベースのmacOSターゲット
x86_64-apple-darwin: An x86 macOS targetx86_64-apple-darwin: x86 macOSターゲット
aarch64-unknown-linux-gnu: An ARM64 Linux target. Equivalent to aarch64-manylinux_2_28aarch64-unknown-linux-gnu: ARM64 Linux ターゲット。aarch64-manylinux_2_28 と同等。
aarch64-unknown-linux-musl: An ARM64 Linux targetaarch64-unknown-linux-musl: ARM64 Linux ターゲット。
x86_64-unknown-linux-musl: An x86_64 Linux targetx86_64-unknown-linux-musl: x86_64 Linux ターゲット。
riscv64-unknown-linux: A RISCV64 Linux targetriscv64-unknown-linux: RISCV64 Linux ターゲット。
x86_64-manylinux2014: An x86_64 target for the manylinux2014 platform. Equivalent to x86_64-manylinux_2_17x86_64-manylinux2014: x86_64 ターゲットで、manylinux2014 プラットフォーム用。x86_64-manylinux_2_17 と同等。
x86_64-manylinux_2_17: An x86_64 target for the manylinux_2_17 platformx86_64-manylinux_2_17: x86_64 ターゲットで、manylinux_2_17 プラットフォーム用。
x86_64-manylinux_2_28: An x86_64 target for the manylinux_2_28 platformx86_64-manylinux_2_28: x86_64 ターゲットで、manylinux_2_28 プラットフォーム用。
x86_64-manylinux_2_31: An x86_64 target for the manylinux_2_31 platformx86_64-manylinux_2_31: x86_64 ターゲットで、manylinux_2_31 プラットフォーム用。
x86_64-manylinux_2_32: An x86_64 target for the manylinux_2_32 platformx86_64-manylinux_2_32: x86_64 ターゲットで、manylinux_2_32 プラットフォーム用。
x86_64-manylinux_2_33: An x86_64 target for the manylinux_2_33 platformx86_64-manylinux_2_33: x86_64 ターゲットで、manylinux_2_33 プラットフォーム用。
x86_64-manylinux_2_34: An x86_64 target for the manylinux_2_34 platformx86_64-manylinux_2_34: x86_64 ターゲットの manylinux_2_34 プラットフォーム
x86_64-manylinux_2_35: An x86_64 target for the manylinux_2_35 platformx86_64-manylinux_2_35: x86_64 ターゲットの manylinux_2_35 プラットフォーム
x86_64-manylinux_2_36: An x86_64 target for the manylinux_2_36 platformx86_64-manylinux_2_36: x86_64 ターゲットの manylinux_2_36 プラットフォーム
x86_64-manylinux_2_37: An x86_64 target for the manylinux_2_37 platformx86_64-manylinux_2_37: x86_64 ターゲットの manylinux_2_37 プラットフォーム
x86_64-manylinux_2_38: An x86_64 target for the manylinux_2_38 platformx86_64-manylinux_2_38: x86_64 ターゲットの manylinux_2_38 プラットフォーム
x86_64-manylinux_2_39: An x86_64 target for the manylinux_2_39 platformx86_64-manylinux_2_39: x86_64 ターゲットの manylinux_2_39 プラットフォーム
x86_64-manylinux_2_40: An x86_64 target for the manylinux_2_40 platformx86_64-manylinux_2_40: x86_64 ターゲットの manylinux_2_40 プラットフォーム
aarch64-manylinux2014: An ARM64 target for the manylinux2014 platform. Equivalent to aarch64-manylinux_2_17aarch64-manylinux2014: ARM64 ターゲットの manylinux2014 プラットフォーム。aarch64-manylinux_2_17 と同等
aarch64-manylinux_2_17: An ARM64 target for the manylinux_2_17 platformaarch64-manylinux_2_17: ARM64 ターゲットの manylinux_2_17 プラットフォーム
aarch64-manylinux_2_28: An ARM64 target for the manylinux_2_28 platformaarch64-manylinux_2_28: ARM64 ターゲットの manylinux_2_28 プラットフォーム
aarch64-manylinux_2_31: An ARM64 target for the manylinux_2_31 platformaarch64-manylinux_2_31: manylinux_2_31 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_32: An ARM64 target for the manylinux_2_32 platformaarch64-manylinux_2_32: manylinux_2_32 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_33: An ARM64 target for the manylinux_2_33 platformaarch64-manylinux_2_33: manylinux_2_33 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_34: An ARM64 target for the manylinux_2_34 platformaarch64-manylinux_2_34: manylinux_2_34 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_35: An ARM64 target for the manylinux_2_35 platformaarch64-manylinux_2_35: manylinux_2_35 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_36: An ARM64 target for the manylinux_2_36 platformaarch64-manylinux_2_36: manylinux_2_36 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_37: An ARM64 target for the manylinux_2_37 platformaarch64-manylinux_2_37: manylinux_2_37 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_38: An ARM64 target for the manylinux_2_38 platformaarch64-manylinux_2_38: manylinux_2_38 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_39: An ARM64 target for the manylinux_2_39 platformaarch64-manylinux_2_39: manylinux_2_39 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_40: An ARM64 target for the manylinux_2_40 platformaarch64-manylinux_2_40: manylinux_2_40 プラットフォーム用の ARM64 ターゲット
aarch64-linux-android: An ARM64 Android targetaarch64-linux-android: ARM64 Android ターゲット
x86_64-linux-android: An x86_64 Android targetx86_64-linux-android: x86_64 Android ターゲット
wasm32-pyodide2024: A wasm32 target using the Pyodide 2024 platform. Meant for use with Python 3.12wasm32-pyodide2024: Pyodide 2024 プラットフォームを使用した wasm32 ターゲット。Python 3.12 用に設計されています。
arm64-apple-ios: An ARM64 target for iOS devicearm64-apple-ios: iOS デバイス用の ARM64 ターゲット
arm64-apple-ios-simulator: An ARM64 target for iOS simulatorarm64-apple-ios-simulator: iOS シミュレーター用の ARM64 ターゲット
x86_64-apple-ios-simulator: An x86_64 target for iOS simulatorx86_64-apple-ios-simulator: iOS シミュレーター用の x86_64 ターゲット

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uv が stdout に出力しないサイレントモードを有効にします。

--refresh--refresh

Refresh all cached dataすべてのキャッシュデータを更新

--refresh-package refresh-package--refresh-package refresh-package

Refresh cached data for a specific package特定のパッケージのキャッシュデータを更新

--reinstall, --force-reinstall--reinstall, --force-reinstall

Reinstall all packages, regardless of whether they're already installed. Implies --refreshすべてのパッケージを再インストールします。すでにインストールされているかどうかに関係なく。--refreshを含意します。

--reinstall-package reinstall-package--reinstall-package reinstall-package

Reinstall a specific package, regardless of whether it's already installed. Implies --refresh-package特定のパッケージを再インストールします。すでにインストールされているかどうかに関係なく。--refresh-packageを含意します。

--resolution resolution--resolution resolution

The strategy to use when selecting between the different compatible versions for a given package requirement.特定のパッケージ要件に対して異なる互換バージョンを選択する際に使用する戦略。

By default, uv will use the latest compatible version of each package (highest).デフォルトでは、uvは各パッケージの最新の互換バージョンを使用します (highest)。

May also be set with the UV_RESOLUTION environment variable.また、UV_RESOLUTION 環境変数で設定することもできます。

Possible values:可能な値：

highest: Resolve the highest compatible version of each packagehighest: 各パッケージの最高の互換性のあるバージョンを解決します。
lowest: Resolve the lowest compatible version of each packagelowest: 各パッケージの最低の互換性のあるバージョンを解決します。
lowest-direct: Resolve the lowest compatible version of any direct dependencies, and the highest compatible version of any transitive dependencieslowest-direct: 直接依存関係の最低の互換性のあるバージョンを解決し、間接依存関係の最高の互換性のあるバージョンを解決します。

--script script--script script

Sync the environment for a Python script, rather than the current project.現在のプロジェクトではなく、Python スクリプトのために環境を同期します。

If provided, uv will sync the dependencies based on the script's inline metadata table, in adherence with PEP 723.提供された場合、uv はスクリプトのインラインメタデータテーブルに基づいて依存関係を同期し、PEP 723 に従います。

--upgrade, -U--upgrade, -U

Allow package upgrades, ignoring pinned versions in any existing output file. Implies --refreshパッケージのアップグレードを許可し、既存の出力ファイルの固定されたバージョンを無視します。--refresh を暗示します。

--upgrade-package, -P upgrade-package--upgrade-package, -P upgrade-package

Allow upgrades for a specific package, ignoring pinned versions in any existing output file. Implies --refresh-package特定のパッケージのアップグレードを許可し、既存の出力ファイルに固定されたバージョンを無視します。--refresh-packageを含意します。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)環境変数RUST_LOGを使用して、詳細なロギングを構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv lockuv lock

Update the project's lockfile.プロジェクトのロックファイルを更新します。

If the project lockfile (uv.lock) does not exist, it will be created. If a lockfile is present, its contents will be used as preferences for the resolution.プロジェクトのロックファイル（uv.lock）が存在しない場合は、作成されます。ロックファイルが存在する場合、その内容は解決の優先事項として使用されます。

If there are no changes to the project's dependencies, locking will have no effect unless the --upgrade flag is provided.プロジェクトの依存関係に変更がない場合、--upgradeフラグが提供されない限り、ロックは効果を持ちません。

Usage使用法

uv lock [OPTIONS]

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）を受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、検証されたソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvにデフォルト設定され、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されます。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数で設定することもできます。

--check--check

Check if the lockfile is up-to-date.ロックファイルが最新であるかを確認します。

Asserts that the uv.lock would remain unchanged after a resolution. If the lockfile is missing or needs to be updated, uv will exit with an error.uv.lockが解決後も変更されないことを主張します。ロックファイルが存在しないか、更新が必要な場合、uvはエラーで終了します。

Equivalent to --locked.--lockedと同等です。

--check-exists, --frozen--check-exists, --frozen

Assert that a uv.lock exists without checking if it is up-to-date.ロックファイルuv.lockが存在することを確認しますが、最新であるかは確認しません。

Equivalent to --frozen.--frozenと同等です。

May also be set with the UV_FROZEN environment variable.UV_FROZEN環境変数で設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末への書き込み時に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力がサポートされている端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用するuv.tomlファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.また、UV_CONFIG_FILE 環境変数で設定することもできます。

--config-setting, --config-settings, -C config-setting--config-setting, --config-settings, -C config-setting

Settings to pass to the PEP 517 build backend, specified as KEY=VALUE pairsPEP 517 ビルドバックエンドに渡す設定で、KEY=VALUE ペアとして指定します。

--config-settings-package, --config-settings-package config-settings-package--config-settings-package, --config-settings-package config-settings-package

Settings to pass to the PEP 517 build backend for a specific package, specified as PACKAGE:KEY=VALUE pairs特定のパッケージに対して PEP 517 ビルドバックエンドに渡す設定で、PACKAGE:KEY=VALUE ペアとして指定します。

--default-index default-index--default-index default-index

The URL of the default package index (by default: https://pypi.org/simple).デフォルトのパッケージインデックスの URL（デフォルト: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリ API）に準拠したリポジトリ、または同じ形式で配置されたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --index flag.このフラグで指定されたインデックスは、--index フラグで指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_DEFAULT_INDEX environment variable.また、UV_DEFAULT_INDEX 環境変数で設定することもできます。

--directory directory--directory ディレクトリ

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数を使用して設定することもできます。

--dry-run--dry-run

Perform a dry run, without writing the lockfile.ロックファイルを書き込まずにドライランを実行します。

In dry-run mode, uv will resolve the project's dependencies and report on the resulting changes, but will not write the lockfile to disk.ドライランモードでは、uvはプロジェクトの依存関係を解決し、結果の変更を報告しますが、ロックファイルをディスクに書き込みません。

--exclude-newer exclude-newer--exclude-newer exclude-newer

Limit candidate packages to those that were uploaded prior to the given date.候補パッケージを、指定された日付以前にアップロードされたものに制限します。

Accepts both RFC 3339 timestamps (e.g., 2006-12-02T02:07:43Z) and local dates in the same format (e.g., 2006-12-02) in your system's configured time zone.RFC 3339 タイムスタンプ（例：2006-12-02T02:07:43Z）と、システムの設定されたタイムゾーンでの同じ形式のローカル日付（例：2006-12-02）の両方を受け入れます。

May also be set with the UV_EXCLUDE_NEWER environment variable.UV_EXCLUDE_NEWER 環境変数で設定することもできます。

--exclude-newer-package exclude-newer-package--exclude-newer-package exclude-newer-package

Limit candidate packages for a specific package to those that were uploaded prior to the given date.特定のパッケージの候補パッケージを、指定された日付以前にアップロードされたものに制限します。

Accepts package-date pairs in the format PACKAGE=DATE, where DATE is an RFC 3339 timestamp (e.g., 2006-12-02T02:07:43Z) or local date (e.g., 2006-12-02) in your system's configured time zone.PACKAGE=DATE 形式のパッケージ-日付ペアを受け入れます。ここで、DATE は RFC 3339 タイムスタンプ（例：2006-12-02T02:07:43Z）またはローカル日付（例：2006-12-02）で、システムの設定されたタイムゾーンに基づきます。

Can be provided multiple times for different packages.異なるパッケージのために複数回提供することができます。

--extra-index-url extra-index-url--extra-index-url extra-index-url

(Deprecated: use --index instead) Extra URLs of package indexes to use, in addition to --index-url.(非推奨：代わりに --index を使用してください) --index-url に加えて使用するパッケージインデックスの追加URL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリのいずれかを受け入れます。

All indexes provided via this flag take priority over the index specified by --index-url (which defaults to PyPI). When multiple --extra-index-url flags are provided, earlier values take priority.このフラグを介して提供されたすべてのインデックスは、--index-url（デフォルトは PyPI）で指定されたインデックスよりも優先されます。複数の --extra-index-url フラグが提供される場合、先に指定された値が優先されます。

May also be set with the UV_EXTRA_INDEX_URL environment variable.環境変数 UV_EXTRA_INDEX_URL でも設定できます。

--find-links, -f find-links--find-links, -f find-links

Locations to search for candidate distributions, in addition to those found in the registry indexes.レジストリインデックスで見つかったものに加えて、候補となる配布物を検索する場所。

If a path, the target must be a directory that contains packages as wheel files (.whl) or source distributions (e.g., .tar.gz or .zip) at the top level.パスの場合、ターゲットはトップレベルにホイールファイル (.whl) またはソース配布物 (例: .tar.gz または .zip) を含むディレクトリでなければなりません。

If a URL, the page must contain a flat list of links to package files adhering to the formats described above.URLの場合、そのページには上記の形式に従ったパッケージファイルへのリンクのフラットリストが含まれている必要があります。

May also be set with the UV_FIND_LINKS environment variable.環境変数 UV_FIND_LINKS でも設定できます。

--fork-strategy fork-strategy--fork-strategy fork-strategy

The strategy to use when selecting multiple versions of a given package across Python versions and platforms.特定のパッケージの複数のバージョンをPythonのバージョンやプラットフォームにわたって選択する際に使用する戦略。

By default, uv will optimize for selecting the latest version of each package for each supported Python version (requires-python), while minimizing the number of selected versions across platforms.デフォルトでは、uvは各サポートされているPythonバージョン (requires-python) に対して各パッケージの最新バージョンを選択することを最適化し、プラットフォーム間で選択されたバージョンの数を最小限に抑えます。

Under fewest, uv will minimize the number of selected versions for each package, preferring older versions that are compatible with a wider range of supported Python versions or platforms.fewest の場合、uvは各パッケージの選択されたバージョンの数を最小限に抑え、より広範囲のサポートされているPythonバージョンやプラットフォームと互換性のある古いバージョンを優先します。

May also be set with the UV_FORK_STRATEGY environment variable.環境変数 UV_FORK_STRATEGY でも設定できます。

Possible values:可能な値：

fewest: Optimize for selecting the fewest number of versions for each package. Older versions may be preferred if they are compatible with a wider range of supported Python versions or platformsfewest: 各パッケージのバージョン数を最小限に抑えるよう最適化します。古いバージョンは、より広範囲のサポートされているPythonバージョンやプラットフォームと互換性がある場合に優先されることがあります。
requires-python: Optimize for selecting latest supported version of each package, for each supported Python versionrequires-python: 各サポートされているPythonバージョンに対して、各パッケージの最新のサポートバージョンを選択するよう最適化します。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--index index--index index

The URLs to use when resolving dependencies, in addition to the default index.デフォルトのインデックスに加えて、依存関係を解決する際に使用するURLです。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリまたは同じ形式でレイアウトされたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --default-index (which defaults to PyPI). When multiple --index flags are provided, earlier values take priority.このフラグを介して提供されるすべてのインデックスは、--default-index（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の--indexフラグが提供される場合、早い値が優先されます。

Index names are not supported as values. Relative paths must be disambiguated from index names with ./ or ../ on Unix or .\\, ..\\, ./ or ../ on Windows.インデックス名は値としてサポートされていません。相対パスは、Unixでは./または../、Windowsでは.\\、..\\、./または../を使用してインデックス名と区別する必要があります。

May also be set with the UV_INDEX environment variable.UV_INDEX環境変数を使用して設定することもできます。

--index-strategy index-strategy--index-strategy index-strategy

The strategy to use when resolving against multiple index URLs.複数のインデックスURLに対して解決する際に使用する戦略。

By default, uv will stop at the first index on which a given package is available, and limit resolutions to those present on that first index (first-index). This prevents "dependency confusion" attacks, whereby an attacker can upload a malicious package under the same name to an alternate index.デフォルトでは、uvは指定されたパッケージが利用可能な最初のインデックスで停止し、その最初のインデックスに存在するものに解決を制限します（first-index）。これにより、攻撃者が同じ名前の悪意のあるパッケージを別のインデックスにアップロードすることによる「依存関係の混乱」攻撃を防ぎます。

May also be set with the UV_INDEX_STRATEGY environment variable.UV_INDEX_STRATEGY環境変数を使用して設定することもできます。

Possible values:可能な値：

first-index: Only use results from the first index that returns a match for a given package namefirst-index: 指定されたパッケージ名に対して一致を返す最初のインデックスからの結果のみを使用します。
unsafe-first-match: Search for every package name across all indexes, exhausting the versions from the first index before moving on to the nextunsafe-first-match: すべてのインデックスで各パッケージ名を検索し、次のインデックスに移動する前に最初のインデックスからのバージョンを使い果たします。
unsafe-best-match: Search for every package name across all indexes, preferring the "best" version found. If a package version is in multiple indexes, only look at the entry for the first indexunsafe-best-match: すべてのインデックスで各パッケージ名を検索し、見つかった「最良」のバージョンを優先します。パッケージバージョンが複数のインデックスに存在する場合、最初のインデックスのエントリのみを確認します。

--index-url, -i index-url--index-url, -i index-url

(Deprecated: use --default-index instead) The URL of the Python package index (by default: https://pypi.org/simple).(非推奨: 代わりに --default-index を使用してください) PythonパッケージインデックスのURL（デフォルト: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --extra-index-url flag.このフラグで指定されたインデックスは、--extra-index-urlフラグを介して指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_INDEX_URL environment variable.UV_INDEX_URL 環境変数で設定することもできます。

--keyring-provider keyring-provider--keyring-provider keyring-provider

Attempt to use keyring for authentication for index URLs.インデックスURLの認証に keyring を使用しようとします。

At present, only --keyring-provider subprocess is supported, which configures uv to use the keyring CLI to handle authentication.現在のところ、--keyring-provider subprocess のみがサポートされており、これはuvが認証を処理するためにkeyring CLIを使用するように設定します。

Defaults to disabled.デフォルトは disabled です。

May also be set with the UV_KEYRING_PROVIDER environment variable.UV_KEYRING_PROVIDER 環境変数で設定することもできます。

Possible values:可能な値：

disabled: Do not use keyring for credential lookupdisabled: キーリングを使用して資格情報を検索しない
subprocess: Use the keyring command for credential lookupsubprocess: 資格情報の検索にkeyringコマンドを使用する

--link-mode link-mode--link-mode link-mode

The method to use when installing packages from the global cache.グローバルキャッシュからパッケージをインストールする際に使用する方法。

This option is only used when building source distributions.このオプションは、ソース配布をビルドする際にのみ使用されます。

Defaults to clone (also known as Copy-on-Write) on macOS, and hardlink on Linux and Windows.macOSではclone（コピーオンライトとも呼ばれる）に、LinuxおよびWindowsではhardlinkにデフォルト設定されています。

WARNING: The use of symlink link mode is discouraged, as they create tight coupling between the cache and the target environment. For example, clearing the cache (uv cache clean) will break all installed packages by way of removing the underlying source files. Use symlinks with caution.警告：シンボリックリンクモードの使用は推奨されません。キャッシュとターゲット環境の間に密接な結合を生じさせるためです。たとえば、キャッシュをクリアする（uv cache clean）と、基盤となるソースファイルが削除されるため、すべてのインストールされたパッケージが壊れます。シンボリックリンクは注意して使用してください。

May also be set with the UV_LINK_MODE environment variable.UV_LINK_MODE環境変数でも設定できます。

Possible values:可能な値：

clone: Clone (i.e., copy-on-write) packages from the wheel into the site-packages directoryclone: ホイールからsite-packagesディレクトリにパッケージをクローン（すなわち、コピーオンライト）します。
copy: Copy packages from the wheel into the site-packages directorycopy: ホイールからsite-packagesディレクトリにパッケージをコピーします。
hardlink: Hard link packages from the wheel into the site-packages directoryhardlink: ホイールからsite-packagesディレクトリにパッケージをハードリンクします。
symlink: Symbolically link packages from the wheel into the site-packages directorysymlink: ホイールからsite-packagesディレクトリにパッケージをシンボリックリンクします。

--managed-python--managed-python

Require use of uv-managed Python versions.uv管理のPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理しているPythonバージョンの使用を優先します。ただし、uv管理のPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、プラットフォームのネイティブ証明書ストアを使用したいことがあります。特に、システムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合です。

May also be set with the UV_NATIVE_TLS environment variable.UV_NATIVE_TLS環境変数で設定することもできます。

--no-binary--no-binary

Don't install pre-built wheels.事前にビルドされたホイールをインストールしないでください。

The given packages will be built and installed from source. The resolver will still use pre-built wheels to extract package metadata, if available.指定されたパッケージはソースからビルドされ、インストールされます。リゾルバは、利用可能な場合、パッケージメタデータを抽出するために事前にビルドされたホイールを使用します。

May also be set with the UV_NO_BINARY environment variable.UV_NO_BINARY環境変数で設定することもできます。

--no-binary-package no-binary-package--no-binary-package no-binary-package

Don't install pre-built wheels for a specific package特定のパッケージに対して事前にビルドされたホイールをインストールしないでください。

May also be set with the UV_NO_BINARY_PACKAGE environment variable.UV_NO_BINARY_PACKAGE環境変数で設定することもできます。

--no-build--no-build

Don't build source distributions.ソース配布物のビルドを行いません。

When enabled, resolving will not run arbitrary Python code. The cached wheels of already-built source distributions will be reused, but operations that require building distributions will exit with an error.有効にすると、解決時に任意のPythonコードが実行されません。既にビルドされたソース配布物のキャッシュされたホイールが再利用されますが、配布物のビルドを必要とする操作はエラーで終了します。

May also be set with the UV_NO_BUILD environment variable.UV_NO_BUILD 環境変数でも設定できます。

--no-build-isolation--no-build-isolation

Disable isolation when building source distributions.ソース配布物のビルド時に隔離を無効にします。

Assumes that build dependencies specified by PEP 518 are already installed.PEP 518で指定されたビルド依存関係が既にインストールされていると仮定します。

May also be set with the UV_NO_BUILD_ISOLATION environment variable.UV_NO_BUILD_ISOLATION 環境変数でも設定できます。

--no-build-isolation-package no-build-isolation-package--no-build-isolation-package no-build-isolation-package

Disable isolation when building source distributions for a specific package.特定のパッケージのソース配布物をビルドする際に隔離を無効にします。

Assumes that the packages' build dependencies specified by PEP 518 are already installed.PEP 518で指定されたパッケージのビルド依存関係がすでにインストールされていることを前提とします。

--no-build-package no-build-package--no-build-package no-build-package

Don't build source distributions for a specific package特定のパッケージのソース配布物をビルドしない

May also be set with the UV_NO_BUILD_PACKAGE environment variable.環境変数UV_NO_BUILD_PACKAGEでも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.環境変数UV_NO_CACHEでも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml, uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.環境変数 UV_NO_CONFIG でも設定できます。

--no-index--no-index

Ignore the registry index (e.g., PyPI), instead relying on direct URL dependencies and those provided via --find-linksレジストリインデックス（例：PyPI）を無視し、代わりに直接URL依存関係と --find-links を介して提供されるものに依存します。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.環境変数 UV_NO_MANAGED_PYTHON でも設定できます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなど。

May also be set with the UV_NO_PROGRESS environment variable.環境変数 UV_NO_PROGRESS でも設定できます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--no-sources--no-sources

Ignore the tool.uv.sources table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any workspace, Git, URL, or local path sources依存関係を解決する際に tool.uv.sources テーブルを無視します。ワークスペース、Git、URL、またはローカルパスソースを使用するのではなく、標準準拠の公開可能なパッケージメタデータに対してロックするために使用されます。

May also be set with the UV_NO_SOURCES environment variable.環境変数 UV_NO_SOURCES でも設定できます。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.環境変数 UV_OFFLINE でも設定できます。

--prerelease prerelease--prerelease プレリリース

The strategy to use when considering pre-release versions.プレリリースバージョンを考慮する際に使用する戦略。

By default, uv will accept pre-releases for packages that only publish pre-releases, along with first-party requirements that contain an explicit pre-release marker in the declared specifiers (if-necessary-or-explicit).デフォルトでは、uvはプレリリースのみを公開するパッケージと、宣言された指定子に明示的なプレリリースマーカーを含むファーストパーティの要件に対してプレリリースを受け入れます (if-necessary-or-explicit)。

May also be set with the UV_PRERELEASE environment variable.UV_PRERELEASE 環境変数でも設定できます。

Possible values:可能な値：

disallow: Disallow all pre-release versionsdisallow: すべてのプレリリースバージョンを禁止する
allow: Allow all pre-release versionsallow: すべてのプレリリースバージョンを許可する
if-necessary: Allow pre-release versions if all versions of a package are pre-releaseif-necessary: パッケージのすべてのバージョンがプレリリースである場合にプレリリースバージョンを許可する
explicit: Allow pre-release versions for first-party packages with explicit pre-release markers in their version requirementsexplicit: バージョン要件に明示的なプレリリースマーカーを持つファーストパーティパッケージに対してプレリリースバージョンを許可する
if-necessary-or-explicit: Allow pre-release versions if all versions of a package are pre-release, or if the package has an explicit pre-release marker in its version requirementsif-necessary-or-explicit: パッケージのすべてのバージョンがプレリリースである場合、またはパッケージのバージョン要件に明示的なプレリリースマーカーがある場合にプレリリースバージョンを許可する

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用される場合、効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数を使用して設定することもできます。

--python, -p python--python, -p python

The Python interpreter to use during resolution.解決中に使用するPythonインタープリタ。

A Python interpreter is required for building source distributions to determine package metadata when there are not wheels.ホイールがない場合、パッケージメタデータを決定するためにソース配布をビルドするにはPythonインタープリタが必要です。

The interpreter is also used as the fallback value for the minimum Python version if requires-python is not set.インタプリタは、requires-pythonが設定されていない場合の最小Pythonバージョンのフォールバック値としても使用されます。

See uv python for details on Python discovery and supported request formats.uv pythonの詳細については、Pythonの発見とサポートされているリクエスト形式を参照してください。

May also be set with the UV_PYTHON environment variable.UV_PYTHON環境変数でも設定できます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば-qq、uvはstdoutに出力を行わないサイレントモードを有効にします。

--refresh--refresh

Refresh all cached dataすべてのキャッシュデータを更新します。

--refresh-package refresh-package--refresh-package refresh-package

Refresh cached data for a specific package特定のパッケージのキャッシュデータを更新します。

--resolution resolution--resolution 解像度

The strategy to use when selecting between the different compatible versions for a given package requirement.特定のパッケージ要件に対して異なる互換バージョンを選択する際に使用する戦略。

By default, uv will use the latest compatible version of each package (highest).デフォルトでは、uvは各パッケージの最新の互換バージョンを使用します (highest)。

May also be set with the UV_RESOLUTION environment variable.UV_RESOLUTION 環境変数で設定することもできます。

Possible values:可能な値：

highest: Resolve the highest compatible version of each packagehighest: 各パッケージの最高の互換バージョンを解決します
lowest: Resolve the lowest compatible version of each packagelowest: 各パッケージの最低の互換バージョンを解決します
lowest-direct: Resolve the lowest compatible version of any direct dependencies, and the highest compatible version of any transitive dependencieslowest-direct: 直接依存関係の最低の互換バージョンを解決し、間接依存関係の最高の互換バージョンを解決します

--script script--script スクリプト

Lock the specified Python script, rather than the current project.現在のプロジェクトではなく、指定されたPythonスクリプトをロックします。

If provided, uv will lock the script (based on its inline metadata table, in adherence with PEP 723) to a .lock file adjacent to the script itself.提供された場合、uvはスクリプトをロックします（そのインラインメタデータテーブルに基づき、PEP 723に従います）.lockファイルをスクリプト自体の隣に作成します。

--upgrade, -U--upgrade, -U

Allow package upgrades, ignoring pinned versions in any existing output file. Implies --refreshパッケージのアップグレードを許可し、既存の出力ファイルにある固定バージョンを無視します。--refreshを含意します。

--upgrade-package, -P upgrade-package--upgrade-package, -P upgrade-package

Allow upgrades for a specific package, ignoring pinned versions in any existing output file. Implies --refresh-package特定のパッケージのアップグレードを許可し、既存の出力ファイルにある固定バージョンを無視します。--refresh-packageを含意します。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)環境変数RUST_LOGを使用して、細かいログ記録を設定できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv exportuv export

Export the project's lockfile to an alternate format.プロジェクトのロックファイルを別の形式にエクスポートします。

At present, both requirements.txt and pylock.toml (PEP 751) formats are supported.現在、両方の requirements.txt と pylock.toml (PEP 751) フォーマットがサポートされています。

The project is re-locked before exporting unless the --locked or --frozen flag is provided.--locked または --frozen フラグが指定されない限り、プロジェクトはエクスポート前に再ロックされます。

uv will search for a project in the current directory or any parent directory. If a project cannot be found, uv will exit with an error.uv は現在のディレクトリまたは親ディレクトリ内でプロジェクトを検索します。プロジェクトが見つからない場合、uv はエラーで終了します。

If operating in a workspace, the root will be exported by default; however, specific members can be selected using the --package option.ワークスペースで操作している場合、ルートはデフォルトでエクスポートされます。ただし、特定のメンバーは --package オプションを使用して選択できます。

Usage使用法

uv export [OPTIONS]

Optionsオプション

--all-extras--all-extras

Include all optional dependenciesすべてのオプション依存関係を含める

--all-groups--all-groups

Include dependencies from all dependency groups.すべての依存関係グループから依存関係を含める。

--no-group can be used to exclude specific groups.--no-groupを使用して特定のグループを除外できます。

--all-packages--all-packages

Export the entire workspace.ワークスペース全体をエクスポートします。

The dependencies for all workspace members will be included in the exported requirements file.すべてのワークスペースメンバーの依存関係がエクスポートされた要件ファイルに含まれます。

Any extras or groups specified via --extra, --group, or related options will be applied to all workspace members.--extra、--group、または関連オプションを介して指定された追加やグループは、すべてのワークスペースメンバーに適用されます。

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host、--trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回提供できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホストポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.また、UV_INSECURE_HOST 環境変数で設定することもできます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvにデフォルト設定され、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されます。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.また、UV_CACHE_DIR 環境変数で設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末に書き込む際に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力が端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.uv.tomlファイルのパスを設定に使用します。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数を使用して設定することもできます。

--config-setting, --config-settings, -C config-setting--config-setting, --config-settings, -C config-setting

Settings to pass to the PEP 517 build backend, specified as KEY=VALUE pairsPEP 517ビルドバックエンドに渡す設定で、KEY=VALUEペアとして指定します。

--config-settings-package, --config-settings-package config-settings-package--config-settings-package, --config-settings-package config-settings-package

Settings to pass to the PEP 517 build backend for a specific package, specified as PACKAGE:KEY=VALUE pairs特定のパッケージのためにPEP 517ビルドバックエンドに渡す設定で、PACKAGE:KEY=VALUEペアとして指定されます。

--default-index default-index--default-index default-index

The URL of the default package index (by default: https://pypi.org/simple).デフォルトのパッケージインデックスのURL（デフォルトでは: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --index flag.このフラグで指定されたインデックスは、--indexフラグで指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_DEFAULT_INDEX environment variable.UV_DEFAULT_INDEX環境変数で設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準として解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.環境変数 UV_WORKING_DIRECTORY でも設定できます。

--exclude-newer exclude-newer--exclude-newer exclude-newer

Limit candidate packages to those that were uploaded prior to the given date.候補パッケージを指定された日付以前にアップロードされたものに制限します。

Accepts both RFC 3339 timestamps (e.g., 2006-12-02T02:07:43Z) and local dates in the same format (e.g., 2006-12-02) in your system's configured time zone.RFC 3339 タイムスタンプ（例: 2006-12-02T02:07:43Z）と、システムの設定されたタイムゾーンでの同じ形式のローカル日付（例: 2006-12-02）の両方を受け入れます。

May also be set with the UV_EXCLUDE_NEWER environment variable.環境変数 UV_EXCLUDE_NEWER でも設定できます。

--exclude-newer-package exclude-newer-package--exclude-newer-package exclude-newer-package

Limit candidate packages for a specific package to those that were uploaded prior to the given date.特定のパッケージの候補パッケージを、指定された日付以前にアップロードされたものに制限します。

Accepts package-date pairs in the format PACKAGE=DATE, where DATE is an RFC 3339 timestamp (e.g., 2006-12-02T02:07:43Z) or local date (e.g., 2006-12-02) in your system's configured time zone.形式 PACKAGE=DATE のパッケージ日付ペアを受け入れます。ここで DATE は RFC 3339 タイムスタンプ（例: 2006-12-02T02:07:43Z）またはローカル日付（例: 2006-12-02）で、システムの設定されたタイムゾーンに基づきます。

Can be provided multiple times for different packages.異なるパッケージのために複数回提供できます。

--extra extra--extra extra

Include optional dependencies from the specified extra name.指定された追加名からオプションの依存関係を含めます。

May be provided more than once.複数回提供される場合があります。

--extra-index-url extra-index-url--extra-index-url extra-index-url

(Deprecated: use --index instead) Extra URLs of package indexes to use, in addition to --index-url.(非推奨: 代わりに --index を使用してください) --index-url に加えて使用するパッケージインデックスの追加URL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --index-url (which defaults to PyPI). When multiple --extra-index-url flags are provided, earlier values take priority.このフラグを介して提供されたすべてのインデックスは、--index-url（デフォルトはPyPI）によって指定されたインデックスよりも優先されます。複数の --extra-index-url フラグが提供される場合、先に指定された値が優先されます。

May also be set with the UV_EXTRA_INDEX_URL environment variable.UV_EXTRA_INDEX_URL 環境変数を使用して設定することもできます。

--find-links, -f find-links--find-links, -f find-links

Locations to search for candidate distributions, in addition to those found in the registry indexes.レジストリインデックスで見つかったものに加えて、候補の配布物を検索する場所。

If a path, the target must be a directory that contains packages as wheel files (.whl) or source distributions (e.g., .tar.gz or .zip) at the top level.パスの場合、ターゲットはトップレベルにホイールファイル（.whl）またはソース配布（例: .tar.gz または .zip）を含むディレクトリでなければなりません。

If a URL, the page must contain a flat list of links to package files adhering to the formats described above.URLの場合、ページには上記の形式に従ったパッケージファイルへのリンクのフラットリストが含まれている必要があります。

May also be set with the UV_FIND_LINKS environment variable.また、UV_FIND_LINKS 環境変数で設定することもできます。

--fork-strategy fork-strategy--fork-strategy fork-strategy

The strategy to use when selecting multiple versions of a given package across Python versions and platforms.特定のパッケージの複数のバージョンをPythonのバージョンやプラットフォームにわたって選択する際に使用する戦略。

By default, uv will optimize for selecting the latest version of each package for each supported Python version (requires-python), while minimizing the number of selected versions across platforms.デフォルトでは、uvは各サポートされているPythonバージョン（requires-python）ごとに各パッケージの最新バージョンを選択することを最適化し、プラットフォーム間で選択されたバージョンの数を最小限に抑えます。

Under fewest, uv will minimize the number of selected versions for each package, preferring older versions that are compatible with a wider range of supported Python versions or platforms.fewest の下では、uvは各パッケージの選択されたバージョンの数を最小限に抑え、より広範囲のサポートされているPythonバージョンやプラットフォームと互換性のある古いバージョンを優先します。

May also be set with the UV_FORK_STRATEGY environment variable.また、UV_FORK_STRATEGY 環境変数で設定することもできます。

Possible values:可能な値：

fewest: Optimize for selecting the fewest number of versions for each package. Older versions may be preferred if they are compatible with a wider range of supported Python versions or platformsfewest: 各パッケージのバージョン数を最小限に抑えることを最適化します。より広範囲のサポートされているPythonバージョンやプラットフォームと互換性がある場合、古いバージョンが優先されることがあります。
requires-python: Optimize for selecting latest supported version of each package, for each supported Python versionrequires-python: 各サポートされているPythonバージョンごとに各パッケージの最新のサポートバージョンを選択することを最適化します。

--format format--format フォーマット

The format to which uv.lock should be exported.uv.lock をエクスポートするフォーマット。

Supports requirements.txt, pylock.toml (PEP 751) and CycloneDX v1.5 JSON output formats.requirements.txt、pylock.toml (PEP 751)、および CycloneDX v1.5 JSON 出力フォーマットをサポートしています。

uv will infer the output format from the file extension of the output file, if provided. Otherwise, defaults to requirements.txt.uvは、提供された場合、出力ファイルの拡張子から出力フォーマットを推測します。そうでない場合は、デフォルトで requirements.txt になります。

Possible values:可能な値：

requirements.txt: Export in requirements.txt formatrequirements.txt: requirements.txt フォーマットでエクスポート
pylock.toml: Export in pylock.toml formatpylock.toml: pylock.toml フォーマットでエクスポート
cyclonedx1.5: Export in CycloneDX v1.5 JSON formatcyclonedx1.5: CycloneDX v1.5 JSON フォーマットでエクスポート

--frozen--frozen

Do not update the uv.lock before exporting.エクスポート前に uv.lock を更新しない。

If a uv.lock does not exist, uv will exit with an error.もし uv.lock が存在しない場合、uvはエラーで終了します。

May also be set with the UV_FROZEN environment variable.UV_FROZEN 環境変数で設定することもできます。

--group group--group group

Include dependencies from the specified dependency group.指定された依存関係グループから依存関係を含めます。

May be provided multiple times.複数回提供することができます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--index index--index index

The URLs to use when resolving dependencies, in addition to the default index.デフォルトのインデックスに加えて、依存関係を解決するために使用するURL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --default-index (which defaults to PyPI). When multiple --index flags are provided, earlier values take priority.このフラグで提供されるすべてのインデックスは、--default-index（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の--indexフラグが提供される場合、先に指定された値が優先されます。

Index names are not supported as values. Relative paths must be disambiguated from index names with ./ or ../ on Unix or .\\, ..\\, ./ or ../ on Windows.インデックス名は値としてサポートされていません。相対パスは、Unixでは./または../で、Windowsでは.\\、..\\、./または../でインデックス名と区別する必要があります。

May also be set with the UV_INDEX environment variable.UV_INDEX環境変数で設定することもできます。

--index-strategy index-strategy--index-strategy index-strategy

The strategy to use when resolving against multiple index URLs.複数のインデックスURLに対して解決する際に使用する戦略。

By default, uv will stop at the first index on which a given package is available, and limit resolutions to those present on that first index (first-index). This prevents "dependency confusion" attacks, whereby an attacker can upload a malicious package under the same name to an alternate index.デフォルトでは、uvは指定されたパッケージが利用可能な最初のインデックスで停止し、その最初のインデックスに存在するものに解決を制限します（first-index）。これにより、攻撃者が別のインデックスに同じ名前の悪意のあるパッケージをアップロードすることによる「依存関係の混乱」攻撃を防ぎます。

May also be set with the UV_INDEX_STRATEGY environment variable.UV_INDEX_STRATEGY環境変数で設定することもできます。

Possible values:可能な値：

first-index: Only use results from the first index that returns a match for a given package namefirst-index: 指定されたパッケージ名に一致する最初のインデックスからの結果のみを使用します。
unsafe-first-match: Search for every package name across all indexes, exhausting the versions from the first index before moving on to the nextunsafe-first-match: すべてのインデックスで各パッケージ名を検索し、次のインデックスに移動する前に最初のインデックスからのバージョンを使い果たします。
unsafe-best-match: Search for every package name across all indexes, preferring the "best" version found. If a package version is in multiple indexes, only look at the entry for the first indexunsafe-best-match: すべてのインデックスでパッケージ名を検索し、見つかった「最良」のバージョンを優先します。パッケージのバージョンが複数のインデックスに存在する場合、最初のインデックスのエントリのみを参照します。

--index-url, -i index-url--index-url, -i index-url

(Deprecated: use --default-index instead) The URL of the Python package index (by default: https://pypi.org/simple).(非推奨: 代わりに --default-index を使用してください) PythonパッケージインデックスのURL（デフォルト: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --extra-index-url flag.このフラグで指定されたインデックスは、--extra-index-urlフラグで指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_INDEX_URL environment variable.UV_INDEX_URL 環境変数で設定することもできます。

--keyring-provider keyring-provider--keyring-provider keyring-provider

Attempt to use keyring for authentication for index URLs.keyringを使用してインデックスURLの認証を試みます。

At present, only --keyring-provider subprocess is supported, which configures uv to use the keyring CLI to handle authentication.現在、--keyring-provider subprocess のみがサポートされており、uvが認証を処理するためにkeyring CLIを使用するように構成します。

Defaults to disabled.デフォルトはdisabledです。

May also be set with the UV_KEYRING_PROVIDER environment variable.環境変数 UV_KEYRING_PROVIDER で設定することもできます。

Possible values:可能な値:

disabled: Do not use keyring for credential lookupdisabled: 認証情報の検索にキーレングを使用しない
subprocess: Use the keyring command for credential lookupsubprocess: 認証情報の検索に keyring コマンドを使用する

--link-mode link-mode--link-mode link-mode

The method to use when installing packages from the global cache.グローバルキャッシュからパッケージをインストールする際に使用する方法。

This option is only used when building source distributions.このオプションはソース配布をビルドする際にのみ使用されます。

Defaults to clone (also known as Copy-on-Write) on macOS, and hardlink on Linux and Windows.macOSでは clone（コピーオンライトとも呼ばれる）に、LinuxおよびWindowsでは hardlink にデフォルト設定されています。

WARNING: The use of symlink link mode is discouraged, as they create tight coupling between the cache and the target environment. For example, clearing the cache (uv cache clean) will break all installed packages by way of removing the underlying source files. Use symlinks with caution.警告: シンボリックリンクモードの使用は推奨されません。キャッシュとターゲット環境の間に強い結合を作成するためです。たとえば、キャッシュをクリアする (uv cache clean) と、基になるソースファイルが削除されるため、すべてのインストールされたパッケージが壊れます。シンボリックリンクは注意して使用してください。

May also be set with the UV_LINK_MODE environment variable.環境変数 UV_LINK_MODE で設定することもできます。

Possible values:可能な値：

clone: Clone (i.e., copy-on-write) packages from the wheel into the site-packages directoryclone: ホイールからsite-packagesディレクトリにパッケージをクローン（すなわち、コピーオンライト）します。
copy: Copy packages from the wheel into the site-packages directorycopy: ホイールからsite-packagesディレクトリにパッケージをコピーします。
hardlink: Hard link packages from the wheel into the site-packages directoryhardlink: ホイールからsite-packagesディレクトリにパッケージをハードリンクします。
symlink: Symbolically link packages from the wheel into the site-packages directorysymlink: ホイールからsite-packagesディレクトリにパッケージをシンボリックリンクします。

--locked--locked

Assert that the uv.lock will remain unchanged.uv.lockが変更されないことを保証します。

Requires that the lockfile is up-to-date. If the lockfile is missing or needs to be updated, uv will exit with an error.ロックファイルが最新である必要があります。ロックファイルが欠落しているか、更新が必要な場合、uvはエラーで終了します。

May also be set with the UV_LOCKED environment variable.UV_LOCKED環境変数で設定することもできます。

--managed-python--managed-python

Require use of uv-managed Python versions.uvが管理するPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンの使用を優先します。ただし、uvが管理するPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON 環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、特にシステムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したいことがあります。

May also be set with the UV_NATIVE_TLS environment variable.UV_NATIVE_TLS 環境変数でも設定できます。

--no-annotate--no-annotate

Exclude comment annotations indicating the source of each package各パッケージのソースを示すコメント注釈を除外します。

--no-binary--no-binary

Don't install pre-built wheels.事前にビルドされたホイールをインストールしないでください。

The given packages will be built and installed from source. The resolver will still use pre-built wheels to extract package metadata, if available.指定されたパッケージはソースからビルドされ、インストールされます。リゾルバーは、利用可能な場合、パッケージメタデータを抽出するために事前にビルドされたホイールを使用します。

May also be set with the UV_NO_BINARY environment variable.UV_NO_BINARY 環境変数でも設定できます。

--no-binary-package no-binary-package--no-binary-package no-binary-package

Don't install pre-built wheels for a specific package特定のパッケージに対して事前にビルドされたホイールをインストールしないでください。

May also be set with the UV_NO_BINARY_PACKAGE environment variable.UV_NO_BINARY_PACKAGE 環境変数でも設定できます。

--no-build--no-build

Don't build source distributions.ソース配布物をビルドしないでください。

When enabled, resolving will not run arbitrary Python code. The cached wheels of already-built source distributions will be reused, but operations that require building distributions will exit with an error.有効にすると、リゾルビングは任意のPythonコードを実行しません。すでにビルドされたソース配布物のキャッシュされたホイールは再利用されますが、配布物のビルドを必要とする操作はエラーで終了します。

May also be set with the UV_NO_BUILD environment variable.環境変数 UV_NO_BUILD でも設定できます。

--no-build-isolation--no-build-isolation

Disable isolation when building source distributions.ソース配布物をビルドする際に隔離を無効にします。

Assumes that build dependencies specified by PEP 518 are already installed.PEP 518 で指定されたビルド依存関係がすでにインストールされていると仮定します。

May also be set with the UV_NO_BUILD_ISOLATION environment variable.環境変数 UV_NO_BUILD_ISOLATION でも設定できます。

--no-build-isolation-package no-build-isolation-package--no-build-isolation-package no-build-isolation-package

Disable isolation when building source distributions for a specific package.特定のパッケージのソース配布物をビルドする際に隔離を無効にします。

Assumes that the packages' build dependencies specified by PEP 518 are already installed.そのパッケージのビルド依存関係が PEP 518 で指定されていると仮定します。

--no-build-package no-build-package--no-build-package no-build-package

Don't build source distributions for a specific package特定のパッケージのソース配布物をビルドしません。

May also be set with the UV_NO_BUILD_PACKAGE environment variable.環境変数 UV_NO_BUILD_PACKAGE でも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.環境変数 UV_NO_CACHE でも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル (pyproject.toml, uv.toml) の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.環境変数 UV_NO_CONFIG でも設定できます。

--no-default-groups--no-default-groups

Ignore the default dependency groups.デフォルトの依存関係グループを無視します。

uv includes the groups defined in tool.uv.default-groups by default. This disables that option, however, specific groups can still be included with --group.uvはデフォルトでtool.uv.default-groupsで定義されたグループを含みます。ただし、このオプションは無効になり、特定のグループは--groupで含めることができます。

May also be set with the UV_NO_DEFAULT_GROUPS environment variable.UV_NO_DEFAULT_GROUPS環境変数で設定することもできます。

--no-dev--no-dev

Disable the development dependency group.開発依存関係グループを無効にします。

This option is an alias of --no-group dev. See --no-default-groups to disable all default groups instead.このオプションは--no-group devのエイリアスです。すべてのデフォルトグループを無効にするには--no-default-groupsを参照してください。

May also be set with the UV_NO_DEV environment variable.UV_NO_DEV環境変数で設定することもできます。

--no-editable--no-editable

Export any editable dependencies, including the project and any workspace members, as non-editableプロジェクトおよびワークスペースメンバーを含む、すべての編集可能な依存関係を非編集可能としてエクスポートします。

May also be set with the UV_NO_EDITABLE environment variable.UV_NO_EDITABLE環境変数で設定することもできます。

--no-emit-local, --no-install-local--no-emit-local, --no-install-local

Do not include local path dependencies in the exported requirements.エクスポートされた要件にローカルパス依存関係を含めないでください。

Omits the current project, workspace members, and any other local (path or editable) packages from the export. Only remote/indexed dependencies are written. Useful for Docker and CI flows that want to export and cache third-party dependencies first.現在のプロジェクト、ワークスペースメンバー、およびその他のローカル（パスまたは編集可能）パッケージをエクスポートから省略します。リモート/インデックスされた依存関係のみが書き込まれます。サードパーティの依存関係を最初にエクスポートしてキャッシュしたいDockerやCIフローに便利です。

The inverse --only-emit-local can be used to emit only local packages, excluding all remote dependencies.逆の--only-emit-localを使用すると、すべてのリモート依存関係を除外してのみローカルパッケージをエミットできます。

--no-emit-package, --no-install-package no-emit-package--no-emit-package、--no-install-package no-emit-package

Do not emit the given package(s).指定されたパッケージをエミットしないでください。

By default, all project's dependencies are included in the exported requirements file. The --no-emit-package option allows exclusion of specific packages.デフォルトでは、すべてのプロジェクトの依存関係がエクスポートされた要件ファイルに含まれます。--no-emit-packageオプションを使用すると、特定のパッケージを除外できます。

The inverse --only-emit-package can be used to emit only the specified packages, excluding all others.逆の--only-emit-packageを使用すると、他のすべてを除外してのみ指定されたパッケージをエミットできます。

--no-emit-project, --no-install-project--no-emit-project、--no-install-project

Do not emit the current project.現在のプロジェクトをエミットしないでください。

By default, the current project is included in the exported requirements file with all of its dependencies. The --no-emit-project option allows the project to be excluded, but all of its dependencies to remain included.デフォルトでは、現在のプロジェクトはそのすべての依存関係とともにエクスポートされた要件ファイルに含まれます。--no-emit-projectオプションを使用すると、プロジェクトを除外できますが、そのすべての依存関係は含まれたままになります。

The inverse --only-emit-project can be used to emit only the project itself, excluding all dependencies.逆の --only-emit-project は、すべての依存関係を除外して、プロジェクト自体のみ を出力するために使用できます。

--no-emit-workspace, --no-install-workspace--no-emit-workspace, --no-install-workspace

Do not emit any workspace members, including the root project.ルートプロジェクトを含む、ワークスペースメンバーを一切出力しません。

By default, all workspace members and their dependencies are included in the exported requirements file, with all of their dependencies. The --no-emit-workspace option allows exclusion of all the workspace members while retaining their dependencies.デフォルトでは、すべてのワークスペースメンバーとその依存関係がエクスポートされた要件ファイルに含まれ、すべての依存関係が含まれます。--no-emit-workspace オプションを使用すると、依存関係を保持しながら、すべてのワークスペースメンバーを除外できます。

The inverse --only-emit-workspace can be used to emit only workspace members, excluding all other dependencies.逆の --only-emit-workspace は、すべての他の依存関係を除外して、ワークスペースメンバーのみ を出力するために使用できます。

--no-extra no-extra--no-extra no-extra

Exclude the specified optional dependencies, if --all-extras is supplied.指定されたオプションの依存関係を除外します。--all-extras が指定されている場合。

May be provided multiple times.複数回提供することができます。

--no-group no-group--no-group no-group

Disable the specified dependency group.指定された依存関係グループを無効にします。

This option always takes precedence over default groups, --all-groups, and --group.このオプションは、デフォルトグループ、--all-groups、および--groupよりも常に優先されます。

May be provided multiple times.複数回提供することができます。

May also be set with the UV_NO_GROUP environment variable.UV_NO_GROUP環境変数で設定することもできます。

--no-hashes--no-hashes

Omit hashes in the generated output生成された出力からハッシュを省略します。

--no-header--no-header

Exclude the comment header at the top of the generated output file生成された出力ファイルの先頭にあるコメントヘッダーを除外します。

--no-index--no-index

Ignore the registry index (e.g., PyPI), instead relying on direct URL dependencies and those provided via --find-linksレジストリインデックス（例：PyPI）を無視し、直接URL依存関係および--find-linksを介して提供されたものに依存します。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--no-sources--no-sources

Ignore the tool.uv.sources table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any workspace, Git, URL, or local path sourcestool.uv.sources テーブルを依存関係の解決時に無視します。ワークスペース、Git、URL、またはローカルパスソースを使用するのではなく、標準準拠の公開可能なパッケージメタデータに対してロックするために使用されます。

May also be set with the UV_NO_SOURCES environment variable.UV_NO_SOURCES 環境変数で設定することもできます。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数で設定することもできます。

--only-dev--only-dev

Only include the development dependency group.開発依存関係グループのみを含めます。

The project and its dependencies will be omitted.プロジェクトとその依存関係は省略されます。

This option is an alias for --only-group dev. Implies --no-default-groups.このオプションは --only-group dev のエイリアスです。--no-default-groups を暗示します。

--only-group only-group--only-group only-group

Only include dependencies from the specified dependency group.指定された依存関係グループからの依存関係のみを含めます。

The project and its dependencies will be omitted.プロジェクトとその依存関係は省略されます。

May be provided multiple times. Implies --no-default-groups.複数回提供することができます。--no-default-groupsを暗示します。

--output-file, -o output-file--output-file, -o output-file

Write the exported requirements to the given fileエクスポートされた要件を指定されたファイルに書き込みます。

--package package--package package

Export the dependencies for specific packages in the workspace.ワークスペース内の特定のパッケージの依存関係をエクスポートします。

If any workspace member does not exist, uv will exit with an error.ワークスペースのメンバーが存在しない場合、uvはエラーで終了します。

--prerelease prerelease--prerelease prerelease

The strategy to use when considering pre-release versions.プレリリースバージョンを考慮する際に使用する戦略。

By default, uv will accept pre-releases for packages that only publish pre-releases, along with first-party requirements that contain an explicit pre-release marker in the declared specifiers (if-necessary-or-explicit).デフォルトでは、uvはプレリリースのみを公開するパッケージと、宣言された指定子に明示的なプレリリースマーカーを含むファーストパーティの要件に対してプレリリースを受け入れます（if-necessary-or-explicit）。

May also be set with the UV_PRERELEASE environment variable.UV_PRERELEASE 環境変数で設定することも可能です。

Possible values:可能な値：

disallow: Disallow all pre-release versionsdisallow: すべてのプレリリースバージョンを禁止する
allow: Allow all pre-release versionsallow: すべてのプレリリースバージョンを許可する
if-necessary: Allow pre-release versions if all versions of a package are pre-releaseif-necessary: パッケージのすべてのバージョンがプレリリースである場合にプレリリースバージョンを許可する
explicit: Allow pre-release versions for first-party packages with explicit pre-release markers in their version requirementsexplicit: バージョン要件に明示的なプレリリースマーカーを持つファーストパーティパッケージに対してプレリリースバージョンを許可する
if-necessary-or-explicit: Allow pre-release versions if all versions of a package are pre-release, or if the package has an explicit pre-release marker in its version requirementsif-necessary-or-explicit: パッケージのすべてのバージョンがプレリリースである場合、またはパッケージのバージョン要件に明示的なプレリリースマーカーがある場合にプレリリースバージョンを許可する

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は uv pip インターフェースで使用されると効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数を使用して設定することもできます。

--prune package--prune package

Prune the given package from the dependency tree.指定されたパッケージを依存関係ツリーから削除します。

Pruned packages will be excluded from the exported requirements file, as will any dependencies that are no longer required after the pruned package is removed.削除されたパッケージはエクスポートされた要件ファイルから除外され、削除されたパッケージが取り除かれた後にもはや必要とされない依存関係も同様です。

--python, -p python--python、-p python

The Python interpreter to use during resolution.解決中に使用するPythonインタプリタ。

A Python interpreter is required for building source distributions to determine package metadata when there are not wheels.ソース配布をビルドするにはPythonインタプリタが必要で、ホイールがない場合にパッケージメタデータを決定します。

The interpreter is also used as the fallback value for the minimum Python version if requires-python is not set.requires-pythonが設定されていない場合、インタプリタは最小Pythonバージョンのフォールバック値としても使用されます。

See uv python for details on Python discovery and supported request formats.Pythonの発見とサポートされているリクエスト形式の詳細については、uv pythonを参照してください。

May also be set with the UV_PYTHON environment variable.UV_PYTHON環境変数で設定することもできます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば-qq、uvはstdoutに出力を一切書き込まないサイレントモードを有効にします。

--refresh--refresh

Refresh all cached dataすべてのキャッシュデータを更新します

--refresh-package refresh-package--refresh-package refresh-package

Refresh cached data for a specific package特定のパッケージのキャッシュデータを更新します

--resolution resolution--resolution resolution

The strategy to use when selecting between the different compatible versions for a given package requirement.特定のパッケージ要件に対して異なる互換バージョンを選択する際に使用する戦略。

By default, uv will use the latest compatible version of each package (highest).デフォルトでは、uvは各パッケージの最新の互換バージョンを使用します (highest)。

May also be set with the UV_RESOLUTION environment variable.UV_RESOLUTION 環境変数でも設定可能です。

Possible values:可能な値：

highest: Resolve the highest compatible version of each packagehighest: 各パッケージの最高の互換バージョンを解決します
lowest: Resolve the lowest compatible version of each packagelowest: 各パッケージの最低の互換バージョンを解決します
lowest-direct: Resolve the lowest compatible version of any direct dependencies, and the highest compatible version of any transitive dependencieslowest-direct: 直接依存関係の最低の互換バージョンを解決し、間接依存関係の最高の互換バージョンを解決します

--script script--script スクリプト

Export the dependencies for the specified PEP 723 Python script, rather than the current project.指定された PEP 723 Python スクリプトの依存関係をエクスポートします。現在のプロジェクトではありません。

If provided, uv will resolve the dependencies based on its inline metadata table, in adherence with PEP 723.提供された場合、uv は PEP 723 に従ってインラインメタデータテーブルに基づいて依存関係を解決します。

--upgrade, -U--upgrade, -U

Allow package upgrades, ignoring pinned versions in any existing output file. Implies --refreshパッケージのアップグレードを許可し、既存の出力ファイルに固定されたバージョンを無視します。--refreshを含意します。

--upgrade-package, -P upgrade-package--upgrade-package, -P アップグレードパッケージ

Allow upgrades for a specific package, ignoring pinned versions in any existing output file. Implies --refresh-package特定のパッケージのアップグレードを許可し、既存の出力ファイルに固定されたバージョンを無視します。--refresh-packageを含意します。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)RUST_LOG 環境変数を使用して、詳細なロギングを構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv treeuv tree

Display the project's dependency treeプロジェクトの依存関係ツリーを表示します

Usage使用法

uv tree [OPTIONS]

Optionsオプション

--all-groups--all-groups

Include dependencies from all dependency groups.すべての依存関係グループからの依存関係を含めます。

--no-group can be used to exclude specific groups.--no-groupを使用して特定のグループを除外できます。

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正な接続を許可します。

Can be provided multiple times.複数回提供することができます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホストポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、検証済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数で設定することもできます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvにデフォルト設定され、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されます。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数で設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末への書き込み時に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力がサポートされている端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用するuv.tomlファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数を使用して設定することもできます。

--config-setting, --config-settings, -C config-setting--config-setting, --config-settings, -C config-setting

Settings to pass to the PEP 517 build backend, specified as KEY=VALUE pairsPEP 517ビルドバックエンドに渡す設定で、KEY=VALUEペアとして指定します。

--config-settings-package, --config-settings-package config-settings-package--config-settings-package, --config-settings-package config-settings-package

Settings to pass to the PEP 517 build backend for a specific package, specified as PACKAGE:KEY=VALUE pairs特定のパッケージに対してPEP 517ビルドバックエンドに渡す設定で、PACKAGE:KEY=VALUEペアとして指定します。

--default-index default-index--default-index default-index

The URL of the default package index (by default: https://pypi.org/simple).デフォルトのパッケージインデックスのURL（デフォルトでは: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --index flag.このフラグで指定されたインデックスは、--indexフラグで指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_DEFAULT_INDEX environment variable.UV_DEFAULT_INDEX環境変数で設定することもできます。

--depth, -d depth--depth, -d depth

Maximum display depth of the dependency tree依存関係ツリーの最大表示深度

[default: 255][default: 255]

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数で設定することもできます。

--exclude-newer exclude-newer--exclude-newer exclude-newer

Limit candidate packages to those that were uploaded prior to the given date.候補パッケージを、指定された日付以前にアップロードされたものに制限します。

Accepts both RFC 3339 timestamps (e.g., 2006-12-02T02:07:43Z) and local dates in the same format (e.g., 2006-12-02) in your system's configured time zone.RFC 3339 タイムスタンプ（例: 2006-12-02T02:07:43Z）と、システムの設定されたタイムゾーンでの同じ形式のローカル日付（例: 2006-12-02）の両方を受け入れます。

May also be set with the UV_EXCLUDE_NEWER environment variable.UV_EXCLUDE_NEWER環境変数で設定することもできます。

--exclude-newer-package exclude-newer-package--exclude-newer-package exclude-newer-package

Limit candidate packages for a specific package to those that were uploaded prior to the given date.特定のパッケージに対する候補パッケージを、指定された日付以前にアップロードされたものに制限します。

Accepts package-date pairs in the format PACKAGE=DATE, where DATE is an RFC 3339 timestamp (e.g., 2006-12-02T02:07:43Z) or local date (e.g., 2006-12-02) in your system's configured time zone.PACKAGE=DATEの形式でパッケージと日付のペアを受け入れます。ここで、DATEはRFC 3339タイムスタンプ（例：2006-12-02T02:07:43Z）またはローカル日付（例：2006-12-02）で、システムの設定されたタイムゾーンに基づきます。

Can be provided multiple times for different packages.異なるパッケージに対して複数回提供できます。

--extra-index-url extra-index-url--extra-index-url extra-index-url

(Deprecated: use --index instead) Extra URLs of package indexes to use, in addition to --index-url.(非推奨：代わりに--indexを使用してください) --index-urlに加えて使用するパッケージインデックスの追加URL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --index-url (which defaults to PyPI). When multiple --extra-index-url flags are provided, earlier values take priority.このフラグを介して提供されたすべてのインデックスは、--index-url（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の--extra-index-urlフラグが提供される場合、先に指定された値が優先されます。

May also be set with the UV_EXTRA_INDEX_URL environment variable.UV_EXTRA_INDEX_URL環境変数で設定することもできます。

--find-links, -f find-links--find-links, -f find-links

Locations to search for candidate distributions, in addition to those found in the registry indexes.レジストリインデックスに見つかったものに加えて、候補の配布を検索する場所。

If a path, the target must be a directory that contains packages as wheel files (.whl) or source distributions (e.g., .tar.gz or .zip) at the top level.パスの場合、ターゲットは最上位にホイールファイル（.whl）またはソース配布（例：.tar.gzまたは.zip）を含むディレクトリでなければなりません。

If a URL, the page must contain a flat list of links to package files adhering to the formats described above.URLの場合、ページは上記の形式に従ったパッケージファイルへのリンクのフラットリストを含む必要があります。

May also be set with the UV_FIND_LINKS environment variable.UV_FIND_LINKS 環境変数で設定することもできます。

--fork-strategy fork-strategy--fork-strategy fork-strategy

The strategy to use when selecting multiple versions of a given package across Python versions and platforms.Pythonのバージョンやプラットフォームにわたって、特定のパッケージの複数のバージョンを選択する際に使用する戦略。

By default, uv will optimize for selecting the latest version of each package for each supported Python version (requires-python), while minimizing the number of selected versions across platforms.デフォルトでは、uvは各サポートされているPythonバージョン（requires-python）ごとに各パッケージの最新バージョンを選択することを最適化し、プラットフォーム間で選択されたバージョンの数を最小限に抑えます。

Under fewest, uv will minimize the number of selected versions for each package, preferring older versions that are compatible with a wider range of supported Python versions or platforms.fewest の下では、uvは各パッケージの選択されたバージョンの数を最小限に抑え、より広範囲のサポートされているPythonバージョンやプラットフォームと互換性のある古いバージョンを優先します。

May also be set with the UV_FORK_STRATEGY environment variable.UV_FORK_STRATEGY 環境変数で設定することもできます。

Possible values:可能な値：

fewest: Optimize for selecting the fewest number of versions for each package. Older versions may be preferred if they are compatible with a wider range of supported Python versions or platformsfewest: 各パッケージの最小限のバージョンを選択するよう最適化します。古いバージョンは、より広範なサポートされているPythonバージョンやプラットフォームと互換性がある場合に好まれることがあります。
requires-python: Optimize for selecting latest supported version of each package, for each supported Python versionrequires-python: 各サポートされているPythonバージョンに対して、各パッケージの最新のサポートバージョンを選択するよう最適化します。

--frozen--frozen

Display the requirements without locking the project.プロジェクトをロックせずに要件を表示します。

If the lockfile is missing, uv will exit with an error.ロックファイルが存在しない場合、uvはエラーで終了します。

May also be set with the UV_FROZEN environment variable.UV_FROZEN 環境変数で設定することもできます。

--group group--group group

Include dependencies from the specified dependency group.指定された依存関係グループから依存関係を含めます。

May be provided multiple times.複数回提供することができます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します

--index index--index index

The URLs to use when resolving dependencies, in addition to the default index.デフォルトのインデックスに加えて、依存関係を解決する際に使用するURL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式で配置されたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --default-index (which defaults to PyPI). When multiple --index flags are provided, earlier values take priority.このフラグを介して提供されたすべてのインデックスは、--default-index（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の--indexフラグが提供される場合、先に指定された値が優先されます。

Index names are not supported as values. Relative paths must be disambiguated from index names with ./ or ../ on Unix or .\\, ..\\, ./ or ../ on Windows.インデックス名は値としてサポートされていません。相対パスは、Unixでは./または../で、Windowsでは.\\、..\\、./または../でインデックス名と区別する必要があります。

May also be set with the UV_INDEX environment variable.UV_INDEX環境変数を使用して設定することもできます。

--index-strategy index-strategy--index-strategy index-strategy

The strategy to use when resolving against multiple index URLs.複数のインデックスURLに対して解決する際に使用する戦略。

By default, uv will stop at the first index on which a given package is available, and limit resolutions to those present on that first index (first-index). This prevents "dependency confusion" attacks, whereby an attacker can upload a malicious package under the same name to an alternate index.デフォルトでは、uvは指定されたパッケージが利用可能な最初のインデックスで停止し、その最初のインデックスに存在するものに解決を制限します（first-index）。これにより、攻撃者が別のインデックスに同じ名前の悪意のあるパッケージをアップロードすることによる「依存関係の混乱」攻撃を防ぎます。

May also be set with the UV_INDEX_STRATEGY environment variable.また、UV_INDEX_STRATEGY 環境変数で設定することもできます。

Possible values:可能な値：

first-index: Only use results from the first index that returns a match for a given package namefirst-index: 指定されたパッケージ名に対して一致する最初のインデックスからの結果のみを使用します。
unsafe-first-match: Search for every package name across all indexes, exhausting the versions from the first index before moving on to the nextunsafe-first-match: すべてのインデックスで各パッケージ名を検索し、次のインデックスに移る前に最初のインデックスからのバージョンを使い切ります。
unsafe-best-match: Search for every package name across all indexes, preferring the "best" version found. If a package version is in multiple indexes, only look at the entry for the first indexunsafe-best-match: すべてのインデックスで各パッケージ名を検索し、見つかった「最良」のバージョンを優先します。パッケージバージョンが複数のインデックスに存在する場合、最初のインデックスのエントリのみを参照します。

--index-url, -i index-url--index-url, -i index-url

(Deprecated: use --default-index instead) The URL of the Python package index (by default: https://pypi.org/simple).(非推奨: 代わりに --default-index を使用してください) Python パッケージインデックスの URL (デフォルト: https://pypi.org/simple)。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503 (シンプルリポジトリ API) に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --extra-index-url flag.このフラグで指定されたインデックスは、--extra-index-url フラグで指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_INDEX_URL environment variable.また、UV_INDEX_URL 環境変数で設定することもできます。

--invert, --reverse--invert, --reverse

Show the reverse dependencies for the given package. This flag will invert the tree and display the packages that depend on the given package指定されたパッケージの逆依存関係を表示します。このフラグはツリーを反転させ、指定されたパッケージに依存するパッケージを表示します。

--keyring-provider keyring-provider--keyring-provider keyring-provider

Attempt to use keyring for authentication for index URLs.keyringを使用してインデックスURLの認証を試みます。

At present, only --keyring-provider subprocess is supported, which configures uv to use the keyring CLI to handle authentication.現在のところ、--keyring-provider subprocessのみがサポートされており、これはuvが認証を処理するためにkeyring CLIを使用するように設定します。

Defaults to disabled.デフォルトはdisabledです。

May also be set with the UV_KEYRING_PROVIDER environment variable.UV_KEYRING_PROVIDER環境変数を使用して設定することもできます。

Possible values:可能な値：

disabled: Do not use keyring for credential lookupdisabled: 認証情報の検索にkeyringを使用しない
subprocess: Use the keyring command for credential lookupsubprocess: 認証情報の検索にkeyringコマンドを使用する

--link-mode link-mode--link-mode リンクモード

The method to use when installing packages from the global cache.グローバルキャッシュからパッケージをインストールする際に使用する方法。

This option is only used when building source distributions.このオプションは、ソース配布をビルドする際にのみ使用されます。

Defaults to clone (also known as Copy-on-Write) on macOS, and hardlink on Linux and Windows.macOSではclone（コピーオンライトとも呼ばれる）に、LinuxおよびWindowsではhardlinkにデフォルト設定されています。

WARNING: The use of symlink link mode is discouraged, as they create tight coupling between the cache and the target environment. For example, clearing the cache (uv cache clean) will break all installed packages by way of removing the underlying source files. Use symlinks with caution.警告: シンボリックリンクモードの使用は推奨されません。キャッシュとターゲット環境の間に強い結合を作成するためです。たとえば、キャッシュをクリアすること（uv cache clean）は、基盤となるソースファイルを削除することによってすべてのインストールされたパッケージを壊します。シンボリックリンクは注意して使用してください。

May also be set with the UV_LINK_MODE environment variable.UV_LINK_MODE環境変数で設定することもできます。

Possible values:可能な値:

clone: Clone (i.e., copy-on-write) packages from the wheel into the site-packages directoryclone: ホイールからsite-packagesディレクトリにパッケージをクローン（コピーオンライト）します。
copy: Copy packages from the wheel into the site-packages directorycopy: ホイールからsite-packagesディレクトリにパッケージをコピーします。
hardlink: Hard link packages from the wheel into the site-packages directoryhardlink: ホイールからsite-packagesディレクトリにパッケージをハードリンクします。
symlink: Symbolically link packages from the wheel into the site-packages directorysymlink: パッケージをホイールからsite-packagesディレクトリにシンボリックリンクします

--locked--locked

Assert that the uv.lock will remain unchanged.uv.lockが変更されないことを保証します。

Requires that the lockfile is up-to-date. If the lockfile is missing or needs to be updated, uv will exit with an error.ロックファイルが最新である必要があります。ロックファイルが欠落しているか、更新が必要な場合、uvはエラーで終了します。

May also be set with the UV_LOCKED environment variable.UV_LOCKED環境変数でも設定できます。

--managed-python--managed-python

Require use of uv-managed Python versions.uv管理のPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理しているPythonバージョンの使用を優先します。ただし、uv管理のPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションはシステムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書をロードするかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書をロードします。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、プラットフォームのネイティブ証明書ストアを使用したいことがあります。特に、システムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合です。

May also be set with the UV_NATIVE_TLS environment variable.UV_NATIVE_TLS環境変数で設定することもできます。

--no-binary--no-binary

Don't install pre-built wheels.事前にビルドされたホイールをインストールしないでください。

The given packages will be built and installed from source. The resolver will still use pre-built wheels to extract package metadata, if available.指定されたパッケージはソースからビルドされ、インストールされます。リゾルバは、利用可能な場合、パッケージメタデータを抽出するために事前にビルドされたホイールを使用します。

May also be set with the UV_NO_BINARY environment variable.UV_NO_BINARY環境変数で設定することもできます。

--no-binary-package no-binary-package--no-binary-package no-binary-package

Don't install pre-built wheels for a specific package特定のパッケージに対して事前にビルドされたホイールをインストールしないでください。

May also be set with the UV_NO_BINARY_PACKAGE environment variable.環境変数 UV_NO_BINARY_PACKAGE でも設定可能です。

--no-build--no-build

Don't build source distributions.ソース配布物のビルドを行いません。

When enabled, resolving will not run arbitrary Python code. The cached wheels of already-built source distributions will be reused, but operations that require building distributions will exit with an error.有効にすると、解決時に任意のPythonコードは実行されません。既にビルドされたソース配布物のキャッシュされたホイールが再利用されますが、配布物のビルドを必要とする操作はエラーで終了します。

May also be set with the UV_NO_BUILD environment variable.環境変数 UV_NO_BUILD でも設定可能です。

--no-build-isolation--no-build-isolation

Disable isolation when building source distributions.ソース配布物のビルド時に隔離を無効にします。

Assumes that build dependencies specified by PEP 518 are already installed.PEP 518 で指定されたビルド依存関係が既にインストールされていると仮定します。

May also be set with the UV_NO_BUILD_ISOLATION environment variable.環境変数 UV_NO_BUILD_ISOLATION でも設定可能です。

--no-build-isolation-package no-build-isolation-package--no-build-isolation-package no-build-isolation-package

Disable isolation when building source distributions for a specific package.特定のパッケージのソース配布をビルドする際に、アイソレーションを無効にします。

Assumes that the packages' build dependencies specified by PEP 518 are already installed.PEP 518で指定されたパッケージのビルド依存関係がすでにインストールされていることを前提とします。

--no-build-package no-build-package--no-build-package no-build-package

Don't build source distributions for a specific package特定のパッケージのソース配布をビルドしない

May also be set with the UV_NO_BUILD_PACKAGE environment variable.UV_NO_BUILD_PACKAGE 環境変数でも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.UV_NO_CACHE 環境変数でも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml, uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.また、UV_NO_CONFIG 環境変数で設定することもできます。

--no-dedupe--no-dedupe

Do not de-duplicate repeated dependencies. Usually, when a package has already displayed its dependencies, further occurrences will not re-display its dependencies, and will include a (*) to indicate it has already been shown. This flag will cause those duplicates to be repeated繰り返しの依存関係を重複させないでください。通常、パッケージがすでにその依存関係を表示している場合、さらに発生することはなく、すでに表示されたことを示すために (*) が含まれます。このフラグは、それらの重複を繰り返す原因となります。

--no-default-groups--no-default-groups

Ignore the default dependency groups.デフォルトの依存関係グループを無視します。

uv includes the groups defined in tool.uv.default-groups by default. This disables that option, however, specific groups can still be included with --group.uvはデフォルトでtool.uv.default-groupsで定義されたグループを含みますが、このオプションを無効にします。ただし、特定のグループは--groupでまだ含めることができます。

May also be set with the UV_NO_DEFAULT_GROUPS environment variable.また、UV_NO_DEFAULT_GROUPS 環境変数で設定することもできます。

--no-dev--no-dev

Disable the development dependency group.開発依存関係グループを無効にします。

This option is an alias of --no-group dev. See --no-default-groups to disable all default groups instead.このオプションは --no-group dev のエイリアスです。すべてのデフォルトグループを無効にするには --no-default-groups を参照してください。

May also be set with the UV_NO_DEV environment variable.UV_NO_DEV 環境変数を使用して設定することもできます。

--no-group no-group--no-group no-group

Disable the specified dependency group.指定された依存関係グループを無効にします。

This option always takes precedence over default groups, --all-groups, and --group.このオプションは常にデフォルトグループ、--all-groups、および --group よりも優先されます。

May be provided multiple times.複数回提供することができます。

May also be set with the UV_NO_GROUP environment variable.UV_NO_GROUP 環境変数を使用して設定することもできます。

--no-index--no-index

Ignore the registry index (e.g., PyPI), instead relying on direct URL dependencies and those provided via --find-linksレジストリインデックス（例：PyPI）を無視し、直接URL依存関係および --find-links を介して提供されるものに依存します。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--no-sources--no-sources

Ignore the tool.uv.sources table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any workspace, Git, URL, or local path sources依存関係を解決する際に tool.uv.sources テーブルを無視します。これは、ワークスペース、Git、URL、またはローカルパスソースを使用するのではなく、標準準拠の公開可能なパッケージメタデータに対してロックするために使用されます。

May also be set with the UV_NO_SOURCES environment variable.UV_NO_SOURCES 環境変数でも設定できます。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数でも設定できます。

--only-dev--only-dev

Only include the development dependency group.開発依存関係グループのみを含めます。

The project and its dependencies will be omitted.プロジェクトとその依存関係は省略されます。

This option is an alias for --only-group dev. Implies --no-default-groups.このオプションは --only-group dev のエイリアスです。 --no-default-groups を暗示します。

--only-group only-group--only-group only-group

Only include dependencies from the specified dependency group.指定された依存関係グループからの依存関係のみを含めます。

The project and its dependencies will be omitted.プロジェクトとその依存関係は省略されます。

May be provided multiple times. Implies --no-default-groups.複数回提供することができます。--no-default-groupsを暗示します。

--outdated--outdated

Show the latest available version of each package in the treeツリー内の各パッケージの最新の利用可能バージョンを表示します。

--package package--package package

Display only the specified packages指定されたパッケージのみを表示します。

--prerelease prerelease--prerelease prerelease

The strategy to use when considering pre-release versions.プレリリースバージョンを考慮する際に使用する戦略。

By default, uv will accept pre-releases for packages that only publish pre-releases, along with first-party requirements that contain an explicit pre-release marker in the declared specifiers (if-necessary-or-explicit).デフォルトでは、uvはのみプレリリースを公開するパッケージと、宣言された指定子に明示的なプレリリースマーカーを含むファーストパーティの要件を受け入れます（if-necessary-or-explicit）。

May also be set with the UV_PRERELEASE environment variable.また、UV_PRERELEASE環境変数で設定することもできます。

Possible values:可能な値：

disallow: Disallow all pre-release versionsdisallow: すべてのプレリリースバージョンを禁止する
allow: Allow all pre-release versionsallow: すべてのプレリリースバージョンを許可する
if-necessary: Allow pre-release versions if all versions of a package are pre-releaseif-necessary: すべてのバージョンがプレリリースである場合にプレリリースバージョンを許可する
explicit: Allow pre-release versions for first-party packages with explicit pre-release markers in their version requirementsexplicit: バージョン要件に明示的なプレリリースマーカーを持つファーストパーティパッケージに対してプレリリースバージョンを許可する
if-necessary-or-explicit: Allow pre-release versions if all versions of a package are pre-release, or if the package has an explicit pre-release marker in its version requirementsif-necessary-or-explicit: すべてのバージョンがプレリリースである場合、またはパッケージのバージョン要件に明示的なプレリリースマーカーがある場合にプレリリースバージョンを許可する

--project project--project project

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数を使用して設定することもできます。

--prune prune--prune プルーニング

Prune the given package from the display of the dependency tree依存関係ツリーの表示から指定されたパッケージをプルーニングします。

--python, -p python--python、-p python

The Python interpreter to use for locking and filtering.ロックとフィルタリングに使用するPythonインタープリター。

By default, the tree is filtered to match the platform as reported by the Python interpreter. Use --universal to display the tree for all platforms, or use --python-version or --python-platform to override a subset of markers.デフォルトでは、ツリーはPythonインタープリターによって報告されたプラットフォームに一致するようにフィルタリングされます。すべてのプラットフォームのツリーを表示するには --universal を使用するか、--python-version または --python-platform を使用してマーカーのサブセットを上書きします。

See uv python for details on Python discovery and supported request formats.詳細についてはuv pythonを参照してください。Pythonの発見とサポートされているリクエスト形式について。

May also be set with the UV_PYTHON environment variable.UV_PYTHON環境変数を使用して設定することもできます。

--python-platform python-platform--python-platform python-platform

The platform to use when filtering the tree.ツリーをフィルタリングする際に使用するプラットフォーム。

For example, pass --platform windows to display the dependencies that would be included when installing on Windows.例えば、--platform windowsを渡すと、Windowsにインストールする際に含まれる依存関係が表示されます。

Represented as a "target triple", a string that describes the target platform in terms of its CPU, vendor, and operating system name, like x86_64-unknown-linux-gnu or aarch64-apple-darwin.ターゲットプラットフォームをCPU、ベンダー、およびオペレーティングシステム名で説明する文字列である「ターゲットトリプル」として表されます。例：x86_64-unknown-linux-gnuやaarch64-apple-darwin。

Possible values:可能な値：

windows: An alias for x86_64-pc-windows-msvc, the default target for Windowswindows: x86_64-pc-windows-msvcのエイリアスで、Windowsのデフォルトターゲット。
linux: An alias for x86_64-unknown-linux-gnu, the default target for Linuxlinux: x86_64-unknown-linux-gnuのエイリアスで、Linuxのデフォルトターゲット。
macos: An alias for aarch64-apple-darwin, the default target for macOSmacos: aarch64-apple-darwinのエイリアスで、macOSのデフォルトターゲット。
x86_64-pc-windows-msvc: A 64-bit x86 Windows targetx86_64-pc-windows-msvc: 64ビットx86 Windowsターゲット
aarch64-pc-windows-msvc: An ARM64 Windows targetaarch64-pc-windows-msvc: ARM64 Windowsターゲット
i686-pc-windows-msvc: A 32-bit x86 Windows targeti686-pc-windows-msvc: 32ビットx86 Windowsターゲット
x86_64-unknown-linux-gnu: An x86 Linux target. Equivalent to x86_64-manylinux_2_28x86_64-unknown-linux-gnu: x86 Linuxターゲット。x86_64-manylinux_2_28と同等
aarch64-apple-darwin: An ARM-based macOS target, as seen on Apple Silicon devicesaarch64-apple-darwin: Apple Siliconデバイスで見られるARMベースのmacOSターゲット
x86_64-apple-darwin: An x86 macOS targetx86_64-apple-darwin: x86 macOSターゲット
aarch64-unknown-linux-gnu: An ARM64 Linux target. Equivalent to aarch64-manylinux_2_28aarch64-unknown-linux-gnu: ARM64 Linuxターゲット。aarch64-manylinux_2_28と同等
aarch64-unknown-linux-musl: An ARM64 Linux targetaarch64-unknown-linux-musl: ARM64 Linuxターゲット
x86_64-unknown-linux-musl: An x86_64 Linux targetx86_64-unknown-linux-musl: x86_64 Linuxターゲット
riscv64-unknown-linux: A RISCV64 Linux targetriscv64-unknown-linux: RISCV64 Linuxターゲット
x86_64-manylinux2014: An x86_64 target for the manylinux2014 platform. Equivalent to x86_64-manylinux_2_17x86_64-manylinux2014: x86_64 ターゲットの manylinux2014 プラットフォーム。 x86_64-manylinux_2_17 と同等です。
x86_64-manylinux_2_17: An x86_64 target for the manylinux_2_17 platformx86_64-manylinux_2_17: x86_64 ターゲットの manylinux_2_17 プラットフォーム。
x86_64-manylinux_2_28: An x86_64 target for the manylinux_2_28 platformx86_64-manylinux_2_28: x86_64 ターゲットの manylinux_2_28 プラットフォーム。
x86_64-manylinux_2_31: An x86_64 target for the manylinux_2_31 platformx86_64-manylinux_2_31: x86_64 ターゲットの manylinux_2_31 プラットフォーム。
x86_64-manylinux_2_32: An x86_64 target for the manylinux_2_32 platformx86_64-manylinux_2_32: x86_64 ターゲットの manylinux_2_32 プラットフォーム。
x86_64-manylinux_2_33: An x86_64 target for the manylinux_2_33 platformx86_64-manylinux_2_33: x86_64 ターゲットの manylinux_2_33 プラットフォーム。
x86_64-manylinux_2_34: An x86_64 target for the manylinux_2_34 platformx86_64-manylinux_2_34: x86_64 ターゲットの manylinux_2_34 プラットフォーム。
x86_64-manylinux_2_35: An x86_64 target for the manylinux_2_35 platformx86_64-manylinux_2_35: x86_64 ターゲットの manylinux_2_35 プラットフォーム。
x86_64-manylinux_2_36: An x86_64 target for the manylinux_2_36 platformx86_64-manylinux_2_36: x86_64 ターゲットの manylinux_2_36 プラットフォーム。
x86_64-manylinux_2_37: An x86_64 target for the manylinux_2_37 platformx86_64-manylinux_2_37: x86_64 ターゲットの manylinux_2_37 プラットフォーム。
x86_64-manylinux_2_38: An x86_64 target for the manylinux_2_38 platformx86_64-manylinux_2_38: manylinux_2_38プラットフォーム用のx86_64ターゲット
x86_64-manylinux_2_39: An x86_64 target for the manylinux_2_39 platformx86_64-manylinux_2_39: manylinux_2_39プラットフォーム用のx86_64ターゲット
x86_64-manylinux_2_40: An x86_64 target for the manylinux_2_40 platformx86_64-manylinux_2_40: manylinux_2_40プラットフォーム用のx86_64ターゲット
aarch64-manylinux2014: An ARM64 target for the manylinux2014 platform. Equivalent to aarch64-manylinux_2_17aarch64-manylinux2014: manylinux2014プラットフォーム用のARM64ターゲット。aarch64-manylinux_2_17と同等
aarch64-manylinux_2_17: An ARM64 target for the manylinux_2_17 platformaarch64-manylinux_2_17: manylinux_2_17プラットフォーム用のARM64ターゲット
aarch64-manylinux_2_28: An ARM64 target for the manylinux_2_28 platformaarch64-manylinux_2_28: manylinux_2_28プラットフォーム用のARM64ターゲット
aarch64-manylinux_2_31: An ARM64 target for the manylinux_2_31 platformaarch64-manylinux_2_31: manylinux_2_31プラットフォーム用のARM64ターゲット
aarch64-manylinux_2_32: An ARM64 target for the manylinux_2_32 platformaarch64-manylinux_2_32: manylinux_2_32プラットフォーム用のARM64ターゲット
aarch64-manylinux_2_33: An ARM64 target for the manylinux_2_33 platformaarch64-manylinux_2_33: manylinux_2_33プラットフォーム用のARM64ターゲット
aarch64-manylinux_2_34: An ARM64 target for the manylinux_2_34 platformaarch64-manylinux_2_34: manylinux_2_34プラットフォーム用のARM64ターゲット
aarch64-manylinux_2_35: An ARM64 target for the manylinux_2_35 platformaarch64-manylinux_2_35: manylinux_2_35 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_36: An ARM64 target for the manylinux_2_36 platformaarch64-manylinux_2_36: manylinux_2_36 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_37: An ARM64 target for the manylinux_2_37 platformaarch64-manylinux_2_37: manylinux_2_37 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_38: An ARM64 target for the manylinux_2_38 platformaarch64-manylinux_2_38: manylinux_2_38 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_39: An ARM64 target for the manylinux_2_39 platformaarch64-manylinux_2_39: manylinux_2_39 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_40: An ARM64 target for the manylinux_2_40 platformaarch64-manylinux_2_40: manylinux_2_40 プラットフォーム用の ARM64 ターゲット
aarch64-linux-android: An ARM64 Android targetaarch64-linux-android: ARM64 Android ターゲット
x86_64-linux-android: An x86_64 Android targetx86_64-linux-android: x86_64 Android ターゲット
wasm32-pyodide2024: A wasm32 target using the Pyodide 2024 platform. Meant for use with Python 3.12wasm32-pyodide2024: Pyodide 2024 プラットフォームを使用した wasm32 ターゲット。Python 3.12 用に設計されています
arm64-apple-ios: An ARM64 target for iOS devicearm64-apple-ios: iOS デバイス用の ARM64 ターゲット
arm64-apple-ios-simulator: An ARM64 target for iOS simulatorarm64-apple-ios-simulator: iOSシミュレーター用のARM64ターゲット
x86_64-apple-ios-simulator: An x86_64 target for iOS simulatorx86_64-apple-ios-simulator: iOSシミュレーター用のx86_64ターゲット

--python-version python-version--python-version python-version

The Python version to use when filtering the tree.ツリーをフィルタリングする際に使用するPythonのバージョン。

For example, pass --python-version 3.10 to display the dependencies that would be included when installing on Python 3.10.例えば、--python-version 3.10を渡すと、Python 3.10にインストールする際に含まれる依存関係が表示されます。

Defaults to the version of the discovered Python interpreter.発見されたPythonインタープリターのバージョンがデフォルトとなります。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば-qq、uvはstdoutに出力を行わないサイレントモードを有効にします。

--resolution resolution--resolution resolution

The strategy to use when selecting between the different compatible versions for a given package requirement.特定のパッケージ要件に対して異なる互換バージョンを選択する際に使用する戦略。

By default, uv will use the latest compatible version of each package (highest).デフォルトでは、uvは各パッケージの最新の互換バージョンを使用します（highest）。

May also be set with the UV_RESOLUTION environment variable.UV_RESOLUTION 環境変数で設定することもできます。

Possible values:可能な値：

highest: Resolve the highest compatible version of each packagehighest: 各パッケージの最高の互換バージョンを解決します
lowest: Resolve the lowest compatible version of each packagelowest: 各パッケージの最低の互換バージョンを解決します
lowest-direct: Resolve the lowest compatible version of any direct dependencies, and the highest compatible version of any transitive dependencieslowest-direct: 直接依存関係の最低の互換バージョンを解決し、推移的依存関係の最高の互換バージョンを解決します

--script script--script script

Show the dependency tree the specified PEP 723 Python script, rather than the current project.現在のプロジェクトではなく、指定されたPEP 723 Pythonスクリプトの依存関係ツリーを表示します。

If provided, uv will resolve the dependencies based on its inline metadata table, in adherence with PEP 723.提供された場合、uvはPEP 723に従ってインラインメタデータテーブルに基づいて依存関係を解決します。

--show-sizes--show-sizes

Show compressed wheel sizes for packages in the treeツリー内のパッケージの圧縮ホイールサイズを表示します

--universal--universal

Show a platform-independent dependency tree.プラットフォームに依存しない依存関係ツリーを表示します。

Shows resolved package versions for all Python versions and platforms, rather than filtering to those that are relevant for the current environment.現在の環境に関連するものにフィルタリングするのではなく、すべてのPythonバージョンとプラットフォームの解決されたパッケージバージョンを表示します。

Multiple versions may be shown for a each package.各パッケージに対して複数のバージョンが表示される場合があります。

--upgrade, -U--upgrade, -U

Allow package upgrades, ignoring pinned versions in any existing output file. Implies --refresh既存の出力ファイル内の固定バージョンを無視して、パッケージのアップグレードを許可します。--refreshを含意します。

--upgrade-package, -P upgrade-package--upgrade-package, -P upgrade-package

Allow upgrades for a specific package, ignoring pinned versions in any existing output file. Implies --refresh-package特定のパッケージのアップグレードを許可し、既存の出力ファイル内の固定バージョンを無視します。--refresh-packageを含意します。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)環境変数 RUST_LOG を使用して、細かいログ設定を行うことができます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv formatuv format

Format Python code in the project.プロジェクト内のPythonコードをフォーマットします。

Formats Python code using the Ruff formatter. By default, all Python files in the project are formatted. This command has the same behavior as running ruff format in the project root.Ruffフォーマッターを使用してPythonコードをフォーマットします。デフォルトでは、プロジェクト内のすべてのPythonファイルがフォーマットされます。このコマンドは、プロジェクトのルートで ruff format を実行するのと同じ動作をします。

To check if files are formatted without modifying them, use --check. To see a diff of formatting changes, use --diff.ファイルを変更せずにフォーマットされているか確認するには --check を使用します。フォーマットの変更のdiffを表示するには --diff を使用します。

Additional arguments can be passed to Ruff after --.追加の引数は -- の後にRuffに渡すことができます。

Usage使用法

uv format [OPTIONS] [-- <EXTRA_ARGS>...]

Arguments引数

EXTRA_ARGSEXTRA_ARGS

Additional arguments to pass to Ruff.Ruffに渡す追加の引数。

For example, use uv format -- --line-length 100 to set the line length or uv format -- src/module/foo.py to format a specific file.例えば、uv format -- --line-length 100を使用して行の長さを設定したり、uv format -- src/module/foo.pyを使用して特定のファイルをフォーマットしたりします。

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回提供することができます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数を使用して設定することもできます。

--cache-dir cache-dir--cache-dir キャッシュディレクトリ

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.デフォルトでは $XDG_CACHE_HOME/uv または $HOME/.cache/uv（macOSおよびLinux）、および %LOCALAPPDATA%\uv\cache（Windows）に設定されています。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR 環境変数を使用して設定することもできます。

--check--check

Check if files are formatted without applying changes変更を適用せずにファイルがフォーマットされているかを確認します。

--color color-choice--color 色の選択

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvはターミナルへの書き込み時に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力が端末またはTTYに送信される場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用するuv.tomlファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数を使用して設定することもできます。

--diff--diff

Show a diff of formatting changes without applying them.変更されたフォーマットのdiffを表示しますが、適用はしません。

Implies --check.--checkを意味します。

--directory directory--directory ディレクトリ

Change to the given directory prior to running the command.コマンドを実行する前に指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数を使用して設定することもできます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--managed-python--managed-python

Require use of uv-managed Python versions.uv-managed Pythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理しているPythonバージョンを使用することを好みます。ただし、uvが管理しているPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.また、UV_MANAGED_PYTHON環境変数で設定することもできます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、特にシステムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したいことがあります。

May also be set with the UV_NATIVE_TLS environment variable.また、UV_NATIVE_TLS環境変数で設定することもできます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りまたは書き込みを避け、操作の期間中は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.また、UV_NO_CACHE環境変数で設定することもできます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml、uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.UV_NO_CONFIG 環境変数で設定することもできます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON 環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバー。

May also be set with the UV_NO_PROGRESS environment variable.また、UV_NO_PROGRESS 環境変数で設定することもできます。

--no-project--no-project

Avoid discovering a project or workspace.プロジェクトやワークスペースの発見を避けます。

Instead of running the formatter in the context of the current project, run it in the context of the current directory. This is useful when the current directory is not a project.現在のプロジェクトのコンテキストでフォーマッタを実行する代わりに、現在のディレクトリのコンテキストで実行します。これは、現在のディレクトリがプロジェクトでない場合に便利です。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.また、UV_OFFLINE 環境変数で設定することもできます。

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に辿ることで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用される場合、効果がありません。

May also be set with the UV_PROJECT environment variable.また、UV_PROJECT 環境変数で設定することもできます。

--quiet, -q--quiet、-q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uvがstdoutに出力を行わないサイレントモードが有効になります。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)環境変数 RUST_LOG を使用して、細かいログ設定を行うことができます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

--version version--version バージョン

The version of Ruff to use for formatting.フォーマットに使用するRuffのバージョン。

By default, a version of Ruff pinned by uv will be used.デフォルトでは、uvによって固定されたRuffのバージョンが使用されます。

uv tooluvツール

Run and install commands provided by Python packagesPythonパッケージによって提供されるコマンドを実行およびインストールします。

Usage使用法

uv tool [OPTIONS] <COMMAND>

Commandsコマンド

uv tool runuv tool run: Run a command provided by a Python packagePythonパッケージによって提供されたコマンドを実行します
uv tool installuv tool install: Install commands provided by a Python packagePythonパッケージによって提供されたコマンドをインストールします
uv tool upgradeuv tool upgrade: Upgrade installed toolsインストールされたツールをアップグレードします
uv tool listuv tool list: List installed toolsインストールされたツールの一覧を表示します
uv tool uninstalluv tool uninstall: Uninstall a toolツールをアンインストールする
uv tool update-shelluv tool update-shell: Ensure that the tool executable directory is on the PATHツールの実行可能ディレクトリがPATHに含まれていることを確認してください
uv tool diruv tool dir: Show the path to the uv tools directoryuvツールディレクトリへのパスを表示します

uv tool runuv tool run

Run a command provided by a Python package.Pythonパッケージによって提供されたコマンドを実行します。

By default, the package to install is assumed to match the command name.デフォルトでは、インストールするパッケージはコマンド名と一致するものと見なされます。

The name of the command can include an exact version in the format <package>@<version>, e.g., uv tool run ruff@0.3.0. If more complex version specification is desired or if the command is provided by a different package, use --from.コマンドの名前には、<package>@<version>形式の正確なバージョンを含めることができます。例：uv tool run ruff@0.3.0。より複雑なバージョン指定が必要な場合や、コマンドが別のパッケージによって提供されている場合は、--fromを使用してください。

uvx can be used to invoke Python, e.g., with uvx python or uvx python@<version>. A Python interpreter will be started in an isolated virtual environment.uvxを使用してPythonを呼び出すことができます。例：uvx pythonまたはuvx python@<version>。Pythonインタプリタは、隔離された仮想環境で起動されます。

If the tool was previously installed, i.e., via uv tool install, the installed version will be used unless a version is requested or the --isolated flag is used.ツールが以前にインストールされていた場合、すなわち、uv tool installを介して、インストールされたバージョンが使用されます。ただし、バージョンが要求されるか、--isolatedフラグが使用される場合は除きます。

uvx is provided as a convenient alias for uv tool run, their behavior is identical.uvxはuv tool runの便利なエイリアスとして提供されており、その動作は同一です。

If no command is provided, the installed tools are displayed.コマンドが提供されない場合、インストールされたツールが表示されます。

Packages are installed into an ephemeral virtual environment in the uv cache directory.パッケージは、uvキャッシュディレクトリ内の一時的な仮想環境にインストールされます。

Usage使用法

uv tool run [OPTIONS] [COMMAND]

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host、--trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回提供できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告: このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、検証されたソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--build-constraints, --build-constraint, -b build-constraints--build-constraints, --build-constraint, -b build-constraints

Constrain build dependencies using the given requirements files when building source distributions.ソース配布物をビルドする際に、指定された要件ファイルを使用してビルド依存関係を制約します。

Constraints files are requirements.txt-like files that only control the version of a requirement that's installed. However, including a package in a constraints file will not trigger the installation of that package.制約ファイルは、インストールされる要件のバージョンのみを制御するrequirements.txtのようなファイルです。ただし、制約ファイルにパッケージを含めても、そのパッケージのインストールはトリガーされません。

May also be set with the UV_BUILD_CONSTRAINT environment variable.UV_BUILD_CONSTRAINT環境変数でも設定できます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvにデフォルト設定され、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されます。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行してください。

May also be set with the UV_CACHE_DIR environment variable.環境変数 UV_CACHE_DIR でも設定できます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末への書き込み時に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力がサポートされている端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--compile-bytecode, --compile--compile-bytecode, --compile

Compile Python files to bytecode after installation.インストール後にPythonファイルをバイトコードにコンパイルします。

By default, uv does not compile Python (.py) files to bytecode (__pycache__/*.pyc); instead, compilation is performed lazily the first time a module is imported. For use-cases in which start time is critical, such as CLI applications and Docker containers, this option can be enabled to trade longer installation times for faster start times.デフォルトでは、uvはPython（.py）ファイルをバイトコード（__pycache__/*.pyc）にコンパイルしません。代わりに、モジュールが最初にインポートされるときに遅延コンパイルが行われます。CLIアプリケーションやDockerコンテナなど、起動時間が重要なユースケースでは、このオプションを有効にすることで、より長いインストール時間と引き換えに、より速い起動時間を得ることができます。

When enabled, uv will process the entire site-packages directory (including packages that are not being modified by the current operation) for consistency. Like pip, it will also ignore errors.有効にすると、uvは整合性のためにサイトパッケージディレクトリ全体（現在の操作によって変更されていないパッケージを含む）を処理します。pipのように、エラーは無視されます。

May also be set with the UV_COMPILE_BYTECODE environment variable.また、UV_COMPILE_BYTECODE環境変数で設定することもできます。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用するuv.tomlファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.また、UV_CONFIG_FILE環境変数で設定することもできます。

--config-setting, --config-settings, -C config-setting--config-setting, --config-settings, -C config-setting

Settings to pass to the PEP 517 build backend, specified as KEY=VALUE pairsPEP 517ビルドバックエンドに渡す設定で、KEY=VALUEペアとして指定します。

--config-settings-package, --config-settings-package config-settings-package--config-settings-package, --config-settings-package config-settings-package

Settings to pass to the PEP 517 build backend for a specific package, specified as PACKAGE:KEY=VALUE pairs特定のパッケージに対してPEP 517ビルドバックエンドに渡す設定は、PACKAGE:KEY=VALUEペアとして指定されます。

--constraints, --constraint, -c constraints--constraints, --constraint, -c constraints

Constrain versions using the given requirements files.指定された要件ファイルを使用してバージョンを制約します。

Constraints files are requirements.txt-like files that only control the version of a requirement that's installed. However, including a package in a constraints file will not trigger the installation of that package.制約ファイルは、インストールされる要件のバージョンのみを制御するrequirements.txtのようなファイルです。ただし、制約ファイルにパッケージを含めても、そのパッケージのインストールはトリガーされません。

This is equivalent to pip's --constraint option.これはpipの--constraintオプションと同等です。

May also be set with the UV_CONSTRAINT environment variable.UV_CONSTRAINT環境変数を使用して設定することもできます。

--default-index default-index--default-index default-index

The URL of the default package index (by default: https://pypi.org/simple).デフォルトのパッケージインデックスのURL（デフォルトでは: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --index flag.このフラグで指定されたインデックスは、--indexフラグを介して指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_DEFAULT_INDEX environment variable.UV_DEFAULT_INDEX 環境変数で設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--project を参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY 環境変数で設定することもできます。

--env-file env-file--env-file env-file

Load environment variables from a .env file..env ファイルから環境変数を読み込みます。

Can be provided multiple times, with subsequent files overriding values defined in previous files.複数回提供することができ、後続のファイルが前のファイルで定義された値を上書きします。

May also be set with the UV_ENV_FILE environment variable.UV_ENV_FILE 環境変数で設定することもできます。

--exclude-newer exclude-newer--exclude-newer exclude-newer

Limit candidate packages to those that were uploaded prior to the given date.候補パッケージを指定された日付以前にアップロードされたものに制限します。

Accepts both RFC 3339 timestamps (e.g., 2006-12-02T02:07:43Z) and local dates in the same format (e.g., 2006-12-02) in your system's configured time zone.RFC 3339 タイムスタンプ（例: 2006-12-02T02:07:43Z）と、システムの設定されたタイムゾーンでの同じ形式のローカル日付（例: 2006-12-02）の両方を受け入れます。

May also be set with the UV_EXCLUDE_NEWER environment variable.UV_EXCLUDE_NEWER 環境変数で設定することもできます。

--exclude-newer-package exclude-newer-package--exclude-newer-package exclude-newer-package

Limit candidate packages for specific packages to those that were uploaded prior to the given date.特定のパッケージの候補パッケージを指定された日付以前にアップロードされたものに制限します。

Accepts package-date pairs in the format PACKAGE=DATE, where DATE is an RFC 3339 timestamp (e.g., 2006-12-02T02:07:43Z) or local date (e.g., 2006-12-02) in your system's configured time zone.PACKAGE=DATE 形式のパッケージ-日付ペアを受け入れます。ここで DATE は RFC 3339 タイムスタンプ（例: 2006-12-02T02:07:43Z）またはローカル日付（例: 2006-12-02）で、システムの設定されたタイムゾーンに基づきます。

Can be provided multiple times for different packages.異なるパッケージのために複数回提供することができます。

--extra-index-url extra-index-url--extra-index-url extra-index-url

(Deprecated: use --index instead) Extra URLs of package indexes to use, in addition to --index-url.(非推奨: 代わりに --index を使用してください) --index-url に加えて使用するパッケージインデックスの追加URLです。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリまたは同じ形式でレイアウトされたローカルディレクトリのいずれかを受け入れます。

All indexes provided via this flag take priority over the index specified by --index-url (which defaults to PyPI). When multiple --extra-index-url flags are provided, earlier values take priority.このフラグで提供されたすべてのインデックスは、--index-url（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の--extra-index-urlフラグが提供されると、先に指定された値が優先されます。

May also be set with the UV_EXTRA_INDEX_URL environment variable.UV_EXTRA_INDEX_URL環境変数でも設定できます。

--find-links, -f find-links--find-links, -f find-links

Locations to search for candidate distributions, in addition to those found in the registry indexes.レジストリインデックスで見つかったものに加えて、候補の配布物を検索する場所。

If a path, the target must be a directory that contains packages as wheel files (.whl) or source distributions (e.g., .tar.gz or .zip) at the top level.パスの場合、ターゲットはトップレベルにホイールファイル（.whl）またはソース配布（例：.tar.gzまたは.zip）を含むディレクトリでなければなりません。

If a URL, the page must contain a flat list of links to package files adhering to the formats described above.URLの場合、そのページは上記の形式に従ったパッケージファイルへのリンクのフラットリストを含む必要があります。

May also be set with the UV_FIND_LINKS environment variable.UV_FIND_LINKS環境変数でも設定できます。

--fork-strategy fork-strategy--fork-strategy fork-strategy

The strategy to use when selecting multiple versions of a given package across Python versions and platforms.Pythonのバージョンやプラットフォームにわたって、特定のパッケージの複数のバージョンを選択する際に使用する戦略。

By default, uv will optimize for selecting the latest version of each package for each supported Python version (requires-python), while minimizing the number of selected versions across platforms.デフォルトでは、uvは各サポートされているPythonバージョン（requires-python）に対して各パッケージの最新バージョンを選択することを最適化し、プラットフォーム全体で選択されたバージョンの数を最小限に抑えます。

Under fewest, uv will minimize the number of selected versions for each package, preferring older versions that are compatible with a wider range of supported Python versions or platforms.fewestの下では、uvは各パッケージの選択されたバージョンの数を最小限に抑え、より広範囲のサポートされているPythonバージョンやプラットフォームと互換性のある古いバージョンを優先します。

May also be set with the UV_FORK_STRATEGY environment variable.また、UV_FORK_STRATEGY環境変数で設定することもできます。

Possible values:可能な値：

fewest: Optimize for selecting the fewest number of versions for each package. Older versions may be preferred if they are compatible with a wider range of supported Python versions or platformsfewest: 各パッケージの選択されたバージョンの数を最小限に抑えることを最適化します。より広範囲のサポートされているPythonバージョンやプラットフォームと互換性がある場合、古いバージョンが優先されることがあります。
requires-python: Optimize for selecting latest supported version of each package, for each supported Python versionrequires-python: 各サポートされているPythonバージョンに対して、各パッケージの最新のサポートされているバージョンを選択することを最適化します。

--from from--from from

Use the given package to provide the command.指定されたパッケージを使用してコマンドを提供します。

By default, the package name is assumed to match the command name.デフォルトでは、パッケージ名はコマンド名と一致するものと見なされます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します

--index index--index index

The URLs to use when resolving dependencies, in addition to the default index.デフォルトのインデックスに加えて、依存関係を解決する際に使用するURL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式で配置されたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --default-index (which defaults to PyPI). When multiple --index flags are provided, earlier values take priority.このフラグを介して提供されたすべてのインデックスは、--default-index（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の--indexフラグが提供される場合、先に指定された値が優先されます。

Index names are not supported as values. Relative paths must be disambiguated from index names with ./ or ../ on Unix or .\\, ..\\, ./ or ../ on Windows.インデックス名は値としてサポートされていません。相対パスは、Unixでは./または../、Windowsでは.\\、..\\、./または../でインデックス名と区別する必要があります。

May also be set with the UV_INDEX environment variable.UV_INDEX環境変数を使用して設定することもできます。

--index-strategy index-strategy--index-strategy index-strategy

The strategy to use when resolving against multiple index URLs.複数のインデックスURLに対して解決する際に使用する戦略。

By default, uv will stop at the first index on which a given package is available, and limit resolutions to those present on that first index (first-index). This prevents "dependency confusion" attacks, whereby an attacker can upload a malicious package under the same name to an alternate index.デフォルトでは、uvは指定されたパッケージが利用可能な最初のインデックスで停止し、その最初のインデックスに存在するものに解決を制限します（first-index）。これにより、攻撃者が別のインデックスに同じ名前の悪意のあるパッケージをアップロードすることによる「依存関係の混乱」攻撃を防ぎます。

May also be set with the UV_INDEX_STRATEGY environment variable.また、UV_INDEX_STRATEGY 環境変数で設定することもできます。

Possible values:可能な値：

first-index: Only use results from the first index that returns a match for a given package namefirst-index: 指定されたパッケージ名に対して一致する最初のインデックスからの結果のみを使用します。
unsafe-first-match: Search for every package name across all indexes, exhausting the versions from the first index before moving on to the nextunsafe-first-match: すべてのインデックスで各パッケージ名を検索し、次のインデックスに移る前に最初のインデックスからのバージョンを使い切ります。
unsafe-best-match: Search for every package name across all indexes, preferring the "best" version found. If a package version is in multiple indexes, only look at the entry for the first indexunsafe-best-match: すべてのインデックスで各パッケージ名を検索し、見つかった「最良」のバージョンを優先します。パッケージバージョンが複数のインデックスに存在する場合、最初のインデックスのエントリのみを参照します。

--index-url, -i index-url--index-url, -i index-url

(Deprecated: use --default-index instead) The URL of the Python package index (by default: https://pypi.org/simple).(非推奨: 代わりに --default-index を使用してください) Python パッケージインデックスの URL (デフォルト: https://pypi.org/simple)。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリまたは同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --extra-index-url flag.このフラグで指定されたインデックスは、--extra-index-url フラグで指定されたすべての他のインデックスよりも優先度が低くなります。

May also be set with the UV_INDEX_URL environment variable.また、UV_INDEX_URL 環境変数で設定することもできます。

--isolated--isolated

Run the tool in an isolated virtual environment, ignoring any already-installed toolsツールを孤立した仮想環境で実行し、既にインストールされているツールを無視します。

May also be set with the UV_ISOLATED environment variable.UV_ISOLATED 環境変数で設定することもできます。

--keyring-provider keyring-provider--keyring-provider keyring-provider

Attempt to use keyring for authentication for index URLs.インデックスURLの認証に keyring を使用しようとします。

At present, only --keyring-provider subprocess is supported, which configures uv to use the keyring CLI to handle authentication.現在のところ、--keyring-provider subprocess のみがサポートされており、uvが認証を処理するために keyring CLI を使用するように構成されます。

Defaults to disabled.デフォルトは disabled です。

May also be set with the UV_KEYRING_PROVIDER environment variable.UV_KEYRING_PROVIDER 環境変数で設定することもできます。

Possible values:可能な値：

disabled: Do not use keyring for credential lookupdisabled: 認証情報の検索にkeyringを使用しない
subprocess: Use the keyring command for credential lookupsubprocess: 認証情報の検索には keyring コマンドを使用します

--link-mode link-mode--link-mode link-mode

The method to use when installing packages from the global cache.グローバルキャッシュからパッケージをインストールする際に使用する方法。

Defaults to clone (also known as Copy-on-Write) on macOS, and hardlink on Linux and Windows.macOSでは clone（コピーオンライトとも呼ばれる）にデフォルト設定され、LinuxおよびWindowsでは hardlink にデフォルト設定されています。

WARNING: The use of symlink link mode is discouraged, as they create tight coupling between the cache and the target environment. For example, clearing the cache (uv cache clean) will break all installed packages by way of removing the underlying source files. Use symlinks with caution.警告: シンボリックリンクモードの使用は推奨されません。キャッシュとターゲット環境の間に強い結合を作成するためです。たとえば、キャッシュをクリアする (uv cache clean) と、基盤となるソースファイルが削除されるため、すべてのインストールされたパッケージが壊れます。シンボリックリンクは注意して使用してください。

May also be set with the UV_LINK_MODE environment variable.UV_LINK_MODE 環境変数でも設定できます。

Possible values:可能な値:

clone: Clone (i.e., copy-on-write) packages from the wheel into the site-packages directoryclone: ホイールから site-packages ディレクトリにパッケージをクローン（コピーオンライト）します
copy: Copy packages from the wheel into the site-packages directorycopy: ホイールから site-packages ディレクトリにパッケージをコピーします
hardlink: Hard link packages from the wheel into the site-packages directoryhardlink: ホイールから site-packages ディレクトリにパッケージをハードリンクします
symlink: Symbolically link packages from the wheel into the site-packages directorysymlink: パッケージをホイールからsite-packagesディレクトリにシンボリックリンクします

--managed-python--managed-python

Require use of uv-managed Python versions.uv-managed Pythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理しているPythonバージョンの使用を優先します。ただし、uv-managed Pythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、プラットフォームのネイティブ証明書ストアを使用したいことがあります。特に、システムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合です。

May also be set with the UV_NATIVE_TLS environment variable.UV_NATIVE_TLS環境変数でも設定できます。

--no-binary--no-binary

Don't install pre-built wheels.事前にビルドされたホイールをインストールしないでください。

The given packages will be built and installed from source. The resolver will still use pre-built wheels to extract package metadata, if available.指定されたパッケージはソースからビルドされ、インストールされます。リゾルバは、利用可能な場合、パッケージメタデータを抽出するために事前にビルドされたホイールを使用します。

May also be set with the UV_NO_BINARY environment variable.UV_NO_BINARY 環境変数でも設定できます。

--no-binary-package no-binary-package--no-binary-package no-binary-package

Don't install pre-built wheels for a specific package特定のパッケージに対して事前にビルドされたホイールをインストールしないでください。

May also be set with the UV_NO_BINARY_PACKAGE environment variable.UV_NO_BINARY_PACKAGE 環境変数でも設定できます。

--no-build--no-build

Don't build source distributions.ソース配布物をビルドしないでください。

When enabled, resolving will not run arbitrary Python code. The cached wheels of already-built source distributions will be reused, but operations that require building distributions will exit with an error.有効にすると、リゾルビングは任意のPythonコードを実行しません。既にビルドされたソース配布物のキャッシュされたホイールは再利用されますが、配布物のビルドを必要とする操作はエラーで終了します。

May also be set with the UV_NO_BUILD environment variable.環境変数 UV_NO_BUILD でも設定できます。

--no-build-isolation--no-build-isolation

Disable isolation when building source distributions.ソース配布物をビルドする際に隔離を無効にします。

Assumes that build dependencies specified by PEP 518 are already installed.PEP 518 で指定されたビルド依存関係がすでにインストールされていると仮定します。

May also be set with the UV_NO_BUILD_ISOLATION environment variable.環境変数 UV_NO_BUILD_ISOLATION でも設定できます。

--no-build-isolation-package no-build-isolation-package--no-build-isolation-package no-build-isolation-package

Disable isolation when building source distributions for a specific package.特定のパッケージのソース配布物をビルドする際に隔離を無効にします。

Assumes that the packages' build dependencies specified by PEP 518 are already installed.パッケージのビルド依存関係が PEP 518 で指定されていると仮定します。

--no-build-package no-build-package--no-build-package no-build-package

Don't build source distributions for a specific package特定のパッケージのソース配布物をビルドしません

May also be set with the UV_NO_BUILD_PACKAGE environment variable.環境変数 UV_NO_BUILD_PACKAGE でも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.環境変数 UV_NO_CACHE でも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル (pyproject.toml, uv.toml) の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.環境変数 UV_NO_CONFIG でも設定できます。

--no-env-file--no-env-file

Avoid reading environment variables from a .env file.env ファイルから環境変数を読み取るのを避けます。

May also be set with the UV_NO_ENV_FILE environment variable.環境変数 UV_NO_ENV_FILE で設定することもできます。

--no-index--no-index

Ignore the registry index (e.g., PyPI), instead relying on direct URL dependencies and those provided via --find-linksレジストリインデックス（例：PyPI）を無視し、直接URL依存関係および --find-links を介して提供されるものに依存します。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.その代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.環境変数 UV_NO_MANAGED_PYTHON で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなど。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS 環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--no-sources--no-sources

Ignore the tool.uv.sources table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any workspace, Git, URL, or local path sourcestool.uv.sources テーブルを無視して依存関係を解決します。ワークスペース、Git、URL、またはローカルパスソースを使用するのではなく、標準準拠の公開可能なパッケージメタデータに対してロックするために使用されます。

May also be set with the UV_NO_SOURCES environment variable.UV_NO_SOURCES 環境変数で設定することもできます。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数で設定することもできます。

--overrides, --override overrides--overrides, --override オーバーライド

Override versions using the given requirements files.指定された要件ファイルを使用してバージョンをオーバーライドします。

Overrides files are requirements.txt-like files that force a specific version of a requirement to be installed, regardless of the requirements declared by any constituent package, and regardless of whether this would be considered an invalid resolution.オーバーライドファイルは、requirements.txtのようなファイルで、構成パッケージによって宣言された要件に関係なく、特定の要件のバージョンを強制的にインストールすることを目的としています。また、これが無効な解決策と見なされるかどうかにも関係ありません。

While constraints are additive, in that they're combined with the requirements of the constituent packages, overrides are absolute, in that they completely replace the requirements of the constituent packages.制約が構成パッケージの要件と組み合わされる加算的であるのに対し、オーバーライドは構成パッケージの要件を完全に置き換える絶対的なものです。

May also be set with the UV_OVERRIDE environment variable.UV_OVERRIDE環境変数を使用して設定することもできます。

--prerelease prerelease--prerelease プレリリース

The strategy to use when considering pre-release versions.プレリリースバージョンを考慮する際に使用する戦略。

By default, uv will accept pre-releases for packages that only publish pre-releases, along with first-party requirements that contain an explicit pre-release marker in the declared specifiers (if-necessary-or-explicit).デフォルトでは、uvはのみプレリリースを公開するパッケージと、宣言された指定子に明示的なプレリリースマーカーを含むファーストパーティの要件に対してプレリリースを受け入れます（if-necessary-or-explicit）。

May also be set with the UV_PRERELEASE environment variable.UV_PRERELEASE環境変数を使用して設定することもできます。

Possible values:可能な値：

disallow: Disallow all pre-release versionsdisallow: すべてのプレリリースバージョンを禁止
allow: Allow all pre-release versionsallow: すべてのプレリリースバージョンを許可
if-necessary: Allow pre-release versions if all versions of a package are pre-releaseif-necessary: パッケージのすべてのバージョンがプレリリースである場合にプレリリースバージョンを許可
explicit: Allow pre-release versions for first-party packages with explicit pre-release markers in their version requirementsexplicit: バージョン要件に明示的なプレリリースマーカーがあるファーストパーティパッケージに対してプレリリースバージョンを許可
if-necessary-or-explicit: Allow pre-release versions if all versions of a package are pre-release, or if the package has an explicit pre-release marker in its version requirementsif-necessary-or-explicit: パッケージのすべてのバージョンがプレリリースである場合、またはパッケージのバージョン要件に明示的なプレリリースマーカーがある場合にプレリリースバージョンを許可

--project project--project project

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数でも設定できます。

--python, -p python--python, -p python

The Python interpreter to use to build the run environment.実行環境を構築するために使用する Python インタプリタ。

See uv python for details on Python discovery and supported request formats.Python の発見とサポートされているリクエスト形式の詳細については、uv python を参照してください。

May also be set with the UV_PYTHON environment variable.UV_PYTHON 環境変数でも設定できます。

--python-platform python-platform--python-platform python-platform

The platform for which requirements should be installed.要件をインストールするプラットフォーム。

Represented as a "target triple", a string that describes the target platform in terms of its CPU, vendor, and operating system name, like x86_64-unknown-linux-gnu or aarch64-apple-darwin."ターゲットトリプル" として表され、x86_64-unknown-linux-gnu や aarch64-apple-darwin のように、CPU、ベンダー、およびオペレーティングシステム名に関してターゲットプラットフォームを説明する文字列です。

When targeting macOS (Darwin), the default minimum version is 13.0. Use MACOSX_DEPLOYMENT_TARGET to specify a different minimum version, e.g., 14.0.macOS (Darwin) をターゲットにする場合、デフォルトの最小バージョンは 13.0 です。異なる最小バージョンを指定するには MACOSX_DEPLOYMENT_TARGET を使用します。例: 14.0。

When targeting iOS, the default minimum version is 13.0. Use IPHONEOS_DEPLOYMENT_TARGET to specify a different minimum version, e.g., 14.0.iOSをターゲットにする場合、デフォルトの最小バージョンは13.0です。異なる最小バージョンを指定するにはIPHONEOS_DEPLOYMENT_TARGETを使用します。例：14.0。

When targeting Android, the default minimum Android API level is 24. Use ANDROID_API_LEVEL to specify a different minimum version, e.g., 26.Androidをターゲットにする場合、デフォルトの最小Android APIレベルは24です。異なる最小バージョンを指定するにはANDROID_API_LEVELを使用します。例：26。

WARNING: When specified, uv will select wheels that are compatible with the target platform; as a result, the installed distributions may not be compatible with the current platform. Conversely, any distributions that are built from source may be incompatible with the target platform, as they will be built for the current platform. The --python-platform option is intended for advanced use cases.WARNING: 指定された場合、uvはtargetプラットフォームと互換性のあるホイールを選択します。その結果、インストールされたディストリビューションはcurrentプラットフォームと互換性がない可能性があります。逆に、ソースからビルドされたディストリビューションはtargetプラットフォームと互換性がない可能性があります。なぜなら、それらはcurrentプラットフォーム用にビルドされるからです。--python-platformオプションは高度な使用ケースを想定しています。

Possible values:可能な値：

windows: An alias for x86_64-pc-windows-msvc, the default target for Windowswindows: x86_64-pc-windows-msvcのエイリアスで、Windowsのデフォルトターゲットです。
linux: An alias for x86_64-unknown-linux-gnu, the default target for Linuxlinux: x86_64-unknown-linux-gnuのエイリアスで、Linuxのデフォルトターゲットです。
macos: An alias for aarch64-apple-darwin, the default target for macOSmacos: aarch64-apple-darwinのエイリアスで、macOSのデフォルトターゲットです。
x86_64-pc-windows-msvc: A 64-bit x86 Windows targetx86_64-pc-windows-msvc: 64ビットx86 Windowsターゲットです。
aarch64-pc-windows-msvc: An ARM64 Windows targetaarch64-pc-windows-msvc: ARM64 Windowsターゲットです。
i686-pc-windows-msvc: A 32-bit x86 Windows targeti686-pc-windows-msvc: 32ビットx86 Windowsターゲットです。
x86_64-unknown-linux-gnu: An x86 Linux target. Equivalent to x86_64-manylinux_2_28x86_64-unknown-linux-gnu: x86 Linux ターゲット。x86_64-manylinux_2_28 と同等です。
aarch64-apple-darwin: An ARM-based macOS target, as seen on Apple Silicon devicesaarch64-apple-darwin: Apple Silicon デバイスで見られる ARM ベースの macOS ターゲット。
x86_64-apple-darwin: An x86 macOS targetx86_64-apple-darwin: x86 macOS ターゲット。
aarch64-unknown-linux-gnu: An ARM64 Linux target. Equivalent to aarch64-manylinux_2_28aarch64-unknown-linux-gnu: ARM64 Linux ターゲット。aarch64-manylinux_2_28 と同等です。
aarch64-unknown-linux-musl: An ARM64 Linux targetaarch64-unknown-linux-musl: ARM64 Linux ターゲット。
x86_64-unknown-linux-musl: An x86_64 Linux targetx86_64-unknown-linux-musl: x86_64 Linux ターゲット。
riscv64-unknown-linux: A RISCV64 Linux targetriscv64-unknown-linux: RISCV64 Linux ターゲット。
x86_64-manylinux2014: An x86_64 target for the manylinux2014 platform. Equivalent to x86_64-manylinux_2_17x86_64-manylinux2014: x86_64 ターゲットで、manylinux2014 プラットフォーム用です。x86_64-manylinux_2_17 と同等です。
x86_64-manylinux_2_17: An x86_64 target for the manylinux_2_17 platformx86_64-manylinux_2_17: x86_64 ターゲットで、manylinux_2_17 プラットフォーム用です。
x86_64-manylinux_2_28: An x86_64 target for the manylinux_2_28 platformx86_64-manylinux_2_28: x86_64 ターゲットで、manylinux_2_28 プラットフォーム用です。
x86_64-manylinux_2_31: An x86_64 target for the manylinux_2_31 platformx86_64-manylinux_2_31: x86_64 ターゲットの manylinux_2_31 プラットフォーム
x86_64-manylinux_2_32: An x86_64 target for the manylinux_2_32 platformx86_64-manylinux_2_32: x86_64 ターゲットの manylinux_2_32 プラットフォーム
x86_64-manylinux_2_33: An x86_64 target for the manylinux_2_33 platformx86_64-manylinux_2_33: x86_64 ターゲットの manylinux_2_33 プラットフォーム
x86_64-manylinux_2_34: An x86_64 target for the manylinux_2_34 platformx86_64-manylinux_2_34: x86_64 ターゲットの manylinux_2_34 プラットフォーム
x86_64-manylinux_2_35: An x86_64 target for the manylinux_2_35 platformx86_64-manylinux_2_35: x86_64 ターゲットの manylinux_2_35 プラットフォーム
x86_64-manylinux_2_36: An x86_64 target for the manylinux_2_36 platformx86_64-manylinux_2_36: x86_64 ターゲットの manylinux_2_36 プラットフォーム
x86_64-manylinux_2_37: An x86_64 target for the manylinux_2_37 platformx86_64-manylinux_2_37: x86_64 ターゲットの manylinux_2_37 プラットフォーム
x86_64-manylinux_2_38: An x86_64 target for the manylinux_2_38 platformx86_64-manylinux_2_38: x86_64 ターゲットの manylinux_2_38 プラットフォーム
x86_64-manylinux_2_39: An x86_64 target for the manylinux_2_39 platformx86_64-manylinux_2_39: x86_64 ターゲットの manylinux_2_39 プラットフォーム
x86_64-manylinux_2_40: An x86_64 target for the manylinux_2_40 platformx86_64-manylinux_2_40: x86_64 ターゲットの manylinux_2_40 プラットフォーム
aarch64-manylinux2014: An ARM64 target for the manylinux2014 platform. Equivalent to aarch64-manylinux_2_17aarch64-manylinux2014: manylinux2014プラットフォーム用のARM64ターゲット。aarch64-manylinux_2_17と同等です。
aarch64-manylinux_2_17: An ARM64 target for the manylinux_2_17 platformaarch64-manylinux_2_17: manylinux_2_17プラットフォーム用のARM64ターゲット。
aarch64-manylinux_2_28: An ARM64 target for the manylinux_2_28 platformaarch64-manylinux_2_28: manylinux_2_28プラットフォーム用のARM64ターゲット。
aarch64-manylinux_2_31: An ARM64 target for the manylinux_2_31 platformaarch64-manylinux_2_31: manylinux_2_31プラットフォーム用のARM64ターゲット。
aarch64-manylinux_2_32: An ARM64 target for the manylinux_2_32 platformaarch64-manylinux_2_32: manylinux_2_32プラットフォーム用のARM64ターゲット。
aarch64-manylinux_2_33: An ARM64 target for the manylinux_2_33 platformaarch64-manylinux_2_33: manylinux_2_33プラットフォーム用のARM64ターゲット。
aarch64-manylinux_2_34: An ARM64 target for the manylinux_2_34 platformaarch64-manylinux_2_34: manylinux_2_34プラットフォーム用のARM64ターゲット。
aarch64-manylinux_2_35: An ARM64 target for the manylinux_2_35 platformaarch64-manylinux_2_35: manylinux_2_35プラットフォーム用のARM64ターゲット。
aarch64-manylinux_2_36: An ARM64 target for the manylinux_2_36 platformaarch64-manylinux_2_36: manylinux_2_36プラットフォーム用のARM64ターゲット。
aarch64-manylinux_2_37: An ARM64 target for the manylinux_2_37 platformaarch64-manylinux_2_37: manylinux_2_37プラットフォーム用のARM64ターゲット。
aarch64-manylinux_2_38: An ARM64 target for the manylinux_2_38 platformaarch64-manylinux_2_38: manylinux_2_38プラットフォーム用のARM64ターゲット
aarch64-manylinux_2_39: An ARM64 target for the manylinux_2_39 platformaarch64-manylinux_2_39: manylinux_2_39プラットフォーム用のARM64ターゲット
aarch64-manylinux_2_40: An ARM64 target for the manylinux_2_40 platformaarch64-manylinux_2_40: manylinux_2_40プラットフォーム用のARM64ターゲット
aarch64-linux-android: An ARM64 Android targetaarch64-linux-android: ARM64 Androidターゲット
x86_64-linux-android: An x86_64 Android targetx86_64-linux-android: x86_64 Androidターゲット
wasm32-pyodide2024: A wasm32 target using the Pyodide 2024 platform. Meant for use with Python 3.12wasm32-pyodide2024: Pyodide 2024プラットフォームを使用したwasm32ターゲット。Python 3.12との使用を意図しています
arm64-apple-ios: An ARM64 target for iOS devicearm64-apple-ios: iOSデバイス用のARM64ターゲット
arm64-apple-ios-simulator: An ARM64 target for iOS simulatorarm64-apple-ios-simulator: iOSシミュレーター用のARM64ターゲット
x86_64-apple-ios-simulator: An x86_64 target for iOS simulatorx86_64-apple-ios-simulator: iOSシミュレーター用のターゲット

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uvがstdoutに出力しないサイレントモードが有効になります。

--refresh--refresh

Refresh all cached dataすべてのキャッシュデータを更新します。

--refresh-package refresh-package--refresh-package refresh-package

Refresh cached data for a specific package特定のパッケージのキャッシュデータを更新します。

--reinstall, --force-reinstall--reinstall, --force-reinstall

Reinstall all packages, regardless of whether they're already installed. Implies --refreshすべてのパッケージを再インストールします。すでにインストールされているかどうかに関係ありません。--refreshを暗示します。

--reinstall-package reinstall-package--reinstall-package reinstall-package

Reinstall a specific package, regardless of whether it's already installed. Implies --refresh-package特定のパッケージを再インストールします。すでにインストールされているかどうかに関係ありません。--refresh-packageを暗示します。

--resolution resolution--resolution 解像度

The strategy to use when selecting between the different compatible versions for a given package requirement.特定のパッケージ要件に対して異なる互換バージョンを選択する際に使用する戦略。

By default, uv will use the latest compatible version of each package (highest).デフォルトでは、uvは各パッケージの最新の互換バージョンを使用します (highest)。

May also be set with the UV_RESOLUTION environment variable.UV_RESOLUTION 環境変数を使用して設定することもできます。

Possible values:可能な値:

highest: Resolve the highest compatible version of each packagehighest: 各パッケージの最高の互換バージョンを解決します
lowest: Resolve the lowest compatible version of each packagelowest: 各パッケージの最低の互換バージョンを解決します
lowest-direct: Resolve the lowest compatible version of any direct dependencies, and the highest compatible version of any transitive dependencieslowest-direct: 直接依存関係の最低の互換バージョンを解決し、間接依存関係の最高の互換バージョンを解決します

--upgrade, -U--upgrade, -U

Allow package upgrades, ignoring pinned versions in any existing output file. Implies --refreshパッケージのアップグレードを許可し、既存の出力ファイルに固定されたバージョンを無視します。--refreshを含意します

--upgrade-package, -P upgrade-package--upgrade-package, -P upgrade-package

Allow upgrades for a specific package, ignoring pinned versions in any existing output file. Implies --refresh-package特定のパッケージのアップグレードを許可し、既存の出力ファイルに固定されたバージョンを無視します。--refresh-packageを暗示します。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)RUST_LOG環境変数を使用して、詳細なロギングを構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

--with, -w with--with, -w with

Run with the given packages installed指定されたパッケージがインストールされた状態で実行します。

--with-editable with-editable--with-editable with-editable

Run with the given packages installed in editable mode指定されたパッケージが編集可能モードでインストールされた状態で実行します。

When used in a project, these dependencies will be layered on top of the uv tool's environment in a separate, ephemeral environment. These dependencies are allowed to conflict with those specified.プロジェクトで使用されると、これらの依存関係はuvツールの環境の上に別の一時的な環境としてレイヤーされます。これらの依存関係は、指定されたものと競合することが許可されています。

--with-requirements with-requirements--with-requirements with-requirements

Run with the packages listed in the given files.指定されたファイルにリストされたパッケージで実行します。

The following formats are supported: requirements.txt, .py files with inline metadata, and pylock.toml.サポートされているフォーマットは次の通りです: requirements.txt, .py ファイルのインラインメタデータ、および pylock.toml。

uv tool installuv tool install

Install commands provided by a Python package.Pythonパッケージによって提供されるコマンドをインストールします。

Packages are installed into an isolated virtual environment in the uv tools directory. The executables are linked the tool executable directory, which is determined according to the XDG standard and can be retrieved with uv tool dir --bin.パッケージは、uvツールディレクトリ内の隔離された仮想環境にインストールされます。実行可能ファイルはツール実行可能ディレクトリにリンクされ、これはXDG標準に従って決定され、uv tool dir --binで取得できます。

If the tool was previously installed, the existing tool will generally be replaced.ツールが以前にインストールされていた場合、既存のツールは一般的に置き換えられます。

Usage使用法

uv tool install [OPTIONS] <PACKAGE>

Arguments引数

PACKAGEPACKAGE: The package to install commands fromインストールコマンドのパッケージ

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例: localhost）、ホスト-ポートペア（例: localhost:8080）、またはURL（例: https://localhost）を受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告: このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--build-constraints, --build-constraint, -b build-constraints--build-constraints, --build-constraint, -b build-constraints

Constrain build dependencies using the given requirements files when building source distributions.ソース配布物をビルドする際に、指定された要件ファイルを使用してビルド依存関係を制約します。

Constraints files are requirements.txt-like files that only control the version of a requirement that's installed. However, including a package in a constraints file will not trigger the installation of that package.制約ファイルは requirements.txt に似たファイルで、インストールされる要件の バージョン のみを制御します。ただし、制約ファイルにパッケージを含めても、そのパッケージのインストールは トリガーされません。

May also be set with the UV_BUILD_CONSTRAINT environment variable.UV_BUILD_CONSTRAINT 環境変数で設定することもできます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは $XDG_CACHE_HOME/uv または $HOME/.cache/uv にデフォルト設定され、Windowsでは %LOCALAPPDATA%\uv\cache にデフォルト設定されます。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dir を実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR 環境変数で設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvはターミナルへの書き込み時に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力が端末またはTTYに送信される場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--compile-bytecode, --compile--compile-bytecode, --compile

Compile Python files to bytecode after installation.インストール後にPythonファイルをバイトコードにコンパイルします。

By default, uv does not compile Python (.py) files to bytecode (__pycache__/*.pyc); instead, compilation is performed lazily the first time a module is imported. For use-cases in which start time is critical, such as CLI applications and Docker containers, this option can be enabled to trade longer installation times for faster start times.デフォルトでは、uvはPython（.py）ファイルをバイトコード（__pycache__/*.pyc）にコンパイルしません。代わりに、モジュールが最初にインポートされるときに遅延的にコンパイルが行われます。CLIアプリケーションやDockerコンテナなど、起動時間が重要なユースケースでは、このオプションを有効にすることで、長いインストール時間と引き換えに迅速な起動時間を得ることができます。

When enabled, uv will process the entire site-packages directory (including packages that are not being modified by the current operation) for consistency. Like pip, it will also ignore errors.有効にすると、uvは一貫性のためにサイトパッケージディレクトリ全体（現在の操作によって変更されていないパッケージを含む）を処理します。pipのように、エラーも無視します。

May also be set with the UV_COMPILE_BYTECODE environment variable.UV_COMPILE_BYTECODE環境変数でも設定できます。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.uv.tomlファイルのパスを設定に使用します。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数を使用して設定することもできます。

--config-setting, --config-settings, -C config-setting--config-setting, --config-settings, -C config-setting

Settings to pass to the PEP 517 build backend, specified as KEY=VALUE pairsPEP 517ビルドバックエンドに渡す設定で、KEY=VALUEペアとして指定します。

--config-settings-package, --config-settings-package config-settings-package--config-settings-package, --config-settings-package config-settings-package

Settings to pass to the PEP 517 build backend for a specific package, specified as PACKAGE:KEY=VALUE pairs特定のパッケージのためにPEP 517ビルドバックエンドに渡す設定で、PACKAGE:KEY=VALUEペアとして指定します。

--constraints, --constraint, -c constraints--constraints, --constraint, -c constraints

Constrain versions using the given requirements files.指定された要件ファイルを使用してバージョンを制約します。

Constraints files are requirements.txt-like files that only control the version of a requirement that's installed. However, including a package in a constraints file will not trigger the installation of that package.制約ファイルはrequirements.txtのようなファイルで、インストールされる要件のバージョンのみを制御します。ただし、制約ファイルにパッケージを含めても、そのパッケージのインストールはトリガーされません。

This is equivalent to pip's --constraint option.これはpipの--constraintオプションと同等です。

May also be set with the UV_CONSTRAINT environment variable.UV_CONSTRAINT環境変数で設定することもできます。

--default-index default-index--default-index default-index

The URL of the default package index (by default: https://pypi.org/simple).デフォルトのパッケージインデックスのURL（デフォルトでは: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式で配置されたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --index flag.このフラグで指定されたインデックスは、--indexフラグで指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_DEFAULT_INDEX environment variable.UV_DEFAULT_INDEX環境変数で設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数でも設定できます。

--editable, -e--editable, -e

Install the target package in editable mode, such that changes in the package's source directory are reflected without reinstallationターゲットパッケージを編集可能モードでインストールし、パッケージのソースディレクトリの変更が再インストールなしで反映されるようにします。

--exclude-newer exclude-newer--exclude-newer exclude-newer

Limit candidate packages to those that were uploaded prior to the given date.候補パッケージを、指定された日付より前にアップロードされたものに制限します。

Accepts both RFC 3339 timestamps (e.g., 2006-12-02T02:07:43Z) and local dates in the same format (e.g., 2006-12-02) in your system's configured time zone.RFC 3339タイムスタンプ（例：2006-12-02T02:07:43Z）と、システムの設定されたタイムゾーンでの同じ形式のローカル日付（例：2006-12-02）の両方を受け入れます。

May also be set with the UV_EXCLUDE_NEWER environment variable.UV_EXCLUDE_NEWER環境変数でも設定できます。

--exclude-newer-package exclude-newer-package--exclude-newer-package exclude-newer-package

Limit candidate packages for specific packages to those that were uploaded prior to the given date.特定のパッケージの候補パッケージを、指定された日付より前にアップロードされたものに制限します。

Accepts package-date pairs in the format PACKAGE=DATE, where DATE is an RFC 3339 timestamp (e.g., 2006-12-02T02:07:43Z) or local date (e.g., 2006-12-02) in your system's configured time zone.パッケージ-日付ペアをPACKAGE=DATEの形式で受け入れます。ここで、DATEはRFC 3339タイムスタンプ（例：2006-12-02T02:07:43Z）またはローカル日付（例：2006-12-02）で、システムの設定されたタイムゾーンに基づきます。

Can be provided multiple times for different packages.異なるパッケージのために複数回提供できます。

--excludes, --exclude excludes--excludes, --exclude excludes

Exclude packages from resolution using the given requirements files.指定された要件ファイルを使用して、解決からパッケージを除外します。

Excludes files are requirements.txt-like files that specify packages to exclude from the resolution. When a package is excluded, it will be omitted from the dependency list entirely and its own dependencies will be ignored during the resolution phase. Excludes are unconditional in that requirement specifiers and markers are ignored; any package listed in the provided file will be omitted from all resolved environments.除外ファイルは、解決から除外するパッケージを指定するrequirements.txtのようなファイルです。パッケージが除外されると、その依存関係リストから完全に省かれ、解決フェーズ中にその依存関係は無視されます。除外は無条件であり、要件指定子やマーカーは無視されます。提供されたファイルにリストされたパッケージは、すべての解決された環境から省かれます。

May also be set with the UV_EXCLUDE environment variable.UV_EXCLUDE環境変数でも設定できます。

--extra-index-url extra-index-url--extra-index-url extra-index-url

(Deprecated: use --index instead) Extra URLs of package indexes to use, in addition to --index-url.(非推奨：代わりに--indexを使用してください) --index-urlに加えて使用するパッケージインデックスの追加URL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --index-url (which defaults to PyPI). When multiple --extra-index-url flags are provided, earlier values take priority.このフラグを介して提供されたすべてのインデックスは、--index-url（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の--extra-index-urlフラグが提供される場合、先に指定された値が優先されます。

May also be set with the UV_EXTRA_INDEX_URL environment variable.また、UV_EXTRA_INDEX_URL 環境変数で設定することもできます。

--find-links, -f find-links--find-links, -f find-links

Locations to search for candidate distributions, in addition to those found in the registry indexes.レジストリインデックスで見つかったものに加えて、候補となる配布物を検索する場所。

If a path, the target must be a directory that contains packages as wheel files (.whl) or source distributions (e.g., .tar.gz or .zip) at the top level.パスの場合、ターゲットは最上位にホイールファイル (.whl) またはソース配布物 (例: .tar.gz または .zip) を含むディレクトリでなければなりません。

If a URL, the page must contain a flat list of links to package files adhering to the formats described above.URLの場合、そのページは上記の形式に従ったパッケージファイルへのリンクのフラットリストを含む必要があります。

May also be set with the UV_FIND_LINKS environment variable.また、UV_FIND_LINKS 環境変数で設定することもできます。

--force--force

Force installation of the tool.ツールの強制インストール。

Will replace any existing entry points with the same name in the executable directory.実行可能ディレクトリ内の同名の既存のエントリポイントを置き換えます。

--fork-strategy fork-strategy--fork-strategy fork-strategy

The strategy to use when selecting multiple versions of a given package across Python versions and platforms.特定のパッケージの複数のバージョンをPythonのバージョンやプラットフォームにわたって選択する際に使用する戦略。

By default, uv will optimize for selecting the latest version of each package for each supported Python version (requires-python), while minimizing the number of selected versions across platforms.デフォルトでは、uvは各サポートされているPythonバージョン（requires-python）ごとに各パッケージの最新バージョンを選択することを最適化し、プラットフォーム間で選択されたバージョンの数を最小限に抑えます。

Under fewest, uv will minimize the number of selected versions for each package, preferring older versions that are compatible with a wider range of supported Python versions or platforms.fewestの下では、uvは各パッケージの選択されたバージョンの数を最小限に抑え、より広範囲のサポートされているPythonバージョンやプラットフォームと互換性のある古いバージョンを優先します。

May also be set with the UV_FORK_STRATEGY environment variable.UV_FORK_STRATEGY環境変数で設定することもできます。

Possible values:可能な値：

fewest: Optimize for selecting the fewest number of versions for each package. Older versions may be preferred if they are compatible with a wider range of supported Python versions or platformsfewest: 各パッケージの選択されたバージョンの数を最小限に抑えることを最適化します。より広範囲のサポートされているPythonバージョンやプラットフォームと互換性がある場合、古いバージョンが優先されることがあります。
requires-python: Optimize for selecting latest supported version of each package, for each supported Python versionrequires-python: 各サポートされているPythonバージョンごとに各パッケージの最新のサポートバージョンを選択することを最適化します。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--index index--index index

The URLs to use when resolving dependencies, in addition to the default index.依存関係を解決する際に使用するURLで、デフォルトのインデックスに加えて指定します。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式で配置されたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --default-index (which defaults to PyPI). When multiple --index flags are provided, earlier values take priority.このフラグを介して提供されたすべてのインデックスは、--default-index（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の--indexフラグが提供される場合、先に指定された値が優先されます。

Index names are not supported as values. Relative paths must be disambiguated from index names with ./ or ../ on Unix or .\\, ..\\, ./ or ../ on Windows.インデックス名は値としてサポートされていません。相対パスは、Unixでは./または../、Windowsでは.\\、..\\、./または../を使用してインデックス名と区別する必要があります。

May also be set with the UV_INDEX environment variable.UV_INDEX環境変数を使用して設定することもできます。

--index-strategy index-strategy--index-strategy index-strategy

The strategy to use when resolving against multiple index URLs.複数のインデックスURLに対して解決する際に使用する戦略です。

By default, uv will stop at the first index on which a given package is available, and limit resolutions to those present on that first index (first-index). This prevents "dependency confusion" attacks, whereby an attacker can upload a malicious package under the same name to an alternate index.デフォルトでは、uvは指定されたパッケージが利用可能な最初のインデックスで停止し、その最初のインデックスに存在するものに解決を制限します（first-index）。これにより、攻撃者が同じ名前の悪意のあるパッケージを別のインデックスにアップロードすることによる「依存関係の混乱」攻撃を防ぎます。

May also be set with the UV_INDEX_STRATEGY environment variable.UV_INDEX_STRATEGY環境変数を使用して設定することもできます。

Possible values:可能な値：

first-index: Only use results from the first index that returns a match for a given package namefirst-index: 指定されたパッケージ名に対して一致する最初のインデックスからの結果のみを使用します。
unsafe-first-match: Search for every package name across all indexes, exhausting the versions from the first index before moving on to the nextunsafe-first-match: すべてのインデックスで各パッケージ名を検索し、次のインデックスに移る前に最初のインデックスからのバージョンを使い切ります。
unsafe-best-match: Search for every package name across all indexes, preferring the "best" version found. If a package version is in multiple indexes, only look at the entry for the first indexunsafe-best-match: すべてのインデックスで各パッケージ名を検索し、見つかった「最良」のバージョンを優先します。パッケージバージョンが複数のインデックスに存在する場合、最初のインデックスのエントリのみを参照します。

--index-url, -i index-url--index-url, -i index-url

(Deprecated: use --default-index instead) The URL of the Python package index (by default: https://pypi.org/simple).(非推奨: 代わりに --default-index を使用してください) PythonパッケージインデックスのURL（デフォルト: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --extra-index-url flag.このフラグで指定されたインデックスは、--extra-index-urlフラグを介して指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_INDEX_URL environment variable.UV_INDEX_URL 環境変数で設定することもできます。

--keyring-provider keyring-provider--keyring-provider keyring-provider

Attempt to use keyring for authentication for index URLs.keyring を使用してインデックスURLの認証を試みます。

At present, only --keyring-provider subprocess is supported, which configures uv to use the keyring CLI to handle authentication.現在、サポートされているのは --keyring-provider subprocess のみで、これは uv が認証を処理するために keyring CLI を使用するように設定します。

Defaults to disabled.デフォルトは disabled です。

May also be set with the UV_KEYRING_PROVIDER environment variable.UV_KEYRING_PROVIDER 環境変数を使用して設定することもできます。

Possible values:可能な値:

disabled: Do not use keyring for credential lookupdisabled: 認証情報の検索に keyring を使用しない
subprocess: Use the keyring command for credential lookupsubprocess: 認証情報の検索に keyring コマンドを使用する

--link-mode link-mode--link-mode link-mode

The method to use when installing packages from the global cache.グローバルキャッシュからパッケージをインストールする際に使用する方法。

Defaults to clone (also known as Copy-on-Write) on macOS, and hardlink on Linux and Windows.macOS ではデフォルトで clone (Copy-on-Write とも呼ばれる)、Linux および Windows では hardlink です。

WARNING: The use of symlink link mode is discouraged, as they create tight coupling between the cache and the target environment. For example, clearing the cache (uv cache clean) will break all installed packages by way of removing the underlying source files. Use symlinks with caution.警告: シンボリックリンクモードの使用は推奨されません。これはキャッシュとターゲット環境の間に強い結合を生じさせるためです。たとえば、キャッシュをクリアする (uv cache clean) と、基になるソースファイルが削除されるため、すべてのインストールされたパッケージが壊れます。シンボリックリンクは注意して使用してください。

May also be set with the UV_LINK_MODE environment variable.また、UV_LINK_MODE 環境変数で設定することもできます。

Possible values:可能な値：

clone: Clone (i.e., copy-on-write) packages from the wheel into the site-packages directoryclone: ウィールから site-packages ディレクトリにパッケージをクローン（すなわち、コピーオンライト）します。
copy: Copy packages from the wheel into the site-packages directorycopy: ウィールから site-packages ディレクトリにパッケージをコピーします。
hardlink: Hard link packages from the wheel into the site-packages directoryhardlink: ウィールから site-packages ディレクトリにパッケージをハードリンクします。
symlink: Symbolically link packages from the wheel into the site-packages directorysymlink: ウィールから site-packages ディレクトリにパッケージをシンボリックリンクします。

--managed-python--managed-python

Require use of uv-managed Python versions.uv-managed Python バージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンの使用を優先します。ただし、uv管理のPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.また、UV_MANAGED_PYTHON 環境変数で設定することもできます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、特にシステムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したいことがあります。

May also be set with the UV_NATIVE_TLS environment variable.UV_NATIVE_TLS環境変数を使用して設定することもできます。

--no-binary--no-binary

Don't install pre-built wheels.事前にビルドされたホイールをインストールしない。

The given packages will be built and installed from source. The resolver will still use pre-built wheels to extract package metadata, if available.指定されたパッケージはソースからビルドされ、インストールされます。リゾルバは、利用可能な場合、パッケージメタデータを抽出するために事前にビルドされたホイールを使用します。

May also be set with the UV_NO_BINARY environment variable.UV_NO_BINARY環境変数を使用して設定することもできます。

--no-binary-package no-binary-package--no-binary-package no-binary-package

Don't install pre-built wheels for a specific package特定のパッケージのためにプリビルドされたホイールをインストールしないでください

May also be set with the UV_NO_BINARY_PACKAGE environment variable.環境変数 UV_NO_BINARY_PACKAGE でも設定できます。

--no-build--no-build

Don't build source distributions.ソース配布物をビルドしないでください。

When enabled, resolving will not run arbitrary Python code. The cached wheels of already-built source distributions will be reused, but operations that require building distributions will exit with an error.有効にすると、解決時に任意のPythonコードは実行されません。すでにビルドされたソース配布物のキャッシュされたホイールが再利用されますが、配布物のビルドを必要とする操作はエラーで終了します。

May also be set with the UV_NO_BUILD environment variable.環境変数 UV_NO_BUILD でも設定できます。

--no-build-isolation--no-build-isolation

Disable isolation when building source distributions.ソース配布物をビルドする際にアイソレーションを無効にします。

Assumes that build dependencies specified by PEP 518 are already installed.PEP 518 で指定されたビルド依存関係がすでにインストールされていると仮定します。

May also be set with the UV_NO_BUILD_ISOLATION environment variable.環境変数 UV_NO_BUILD_ISOLATION でも設定できます。

--no-build-isolation-package no-build-isolation-package--no-build-isolation-package no-build-isolation-package

Disable isolation when building source distributions for a specific package.特定のパッケージのソース配布物をビルドする際に、アイソレーションを無効にします。

Assumes that the packages' build dependencies specified by PEP 518 are already installed.PEP 518で指定されたパッケージのビルド依存関係がすでにインストールされていることを前提としています。

--no-build-package no-build-package--no-build-package no-build-package

Don't build source distributions for a specific package特定のパッケージのソース配布物をビルドしません。

May also be set with the UV_NO_BUILD_PACKAGE environment variable.環境変数UV_NO_BUILD_PACKAGEでも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.環境変数UV_NO_CACHEでも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml、uv.toml）の発見を避ける。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.UV_NO_CONFIG 環境変数で設定することもできます。

--no-index--no-index

Ignore the registry index (e.g., PyPI), instead relying on direct URL dependencies and those provided via --find-linksレジストリインデックス（例：PyPI）を無視し、直接URL依存関係および--find-linksを介して提供されるものに依存します。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON 環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS 環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--no-sources--no-sources

Ignore the tool.uv.sources table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any workspace, Git, URL, or local path sources依存関係を解決する際に tool.uv.sources テーブルを無視します。ワークスペース、Git、URL、またはローカルパスソースを使用するのではなく、標準準拠の公開可能なパッケージメタデータに対してロックするために使用されます。

May also be set with the UV_NO_SOURCES environment variable.UV_NO_SOURCES 環境変数で設定することもできます。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.環境変数 UV_OFFLINE でも設定できます。

--overrides, --override overrides--overrides, --override overrides

Override versions using the given requirements files.指定された要件ファイルを使用してバージョンを上書きします。

Overrides files are requirements.txt-like files that force a specific version of a requirement to be installed, regardless of the requirements declared by any constituent package, and regardless of whether this would be considered an invalid resolution.Overridesファイルは requirements.txt に似たファイルで、構成パッケージによって宣言された要件に関係なく、特定のバージョンの要件を強制的にインストールします。これが無効な解決と見なされるかどうかに関係なく。

While constraints are additive, in that they're combined with the requirements of the constituent packages, overrides are absolute, in that they completely replace the requirements of the constituent packages.制約は構成パッケージの要件と組み合わされる加算的ですが、オーバーライドは構成パッケージの要件を完全に置き換える絶対的です。

May also be set with the UV_OVERRIDE environment variable.環境変数 UV_OVERRIDE でも設定できます。

--prerelease prerelease--prerelease prerelease

The strategy to use when considering pre-release versions.プレリリースバージョンを考慮する際に使用する戦略。

By default, uv will accept pre-releases for packages that only publish pre-releases, along with first-party requirements that contain an explicit pre-release marker in the declared specifiers (if-necessary-or-explicit).デフォルトでは、uvはのみプレリリースを公開するパッケージと、宣言された指定子に明示的なプレリリースマーカーを含むファーストパーティの要件に対してプレリリースを受け入れます (if-necessary-or-explicit)。

May also be set with the UV_PRERELEASE environment variable.また、UV_PRERELEASE 環境変数で設定することもできます。

Possible values:可能な値：

disallow: Disallow all pre-release versionsdisallow: すべてのプレリリースバージョンを禁止する
allow: Allow all pre-release versionsallow: すべてのプレリリースバージョンを許可する
if-necessary: Allow pre-release versions if all versions of a package are pre-releaseif-necessary: すべてのバージョンがプレリリースである場合にプレリリースバージョンを許可する
explicit: Allow pre-release versions for first-party packages with explicit pre-release markers in their version requirementsexplicit: バージョン要件に明示的なプレリリースマーカーがあるファーストパーティパッケージに対してプレリリースバージョンを許可する
if-necessary-or-explicit: Allow pre-release versions if all versions of a package are pre-release, or if the package has an explicit pre-release marker in its version requirementsif-necessary-or-explicit: すべてのバージョンがプレリリースである場合、またはパッケージにバージョン要件に明示的なプレリリースマーカーがある場合にプレリリースバージョンを許可する

--project project--project project

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見され、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.--directoryを参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pipインターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT環境変数を使用して設定することもできます。

--python, -p python--python, -p python

The Python interpreter to use to build the tool environment.ツール環境を構築するために使用するPythonインタプリタ。

See uv python for details on Python discovery and supported request formats.Pythonの発見とサポートされているリクエスト形式の詳細については、uv pythonを参照してください。

May also be set with the UV_PYTHON environment variable.UV_PYTHON環境変数を使用して設定することもできます。

--python-platform python-platform--python-platform python-platform

The platform for which requirements should be installed.要件をインストールするプラットフォーム。

Represented as a "target triple", a string that describes the target platform in terms of its CPU, vendor, and operating system name, like x86_64-unknown-linux-gnu or aarch64-apple-darwin.「ターゲットトリプル」として表現される、CPU、ベンダー、およびオペレーティングシステム名に関してターゲットプラットフォームを説明する文字列で、例えば x86_64-unknown-linux-gnu や aarch64-apple-darwin のようになります。

When targeting macOS (Darwin), the default minimum version is 13.0. Use MACOSX_DEPLOYMENT_TARGET to specify a different minimum version, e.g., 14.0.macOS (Darwin) をターゲットにする場合、デフォルトの最小バージョンは 13.0 です。異なる最小バージョンを指定するには MACOSX_DEPLOYMENT_TARGET を使用します。例えば、14.0 のように。

When targeting iOS, the default minimum version is 13.0. Use IPHONEOS_DEPLOYMENT_TARGET to specify a different minimum version, e.g., 14.0.iOS をターゲットにする場合、デフォルトの最小バージョンは 13.0 です。異なる最小バージョンを指定するには IPHONEOS_DEPLOYMENT_TARGET を使用します。例えば、14.0 のように。

When targeting Android, the default minimum Android API level is 24. Use ANDROID_API_LEVEL to specify a different minimum version, e.g., 26.Android をターゲットにする場合、デフォルトの最小 Android API レベルは 24 です。異なる最小バージョンを指定するには ANDROID_API_LEVEL を使用します。例えば、26 のように。

WARNING: When specified, uv will select wheels that are compatible with the target platform; as a result, the installed distributions may not be compatible with the current platform. Conversely, any distributions that are built from source may be incompatible with the target platform, as they will be built for the current platform. The --python-platform option is intended for advanced use cases.WARNING: 指定された場合、uv は ターゲット プラットフォームと互換性のあるホイールを選択します。その結果、インストールされたディストリビューションは 現在の プラットフォームと互換性がない可能性があります。逆に、ソースからビルドされたディストリビューションは ターゲット プラットフォームと互換性がない可能性があります。なぜなら、それらは 現在の プラットフォーム用にビルドされるからです。--python-platform オプションは高度な使用ケースを想定しています。

Possible values:可能な値:

windows: An alias for x86_64-pc-windows-msvc, the default target for Windowswindows: x86_64-pc-windows-msvc のエイリアスで、Windows のデフォルトターゲットです。
linux: An alias for x86_64-unknown-linux-gnu, the default target for Linuxlinux: x86_64-unknown-linux-gnu のエイリアスで、Linux のデフォルトターゲットです。
macos: An alias for aarch64-apple-darwin, the default target for macOSmacos: aarch64-apple-darwin のエイリアスで、macOS のデフォルトターゲットです。
x86_64-pc-windows-msvc: A 64-bit x86 Windows targetx86_64-pc-windows-msvc: 64ビット x86 Windows ターゲット
aarch64-pc-windows-msvc: An ARM64 Windows targetaarch64-pc-windows-msvc: ARM64 Windows ターゲット
i686-pc-windows-msvc: A 32-bit x86 Windows targeti686-pc-windows-msvc: 32ビット x86 Windows ターゲット
x86_64-unknown-linux-gnu: An x86 Linux target. Equivalent to x86_64-manylinux_2_28x86_64-unknown-linux-gnu: x86 Linux ターゲット。x86_64-manylinux_2_28 と同等
aarch64-apple-darwin: An ARM-based macOS target, as seen on Apple Silicon devicesaarch64-apple-darwin: Apple Silicon デバイスで見られる ARM ベースの macOS ターゲット
x86_64-apple-darwin: An x86 macOS targetx86_64-apple-darwin: x86 macOS ターゲット
aarch64-unknown-linux-gnu: An ARM64 Linux target. Equivalent to aarch64-manylinux_2_28aarch64-unknown-linux-gnu: ARM64 Linux ターゲット。aarch64-manylinux_2_28 と同等
aarch64-unknown-linux-musl: An ARM64 Linux targetaarch64-unknown-linux-musl: ARM64 Linux ターゲット
x86_64-unknown-linux-musl: An x86_64 Linux targetx86_64-unknown-linux-musl: x86_64 Linux ターゲット
riscv64-unknown-linux: A RISCV64 Linux targetriscv64-unknown-linux: RISCV64 Linux ターゲット
x86_64-manylinux2014: An x86_64 target for the manylinux2014 platform. Equivalent to x86_64-manylinux_2_17x86_64-manylinux2014: manylinux2014 プラットフォーム用の x86_64 ターゲット。x86_64-manylinux_2_17 と同等
x86_64-manylinux_2_17: An x86_64 target for the manylinux_2_17 platformx86_64-manylinux_2_17: x86_64 ターゲットの manylinux_2_17 プラットフォーム
x86_64-manylinux_2_28: An x86_64 target for the manylinux_2_28 platformx86_64-manylinux_2_28: x86_64 ターゲットの manylinux_2_28 プラットフォーム
x86_64-manylinux_2_31: An x86_64 target for the manylinux_2_31 platformx86_64-manylinux_2_31: x86_64 ターゲットの manylinux_2_31 プラットフォーム
x86_64-manylinux_2_32: An x86_64 target for the manylinux_2_32 platformx86_64-manylinux_2_32: x86_64 ターゲットの manylinux_2_32 プラットフォーム
x86_64-manylinux_2_33: An x86_64 target for the manylinux_2_33 platformx86_64-manylinux_2_33: x86_64 ターゲットの manylinux_2_33 プラットフォーム
x86_64-manylinux_2_34: An x86_64 target for the manylinux_2_34 platformx86_64-manylinux_2_34: x86_64 ターゲットの manylinux_2_34 プラットフォーム
x86_64-manylinux_2_35: An x86_64 target for the manylinux_2_35 platformx86_64-manylinux_2_35: x86_64 ターゲットの manylinux_2_35 プラットフォーム
x86_64-manylinux_2_36: An x86_64 target for the manylinux_2_36 platformx86_64-manylinux_2_36: x86_64 ターゲットの manylinux_2_36 プラットフォーム
x86_64-manylinux_2_37: An x86_64 target for the manylinux_2_37 platformx86_64-manylinux_2_37: x86_64 ターゲットの manylinux_2_37 プラットフォーム
x86_64-manylinux_2_38: An x86_64 target for the manylinux_2_38 platformx86_64-manylinux_2_38: x86_64 ターゲットの manylinux_2_38 プラットフォーム
x86_64-manylinux_2_39: An x86_64 target for the manylinux_2_39 platformx86_64-manylinux_2_39: x86_64 ターゲットの manylinux_2_39 プラットフォーム
x86_64-manylinux_2_40: An x86_64 target for the manylinux_2_40 platformx86_64-manylinux_2_40: x86_64 ターゲットの manylinux_2_40 プラットフォーム
aarch64-manylinux2014: An ARM64 target for the manylinux2014 platform. Equivalent to aarch64-manylinux_2_17aarch64-manylinux2014: manylinux2014 プラットフォームの ARM64 ターゲット。 aarch64-manylinux_2_17 と同等
aarch64-manylinux_2_17: An ARM64 target for the manylinux_2_17 platformaarch64-manylinux_2_17: manylinux_2_17 プラットフォームの ARM64 ターゲット
aarch64-manylinux_2_28: An ARM64 target for the manylinux_2_28 platformaarch64-manylinux_2_28: manylinux_2_28 プラットフォームの ARM64 ターゲット
aarch64-manylinux_2_31: An ARM64 target for the manylinux_2_31 platformaarch64-manylinux_2_31: manylinux_2_31 プラットフォームの ARM64 ターゲット
aarch64-manylinux_2_32: An ARM64 target for the manylinux_2_32 platformaarch64-manylinux_2_32: manylinux_2_32 プラットフォームの ARM64 ターゲット
aarch64-manylinux_2_33: An ARM64 target for the manylinux_2_33 platformaarch64-manylinux_2_33: manylinux_2_33 プラットフォームの ARM64 ターゲット
aarch64-manylinux_2_34: An ARM64 target for the manylinux_2_34 platformaarch64-manylinux_2_34: manylinux_2_34 プラットフォームの ARM64 ターゲット
aarch64-manylinux_2_35: An ARM64 target for the manylinux_2_35 platformaarch64-manylinux_2_35: manylinux_2_35 プラットフォームの ARM64 ターゲット
aarch64-manylinux_2_36: An ARM64 target for the manylinux_2_36 platformaarch64-manylinux_2_36: manylinux_2_36プラットフォーム用のARM64ターゲット
aarch64-manylinux_2_37: An ARM64 target for the manylinux_2_37 platformaarch64-manylinux_2_37: manylinux_2_37プラットフォーム用のARM64ターゲット
aarch64-manylinux_2_38: An ARM64 target for the manylinux_2_38 platformaarch64-manylinux_2_38: manylinux_2_38プラットフォーム用のARM64ターゲット
aarch64-manylinux_2_39: An ARM64 target for the manylinux_2_39 platformaarch64-manylinux_2_39: manylinux_2_39プラットフォーム用のARM64ターゲット
aarch64-manylinux_2_40: An ARM64 target for the manylinux_2_40 platformaarch64-manylinux_2_40: manylinux_2_40プラットフォーム用のARM64ターゲット
aarch64-linux-android: An ARM64 Android targetaarch64-linux-android: ARM64 Androidターゲット
x86_64-linux-android: An x86_64 Android targetx86_64-linux-android: x86_64 Androidターゲット
wasm32-pyodide2024: A wasm32 target using the Pyodide 2024 platform. Meant for use with Python 3.12wasm32-pyodide2024: Pyodide 2024プラットフォームを使用したwasm32ターゲット。Python 3.12用に設計されています
arm64-apple-ios: An ARM64 target for iOS devicearm64-apple-ios: iOSデバイス用のARM64ターゲット
arm64-apple-ios-simulator: An ARM64 target for iOS simulatorarm64-apple-ios-simulator: iOSシミュレーター用のARM64ターゲット
x86_64-apple-ios-simulator: An x86_64 target for iOS simulatorx86_64-apple-ios-simulator: iOSシミュレーター用のx86_64ターゲット

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すと、例えば-qq、uvはstdoutに出力を行わないサイレントモードが有効になります。

--refresh--refresh

Refresh all cached dataすべてのキャッシュデータを更新します。

--refresh-package refresh-package--refresh-package refresh-package

Refresh cached data for a specific package特定のパッケージのキャッシュデータを更新します。

--reinstall, --force-reinstall--reinstall, --force-reinstall

Reinstall all packages, regardless of whether they're already installed. Implies --refreshすべてのパッケージを再インストールします。すでにインストールされているかどうかに関係なく、--refreshを含意します。

--reinstall-package reinstall-package--reinstall-package reinstall-package

Reinstall a specific package, regardless of whether it's already installed. Implies --refresh-package特定のパッケージを再インストールします。すでにインストールされているかどうかに関係なく実行されます。--refresh-packageを暗示します。

--resolution resolution--resolution resolution

The strategy to use when selecting between the different compatible versions for a given package requirement.特定のパッケージ要件に対して異なる互換バージョンを選択する際に使用する戦略。

By default, uv will use the latest compatible version of each package (highest).デフォルトでは、uvは各パッケージの最新の互換バージョンを使用します（highest）。

May also be set with the UV_RESOLUTION environment variable.UV_RESOLUTION環境変数を使用して設定することもできます。

Possible values:可能な値：

highest: Resolve the highest compatible version of each packagehighest: 各パッケージの最高の互換バージョンを解決します。
lowest: Resolve the lowest compatible version of each packagelowest: 各パッケージの最低の互換バージョンを解決します。
lowest-direct: Resolve the lowest compatible version of any direct dependencies, and the highest compatible version of any transitive dependencieslowest-direct: 直接依存関係の最低の互換バージョンを解決し、間接依存関係の最高の互換バージョンを解決します。

--upgrade, -U--upgrade, -U

Allow package upgrades, ignoring pinned versions in any existing output file. Implies --refreshパッケージのアップグレードを許可し、既存の出力ファイルに固定されたバージョンを無視します。--refreshを含みます。

--upgrade-package, -P upgrade-package--upgrade-package, -P upgrade-package

Allow upgrades for a specific package, ignoring pinned versions in any existing output file. Implies --refresh-package特定のパッケージのアップグレードを許可し、既存の出力ファイルに固定されたバージョンを無視します。--refresh-packageを含みます。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)環境変数RUST_LOGを使用して、詳細なログ記録を構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

--with, -w with--with, -w with

Include the following additional requirements以下の追加要件を含めます。

--with-editable with-editable--with-editable with-editable

Include the given packages in editable mode指定されたパッケージを編集可能モードで含める

--with-executables-from with-executables-from--with-executables-from with-executables-from

Install executables from the following packages以下のパッケージから実行可能ファイルをインストールする

--with-requirements with-requirements--with-requirements with-requirements

Run with the packages listed in the given files.指定されたファイルにリストされたパッケージで実行する。

The following formats are supported: requirements.txt, .py files with inline metadata, and pylock.toml.以下のフォーマットがサポートされています: requirements.txt、インラインメタデータを含む.pyファイル、およびpylock.toml。

uv tool upgradeuv tool upgrade

Upgrade installed tools.インストールされたツールをアップグレードする。

If a tool was installed with version constraints, they will be respected on upgrade — to upgrade a tool beyond the originally provided constraints, use uv tool install again.ツールがバージョン制約付きでインストールされた場合、アップグレード時にそれが尊重されます — 元々提供された制約を超えてツールをアップグレードするには、再度uv tool installを使用してください。

If a tool was installed with specific settings, they will be respected on upgraded. For example, if --prereleases allow was provided during installation, it will continue to be respected in upgrades.ツールが特定の設定でインストールされた場合、アップグレード時にもそれが尊重されます。例えば、インストール時に--prereleases allowが提供された場合、アップグレードでもそれが尊重され続けます。

Usage使用法

uv tool upgrade [OPTIONS] <NAME>...

Arguments引数

NAMENAME: The name of the tool to upgrade, along with an optional version specifierアップグレードするツールの名前と、オプションのバージョンスペシファイア

Optionsオプション

--all--all

Upgrade all toolsすべてのツールをアップグレード

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回提供できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホストポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数で設定することもできます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvに、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されています。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数で設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvはターミナルへの書き込み時に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: ターミナルまたはサポートのあるTTYに出力される場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--compile-bytecode, --compile--compile-bytecode, --compile

Compile Python files to bytecode after installation.インストール後にPythonファイルをバイトコードにコンパイルします。

By default, uv does not compile Python (.py) files to bytecode (__pycache__/*.pyc); instead, compilation is performed lazily the first time a module is imported. For use-cases in which start time is critical, such as CLI applications and Docker containers, this option can be enabled to trade longer installation times for faster start times.デフォルトでは、uvはPython（.py）ファイルをバイトコード（__pycache__/*.pyc）にコンパイルしません。代わりに、モジュールが初めてインポートされるときに遅延的にコンパイルが行われます。CLIアプリケーションやDockerコンテナなど、起動時間が重要なユースケースでは、このオプションを有効にすることで、長いインストール時間と引き換えに速い起動時間を得ることができます。

When enabled, uv will process the entire site-packages directory (including packages that are not being modified by the current operation) for consistency. Like pip, it will also ignore errors.有効にすると、uvは一貫性のためにサイトパッケージディレクトリ全体（現在の操作によって変更されていないパッケージを含む）を処理します。pipのように、エラーも無視します。

May also be set with the UV_COMPILE_BYTECODE environment variable.UV_COMPILE_BYTECODE環境変数で設定することもできます。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.uv.toml ファイルのパスを設定に使用します。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE 環境変数で設定することもできます。

--config-setting, --config-settings, -C config-setting--config-setting, --config-settings, -C config-setting

Settings to pass to the PEP 517 build backend, specified as KEY=VALUE pairsPEP 517ビルドバックエンドに渡す設定で、KEY=VALUE ペアとして指定します。

--config-setting-package, --config-settings-package config-setting-package--config-setting-package, --config-settings-package config-setting-package

Settings to pass to the PEP 517 build backend for a specific package, specified as PACKAGE:KEY=VALUE pairs特定のパッケージのためにPEP 517ビルドバックエンドに渡す設定で、PACKAGE:KEY=VALUE ペアとして指定します。

--default-index default-index--default-index default-index

The URL of the default package index (by default: https://pypi.org/simple).デフォルトのパッケージインデックスのURL（デフォルト: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリのいずれかを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --index flag.このフラグで指定されたインデックスは、--indexフラグで指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_DEFAULT_INDEX environment variable.UV_DEFAULT_INDEX環境変数でも設定できます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数でも設定できます。

--exclude-newer exclude-newer--exclude-newer exclude-newer

Limit candidate packages to those that were uploaded prior to the given date.候補パッケージを、指定された日付以前にアップロードされたものに制限します。

Accepts both RFC 3339 timestamps (e.g., 2006-12-02T02:07:43Z) and local dates in the same format (e.g., 2006-12-02) in your system's configured time zone.RFC 3339 タイムスタンプ（例：2006-12-02T02:07:43Z）と、システムの設定されたタイムゾーンでの同じ形式のローカル日付（例：2006-12-02）の両方を受け入れます。

May also be set with the UV_EXCLUDE_NEWER environment variable.UV_EXCLUDE_NEWER 環境変数で設定することもできます。

--exclude-newer-package exclude-newer-package--exclude-newer-package exclude-newer-package

Limit candidate packages for specific packages to those that were uploaded prior to the given date.特定のパッケージの候補パッケージを、指定された日付以前にアップロードされたものに制限します。

Accepts package-date pairs in the format PACKAGE=DATE, where DATE is an RFC 3339 timestamp (e.g., 2006-12-02T02:07:43Z) or local date (e.g., 2006-12-02) in your system's configured time zone.PACKAGE=DATE 形式のパッケージ日付ペアを受け入れます。ここで、DATE は RFC 3339 タイムスタンプ（例：2006-12-02T02:07:43Z）またはローカル日付（例：2006-12-02）で、システムの設定されたタイムゾーンに基づきます。

Can be provided multiple times for different packages.異なるパッケージのために複数回提供できます。

--extra-index-url extra-index-url--extra-index-url extra-index-url

(Deprecated: use --index instead) Extra URLs of package indexes to use, in addition to --index-url.(非推奨：代わりに --index を使用してください) --index-url に加えて使用するパッケージインデックスの追加URL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式で配置されたローカルディレクトリのいずれかを受け入れます。

All indexes provided via this flag take priority over the index specified by --index-url (which defaults to PyPI). When multiple --extra-index-url flags are provided, earlier values take priority.このフラグを介して提供されたすべてのインデックスは、--index-url（デフォルトは PyPI）で指定されたインデックスよりも優先されます。複数の --extra-index-url フラグが提供される場合、早い値が優先されます。

May also be set with the UV_EXTRA_INDEX_URL environment variable.環境変数 UV_EXTRA_INDEX_URL でも設定できます。

--find-links, -f find-links--find-links, -f find-links

Locations to search for candidate distributions, in addition to those found in the registry indexes.レジストリインデックスで見つかったものに加えて、候補となる配布物を検索する場所。

If a path, the target must be a directory that contains packages as wheel files (.whl) or source distributions (e.g., .tar.gz or .zip) at the top level.パスの場合、ターゲットはトップレベルにホイールファイル (.whl) またはソース配布物 (例: .tar.gz または .zip) を含むディレクトリでなければなりません。

If a URL, the page must contain a flat list of links to package files adhering to the formats described above.URLの場合、そのページは上記の形式に従ったパッケージファイルへのリンクのフラットリストを含む必要があります。

May also be set with the UV_FIND_LINKS environment variable.環境変数 UV_FIND_LINKS でも設定できます。

--fork-strategy fork-strategy--fork-strategy fork-strategy

The strategy to use when selecting multiple versions of a given package across Python versions and platforms.特定のパッケージの複数のバージョンをPythonのバージョンやプラットフォームにわたって選択する際に使用する戦略。

By default, uv will optimize for selecting the latest version of each package for each supported Python version (requires-python), while minimizing the number of selected versions across platforms.デフォルトでは、uvは各サポートされているPythonバージョン (requires-python) に対して各パッケージの最新バージョンを選択することを最適化し、プラットフォーム間で選択されたバージョンの数を最小限に抑えます。

Under fewest, uv will minimize the number of selected versions for each package, preferring older versions that are compatible with a wider range of supported Python versions or platforms.fewest の下では、uvは各パッケージの選択されたバージョンの数を最小限に抑え、より広範囲のサポートされているPythonバージョンやプラットフォームと互換性のある古いバージョンを優先します。

May also be set with the UV_FORK_STRATEGY environment variable.また、UV_FORK_STRATEGY 環境変数で設定することもできます。

Possible values:可能な値：

fewest: Optimize for selecting the fewest number of versions for each package. Older versions may be preferred if they are compatible with a wider range of supported Python versions or platformsfewest: 各パッケージのバージョン数を最小限に抑えるよう最適化します。古いバージョンは、より広範囲のサポートされているPythonバージョンやプラットフォームと互換性がある場合に優先されることがあります。
requires-python: Optimize for selecting latest supported version of each package, for each supported Python versionrequires-python: 各サポートされているPythonバージョンに対して、各パッケージの最新のサポートバージョンを選択するよう最適化します。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--index index--index index

The URLs to use when resolving dependencies, in addition to the default index.デフォルトのインデックスに加えて、依存関係を解決するために使用するURLです。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリまたは同じ形式でレイアウトされたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --default-index (which defaults to PyPI). When multiple --index flags are provided, earlier values take priority.このフラグを介して提供されたすべてのインデックスは、--default-index（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の--indexフラグが提供される場合、先に指定された値が優先されます。

Index names are not supported as values. Relative paths must be disambiguated from index names with ./ or ../ on Unix or .\\, ..\\, ./ or ../ on Windows.インデックス名は値としてサポートされていません。相対パスは、Unixでは./または../、Windowsでは.\\、..\\、./または../を使用してインデックス名から区別する必要があります。

May also be set with the UV_INDEX environment variable.UV_INDEX環境変数を使用して設定することもできます。

--index-strategy index-strategy--index-strategy index-strategy

The strategy to use when resolving against multiple index URLs.複数のインデックスURLに対して解決する際に使用する戦略。

By default, uv will stop at the first index on which a given package is available, and limit resolutions to those present on that first index (first-index). This prevents "dependency confusion" attacks, whereby an attacker can upload a malicious package under the same name to an alternate index.デフォルトでは、uvは指定されたパッケージが利用可能な最初のインデックスで停止し、その最初のインデックスに存在するものに解決を制限します(first-index)。これにより、攻撃者が同じ名前の悪意のあるパッケージを別のインデックスにアップロードすることによる「依存関係の混乱」攻撃を防ぎます。

May also be set with the UV_INDEX_STRATEGY environment variable.UV_INDEX_STRATEGY環境変数を使用して設定することもできます。

Possible values:可能な値：

first-index: Only use results from the first index that returns a match for a given package namefirst-index: 指定されたパッケージ名に一致する最初のインデックスからの結果のみを使用します。
unsafe-first-match: Search for every package name across all indexes, exhausting the versions from the first index before moving on to the nextunsafe-first-match: すべてのインデックスで各パッケージ名を検索し、次のインデックスに移動する前に最初のインデックスからのバージョンを使い果たします。
unsafe-best-match: Search for every package name across all indexes, preferring the "best" version found. If a package version is in multiple indexes, only look at the entry for the first indexunsafe-best-match: すべてのインデックスで各パッケージ名を検索し、見つかった「最良」のバージョンを優先します。パッケージバージョンが複数のインデックスに存在する場合、最初のインデックスのエントリのみを確認します。

--index-url, -i index-url--index-url, -i index-url

(Deprecated: use --default-index instead) The URL of the Python package index (by default: https://pypi.org/simple).(非推奨: 代わりに --default-index を使用してください) PythonパッケージインデックスのURL（デフォルト: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --extra-index-url flag.このフラグで指定されたインデックスは、--extra-index-urlフラグを介して指定されたすべての他のインデックスよりも優先度が低くなります。

May also be set with the UV_INDEX_URL environment variable.UV_INDEX_URL 環境変数で設定することもできます。

--keyring-provider keyring-provider--keyring-provider keyring-provider

Attempt to use keyring for authentication for index URLs.インデックスURLの認証に keyring を使用しようとします。

At present, only --keyring-provider subprocess is supported, which configures uv to use the keyring CLI to handle authentication.現在のところ、--keyring-provider subprocess のみがサポートされており、これはuvが認証を処理するためにkeyring CLIを使用するように設定します。

Defaults to disabled.デフォルトは disabled です。

May also be set with the UV_KEYRING_PROVIDER environment variable.UV_KEYRING_PROVIDER 環境変数で設定することもできます。

Possible values:可能な値：

disabled: Do not use keyring for credential lookupdisabled: 認証情報の検索にkeyringを使用しない
subprocess: Use the keyring command for credential lookupsubprocess: 認証情報の検索にkeyringコマンドを使用する

--link-mode link-mode--link-mode link-mode

The method to use when installing packages from the global cache.グローバルキャッシュからパッケージをインストールする際に使用するメソッド。

Defaults to clone (also known as Copy-on-Write) on macOS, and hardlink on Linux and Windows.macOSではclone（コピーオンライトとも呼ばれる）にデフォルト設定され、LinuxおよびWindowsではhardlinkにデフォルト設定されます。

WARNING: The use of symlink link mode is discouraged, as they create tight coupling between the cache and the target environment. For example, clearing the cache (uv cache clean) will break all installed packages by way of removing the underlying source files. Use symlinks with caution.警告：シンボリックリンクモードの使用は推奨されません。キャッシュとターゲット環境の間に強い結合を生じさせるためです。たとえば、キャッシュをクリアすること（uv cache clean）は、基になるソースファイルを削除することによってすべてのインストールされたパッケージを壊します。シンボリックリンクは注意して使用してください。

May also be set with the UV_LINK_MODE environment variable.UV_LINK_MODE環境変数でも設定できます。

Possible values:可能な値：

clone: Clone (i.e., copy-on-write) packages from the wheel into the site-packages directoryclone: ホイールからsite-packagesディレクトリにパッケージをクローン（すなわち、コピーオンライト）する
copy: Copy packages from the wheel into the site-packages directorycopy: ホイールからsite-packagesディレクトリにパッケージをコピーします
hardlink: Hard link packages from the wheel into the site-packages directoryhardlink: ホイールからsite-packagesディレクトリにパッケージをハードリンクします
symlink: Symbolically link packages from the wheel into the site-packages directorysymlink: ホイールからsite-packagesディレクトリにパッケージをシンボリックリンクします

--managed-python--managed-python

Require use of uv-managed Python versions.uv管理のPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理しているPythonバージョンの使用を優先します。ただし、uv管理のPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、プラットフォームのネイティブ証明書ストアを使用したいことがあります。特に、システムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合です。

May also be set with the UV_NATIVE_TLS environment variable.環境変数 UV_NATIVE_TLS で設定することもできます。

--no-binary--no-binary

Don't install pre-built wheels.事前にビルドされたホイールをインストールしないでください。

The given packages will be built and installed from source. The resolver will still use pre-built wheels to extract package metadata, if available.指定されたパッケージはソースからビルドされ、インストールされます。リゾルバーは、利用可能な場合、パッケージメタデータを抽出するために事前にビルドされたホイールを使用します。

May also be set with the UV_NO_BINARY environment variable.環境変数 UV_NO_BINARY で設定することもできます。

--no-binary-package no-binary-package--no-binary-package no-binary-package

Don't install pre-built wheels for a specific package特定のパッケージに対して事前にビルドされたホイールをインストールしないでください。

May also be set with the UV_NO_BINARY_PACKAGE environment variable.環境変数 UV_NO_BINARY_PACKAGE で設定することもできます。

--no-build--no-build

Don't build source distributions.ソース配布物をビルドしないでください。

When enabled, resolving will not run arbitrary Python code. The cached wheels of already-built source distributions will be reused, but operations that require building distributions will exit with an error.有効にすると、解決時に任意のPythonコードは実行されません。すでにビルドされたソース配布物のキャッシュされたホイールが再利用されますが、配布物のビルドを必要とする操作はエラーで終了します。

May also be set with the UV_NO_BUILD environment variable.UV_NO_BUILD 環境変数でも設定できます。

--no-build-isolation--no-build-isolation

Disable isolation when building source distributions.ソース配布物をビルドする際にアイソレーションを無効にします。

Assumes that build dependencies specified by PEP 518 are already installed.PEP 518で指定されたビルド依存関係がすでにインストールされていると仮定します。

May also be set with the UV_NO_BUILD_ISOLATION environment variable.UV_NO_BUILD_ISOLATION 環境変数でも設定できます。

--no-build-isolation-package no-build-isolation-package--no-build-isolation-package no-build-isolation-package

Disable isolation when building source distributions for a specific package.特定のパッケージのソース配布物をビルドする際にアイソレーションを無効にします。

Assumes that the packages' build dependencies specified by PEP 518 are already installed.そのパッケージのビルド依存関係がPEP 518で指定されていると仮定します。

--no-build-package no-build-package--no-build-package no-build-package

Don't build source distributions for a specific package特定のパッケージのソース配布物をビルドしない

May also be set with the UV_NO_BUILD_PACKAGE environment variable.環境変数 UV_NO_BUILD_PACKAGE でも設定可能です。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.環境変数 UV_NO_CACHE でも設定可能です。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml, uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.環境変数 UV_NO_CONFIG でも設定可能です。

--no-index--no-index

Ignore the registry index (e.g., PyPI), instead relying on direct URL dependencies and those provided via --find-linksレジストリインデックス（例：PyPI）を無視し、代わりに直接URL依存関係および--find-linksで提供されるものに依存します。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.その代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--no-sources--no-sources

Ignore the tool.uv.sources table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any workspace, Git, URL, or local path sources依存関係を解決する際にtool.uv.sourcesテーブルを無視します。ワークスペース、Git、URL、またはローカルパスソースを使用するのではなく、標準準拠の公開可能なパッケージメタデータに対してロックするために使用されます。

May also be set with the UV_NO_SOURCES environment variable.UV_NO_SOURCES環境変数でも設定できます。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE環境変数でも設定できます。

--prerelease prerelease--prerelease prerelease

The strategy to use when considering pre-release versions.プレリリースバージョンを考慮する際に使用する戦略。

By default, uv will accept pre-releases for packages that only publish pre-releases, along with first-party requirements that contain an explicit pre-release marker in the declared specifiers (if-necessary-or-explicit).デフォルトでは、uvはプレリリースのみを公開するパッケージと、宣言された指定子に明示的なプレリリースマーカーを含むファーストパーティの要件に対してプレリリースを受け入れます（if-necessary-or-explicit）。

May also be set with the UV_PRERELEASE environment variable.UV_PRERELEASE 環境変数で設定することもできます。

Possible values:可能な値：

disallow: Disallow all pre-release versionsdisallow: すべてのプレリリースバージョンを禁止する
allow: Allow all pre-release versionsallow: すべてのプレリリースバージョンを許可する
if-necessary: Allow pre-release versions if all versions of a package are pre-releaseif-necessary: パッケージのすべてのバージョンがプレリリースである場合にプレリリースバージョンを許可する
explicit: Allow pre-release versions for first-party packages with explicit pre-release markers in their version requirementsexplicit: バージョン要件に明示的なプレリリースマーカーを持つファーストパーティパッケージに対してプレリリースバージョンを許可する
if-necessary-or-explicit: Allow pre-release versions if all versions of a package are pre-release, or if the package has an explicit pre-release marker in its version requirementsif-necessary-or-explicit: パッケージのすべてのバージョンがプレリリースである場合、またはパッケージのバージョン要件に明示的なプレリリースマーカーがある場合にプレリリースバージョンを許可する

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数を使用して設定することもできます。

--python, -p python--python、-p python

Upgrade a tool, and specify it to use the given Python interpreter to build its environment. Use with --all to apply to all tools.ツールをアップグレードし、指定された Python インタープリターを使用してその環境を構築するように指定します。 --all と一緒に使用して、すべてのツールに適用します。

See uv python for details on Python discovery and supported request formats.Python の発見とサポートされているリクエスト形式の詳細については、uv python を参照してください。

May also be set with the UV_PYTHON environment variable.UV_PYTHON 環境変数を使用して設定することもできます。

--python-platform python-platform--python-platform python-platform

The platform for which requirements should be installed.要件をインストールするプラットフォーム。

Represented as a "target triple", a string that describes the target platform in terms of its CPU, vendor, and operating system name, like x86_64-unknown-linux-gnu or aarch64-apple-darwin.CPU、ベンダー、およびオペレーティングシステム名に関してターゲットプラットフォームを説明する文字列である「ターゲットトリプル」として表されます。例えば、x86_64-unknown-linux-gnuやaarch64-apple-darwinのように。

When targeting macOS (Darwin), the default minimum version is 13.0. Use MACOSX_DEPLOYMENT_TARGET to specify a different minimum version, e.g., 14.0.macOS（Darwin）をターゲットにする場合、デフォルトの最小バージョンは13.0です。異なる最小バージョンを指定するにはMACOSX_DEPLOYMENT_TARGETを使用します。例：14.0。

When targeting iOS, the default minimum version is 13.0. Use IPHONEOS_DEPLOYMENT_TARGET to specify a different minimum version, e.g., 14.0.iOSをターゲットにする場合、デフォルトの最小バージョンは13.0です。異なる最小バージョンを指定するにはIPHONEOS_DEPLOYMENT_TARGETを使用します。例：14.0。

When targeting Android, the default minimum Android API level is 24. Use ANDROID_API_LEVEL to specify a different minimum version, e.g., 26.Androidをターゲットにする場合、デフォルトの最小Android APIレベルは24です。異なる最小バージョンを指定するにはANDROID_API_LEVELを使用します。例：26。

WARNING: When specified, uv will select wheels that are compatible with the target platform; as a result, the installed distributions may not be compatible with the current platform. Conversely, any distributions that are built from source may be incompatible with the target platform, as they will be built for the current platform. The --python-platform option is intended for advanced use cases.警告：指定された場合、uvはターゲットプラットフォームと互換性のあるホイールを選択します。その結果、インストールされたディストリビューションは現在のプラットフォームと互換性がない可能性があります。逆に、ソースからビルドされたディストリビューションはターゲットプラットフォームと互換性がない可能性があります。なぜなら、それらは現在のプラットフォーム用にビルドされるからです。--python-platformオプションは、高度な使用ケースを想定しています。

Possible values:可能な値：

windows: An alias for x86_64-pc-windows-msvc, the default target for Windowswindows：x86_64-pc-windows-msvcのエイリアスで、Windowsのデフォルトターゲット。
linux: An alias for x86_64-unknown-linux-gnu, the default target for Linuxlinux：x86_64-unknown-linux-gnuのエイリアスで、Linuxのデフォルトターゲット。
macos: An alias for aarch64-apple-darwin, the default target for macOSmacos: aarch64-apple-darwinのエイリアスで、macOSのデフォルトターゲットです。
x86_64-pc-windows-msvc: A 64-bit x86 Windows targetx86_64-pc-windows-msvc: 64ビットx86 Windowsターゲットです。
aarch64-pc-windows-msvc: An ARM64 Windows targetaarch64-pc-windows-msvc: ARM64 Windowsターゲットです。
i686-pc-windows-msvc: A 32-bit x86 Windows targeti686-pc-windows-msvc: 32ビットx86 Windowsターゲットです。
x86_64-unknown-linux-gnu: An x86 Linux target. Equivalent to x86_64-manylinux_2_28x86_64-unknown-linux-gnu: x86 Linuxターゲットです。x86_64-manylinux_2_28と同等です。
aarch64-apple-darwin: An ARM-based macOS target, as seen on Apple Silicon devicesaarch64-apple-darwin: Apple Siliconデバイスで見られるARMベースのmacOSターゲットです。
x86_64-apple-darwin: An x86 macOS targetx86_64-apple-darwin: x86 macOSターゲットです。
aarch64-unknown-linux-gnu: An ARM64 Linux target. Equivalent to aarch64-manylinux_2_28aarch64-unknown-linux-gnu: ARM64 Linuxターゲットです。aarch64-manylinux_2_28と同等です。
aarch64-unknown-linux-musl: An ARM64 Linux targetaarch64-unknown-linux-musl: ARM64 Linuxターゲットです。
x86_64-unknown-linux-musl: An x86_64 Linux targetx86_64-unknown-linux-musl: x86_64 Linuxターゲットです。
riscv64-unknown-linux: A RISCV64 Linux targetriscv64-unknown-linux: RISCV64 Linux ターゲット
x86_64-manylinux2014: An x86_64 target for the manylinux2014 platform. Equivalent to x86_64-manylinux_2_17x86_64-manylinux2014: x86_64 ターゲットで、manylinux2014 プラットフォーム用。x86_64-manylinux_2_17 と同等です。
x86_64-manylinux_2_17: An x86_64 target for the manylinux_2_17 platformx86_64-manylinux_2_17: x86_64 ターゲットで、manylinux_2_17 プラットフォーム用
x86_64-manylinux_2_28: An x86_64 target for the manylinux_2_28 platformx86_64-manylinux_2_28: x86_64 ターゲットで、manylinux_2_28 プラットフォーム用
x86_64-manylinux_2_31: An x86_64 target for the manylinux_2_31 platformx86_64-manylinux_2_31: x86_64 ターゲットで、manylinux_2_31 プラットフォーム用
x86_64-manylinux_2_32: An x86_64 target for the manylinux_2_32 platformx86_64-manylinux_2_32: x86_64 ターゲットで、manylinux_2_32 プラットフォーム用
x86_64-manylinux_2_33: An x86_64 target for the manylinux_2_33 platformx86_64-manylinux_2_33: x86_64 ターゲットで、manylinux_2_33 プラットフォーム用
x86_64-manylinux_2_34: An x86_64 target for the manylinux_2_34 platformx86_64-manylinux_2_34: x86_64 ターゲットで、manylinux_2_34 プラットフォーム用
x86_64-manylinux_2_35: An x86_64 target for the manylinux_2_35 platformx86_64-manylinux_2_35: x86_64 ターゲットで、manylinux_2_35 プラットフォーム用
x86_64-manylinux_2_36: An x86_64 target for the manylinux_2_36 platformx86_64-manylinux_2_36: x86_64 ターゲットで、manylinux_2_36 プラットフォーム用
x86_64-manylinux_2_37: An x86_64 target for the manylinux_2_37 platformx86_64-manylinux_2_37: x86_64 ターゲットの manylinux_2_37 プラットフォーム
x86_64-manylinux_2_38: An x86_64 target for the manylinux_2_38 platformx86_64-manylinux_2_38: x86_64 ターゲットの manylinux_2_38 プラットフォーム
x86_64-manylinux_2_39: An x86_64 target for the manylinux_2_39 platformx86_64-manylinux_2_39: x86_64 ターゲットの manylinux_2_39 プラットフォーム
x86_64-manylinux_2_40: An x86_64 target for the manylinux_2_40 platformx86_64-manylinux_2_40: x86_64 ターゲットの manylinux_2_40 プラットフォーム
aarch64-manylinux2014: An ARM64 target for the manylinux2014 platform. Equivalent to aarch64-manylinux_2_17aarch64-manylinux2014: manylinux2014 プラットフォームの ARM64 ターゲット。aarch64-manylinux_2_17 と同等
aarch64-manylinux_2_17: An ARM64 target for the manylinux_2_17 platformaarch64-manylinux_2_17: manylinux_2_17 プラットフォームの ARM64 ターゲット
aarch64-manylinux_2_28: An ARM64 target for the manylinux_2_28 platformaarch64-manylinux_2_28: manylinux_2_28 プラットフォームの ARM64 ターゲット
aarch64-manylinux_2_31: An ARM64 target for the manylinux_2_31 platformaarch64-manylinux_2_31: manylinux_2_31 プラットフォームの ARM64 ターゲット
aarch64-manylinux_2_32: An ARM64 target for the manylinux_2_32 platformaarch64-manylinux_2_32: manylinux_2_32 プラットフォームの ARM64 ターゲット
aarch64-manylinux_2_33: An ARM64 target for the manylinux_2_33 platformaarch64-manylinux_2_33: manylinux_2_33 プラットフォームの ARM64 ターゲット
aarch64-manylinux_2_34: An ARM64 target for the manylinux_2_34 platformaarch64-manylinux_2_34: manylinux_2_34プラットフォーム用のARM64ターゲット
aarch64-manylinux_2_35: An ARM64 target for the manylinux_2_35 platformaarch64-manylinux_2_35: manylinux_2_35プラットフォーム用のARM64ターゲット
aarch64-manylinux_2_36: An ARM64 target for the manylinux_2_36 platformaarch64-manylinux_2_36: manylinux_2_36プラットフォーム用のARM64ターゲット
aarch64-manylinux_2_37: An ARM64 target for the manylinux_2_37 platformaarch64-manylinux_2_37: manylinux_2_37プラットフォーム用のARM64ターゲット
aarch64-manylinux_2_38: An ARM64 target for the manylinux_2_38 platformaarch64-manylinux_2_38: manylinux_2_38プラットフォーム用のARM64ターゲット
aarch64-manylinux_2_39: An ARM64 target for the manylinux_2_39 platformaarch64-manylinux_2_39: manylinux_2_39プラットフォーム用のARM64ターゲット
aarch64-manylinux_2_40: An ARM64 target for the manylinux_2_40 platformaarch64-manylinux_2_40: manylinux_2_40プラットフォーム用のARM64ターゲット
aarch64-linux-android: An ARM64 Android targetaarch64-linux-android: ARM64 Androidターゲット
x86_64-linux-android: An x86_64 Android targetx86_64-linux-android: x86_64 Androidターゲット
wasm32-pyodide2024: A wasm32 target using the Pyodide 2024 platform. Meant for use with Python 3.12wasm32-pyodide2024: Pyodide 2024プラットフォームを使用したwasm32ターゲット。Python 3.12用に設計されています
arm64-apple-ios: An ARM64 target for iOS devicearm64-apple-ios: iOSデバイス用のARM64ターゲット
arm64-apple-ios-simulator: An ARM64 target for iOS simulatorarm64-apple-ios-simulator: iOSシミュレーター用のARM64ターゲット
x86_64-apple-ios-simulator: An x86_64 target for iOS simulatorx86_64-apple-ios-simulator: iOSシミュレーター用のx86_64ターゲット

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば-qq、uvはstdoutに出力を行わないサイレントモードを有効にします。

--reinstall, --force-reinstall--reinstall, --force-reinstall

Reinstall all packages, regardless of whether they're already installed. Implies --refreshすべてのパッケージを再インストールします。すでにインストールされているかどうかに関わらず。--refreshを含みます。

--reinstall-package reinstall-package--reinstall-package reinstall-package

Reinstall a specific package, regardless of whether it's already installed. Implies --refresh-package特定のパッケージを再インストールします。すでにインストールされているかどうかに関わらず。--refresh-packageを含みます。

--resolution resolution--resolution 解像度

The strategy to use when selecting between the different compatible versions for a given package requirement.特定のパッケージ要件に対して異なる互換バージョンを選択する際に使用する戦略。

By default, uv will use the latest compatible version of each package (highest).デフォルトでは、uvは各パッケージの最新の互換バージョンを使用します (highest)。

May also be set with the UV_RESOLUTION environment variable.UV_RESOLUTION 環境変数を使用して設定することもできます。

Possible values:可能な値：

highest: Resolve the highest compatible version of each packagehighest: 各パッケージの最高の互換バージョンを解決します
lowest: Resolve the lowest compatible version of each packagelowest: 各パッケージの最低の互換バージョンを解決します
lowest-direct: Resolve the lowest compatible version of any direct dependencies, and the highest compatible version of any transitive dependencieslowest-direct: 直接依存関係の最低の互換バージョンを解決し、間接依存関係の最高の互換バージョンを解決します

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)細かいログ設定は、RUST_LOG 環境変数を使用して構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv tool listuv tool list

List installed toolsインストールされたツールのリスト

Usage使用法

uv tool list [OPTIONS]

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例: localhost）、ホストポートペア（例: localhost:8080）、またはURL（例: https://localhost）のいずれかを受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告: このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-host は、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST 環境変数で設定することもできます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.デフォルトでは、macOSおよびLinuxでは $XDG_CACHE_HOME/uv または $HOME/.cache/uv、Windowsでは %LOCALAPPDATA%\uv\cache になります。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dir を実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR 環境変数で設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvはターミナルに書き込む際に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力が端末またはサポートされているTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用するuv.tomlファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数を使用して設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.プロジェクトルートディレクトリのみを変更するには、--projectを参照してください。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数でも設定できます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--managed-python--managed-python

Require use of uv-managed Python versions.uv-managed Pythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンの使用を優先します。ただし、uv-managed Pythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、プラットフォームのネイティブ証明書ストアを使用したいことがあります。特に、システムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合です。

May also be set with the UV_NATIVE_TLS environment variable.また、UV_NATIVE_TLS環境変数で設定することもできます。

--no-cache, --no-cache-dir, -n--no-cache、--no-cache-dir、-n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の期間中は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.また、UV_NO_CACHE環境変数で設定することもできます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).pyproject.tomlやuv.tomlなどの設定ファイルの発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.また、UV_NO_CONFIG環境変数で設定することもできます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv-managed Python バージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uv はシステム上の適切な Python バージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON 環境変数でも設定できます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS 環境変数でも設定できます。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.環境変数 UV_OFFLINE でも設定できます。

--project project--project project

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に歩いて発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.作業ディレクトリを完全に変更するには --directory を参照してください。

This setting has no effect when used in the uv pip interface.この設定は uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.環境変数 UV_PROJECT でも設定できます。

--quiet, -q--quiet、-q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uvがstdoutに出力を行わないサイレントモードが有効になります。

--show-extras--show-extras

Whether to display the extra requirements installed with each tool各ツールにインストールされた追加の要件を表示するかどうか

--show-paths--show-paths

Whether to display the path to each tool environment and installed executable各ツール環境およびインストールされた実行可能ファイルへのパスを表示するかどうか

--show-python--show-python

Whether to display the Python version associated with each tool各ツールに関連付けられたPythonのバージョンを表示するかどうか

--show-version-specifiers--show-version-specifiers

Whether to display the version specifier(s) used to install each tool各ツールをインストールするために使用されたバージョンスペシファイアを表示するかどうか

--show-with--show-with

Whether to display the additional requirements installed with each tool各ツールにインストールされた追加要件を表示するかどうか

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)細かいログ記録は、RUST_LOG 環境変数を使用して設定できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv tool uninstalluv tool uninstall

Uninstall a toolツールをアンインストールする

Usage使用法

uv tool uninstall [OPTIONS] <NAME>...

Arguments引数

NAMENAME: The name of the tool to uninstallアンインストールするツールの名前

Optionsオプション

--all--all

Uninstall all toolsすべてのツールをアンインストール

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--cache-dir cache-dir--cache-dir キャッシュディレクトリ

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.デフォルトでは $XDG_CACHE_HOME/uv または $HOME/.cache/uv（macOSおよびLinux）、および %LOCALAPPDATA%\uv\cache（Windows）になります。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR 環境変数を使用して設定することもできます。

--color color-choice--color 色の選択

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvはターミナルへの書き込み時に自動的に色のサポートを検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力が色のサポートを持つターミナルまたはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 環境に関係なくカラフルな出力を有効にします
never: Disables colored outputnever: カラフルな出力を無効にします

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用するuv.tomlファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数を使用して設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.環境変数 UV_WORKING_DIRECTORY で設定することもできます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します

--managed-python--managed-python

Require use of uv-managed Python versions.uv-managed Python バージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理しているPythonバージョンを使用することを好みます。ただし、uv-managed Pythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.環境変数 UV_MANAGED_PYTHON で設定することもできます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされた webpki-roots クレートから証明書を読み込みます。webpki-roots はMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、プラットフォームのネイティブ証明書ストアを使用したいことがあります。特に、システムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合です。

May also be set with the UV_NATIVE_TLS environment variable.また、UV_NATIVE_TLS 環境変数で設定することもできます。

--no-cache, --no-cache-dir, -n--no-cache、--no-cache-dir、-n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.また、UV_NO_CACHE 環境変数で設定することもできます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml、uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.また、UV_NO_CONFIG 環境変数で設定することもできます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.その代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数でも設定できます。

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に歩いていくことで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用されると効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数でも設定できます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uvがstdoutに出力を行わないサイレントモードが有効になります。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)細かいログ記録は RUST_LOG 環境変数を使用して設定できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv tool update-shelluv tool update-shell

Ensure that the tool executable directory is on the PATH.ツールの実行可能ファイルのディレクトリが PATH に含まれていることを確認してください。

If the tool executable directory is not present on the PATH, uv will attempt to add it to the relevant shell configuration files.ツールの実行可能ファイルのディレクトリが PATH に存在しない場合、uvは関連するシェル設定ファイルに追加しようとします。

If the shell configuration files already include a blurb to add the executable directory to the path, but the directory is not present on the PATH, uv will exit with an error.シェル設定ファイルに実行可能ディレクトリをパスに追加するための記述が既に含まれているが、ディレクトリが PATH に存在しない場合、uvはエラーで終了します。

The tool executable directory is determined according to the XDG standard and can be retrieved with uv tool dir --bin.ツールの実行可能ディレクトリはXDG標準に従って決定され、uv tool dir --binで取得できます。

Usage使用法

uv tool update-shell [OPTIONS]

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvに、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されています。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数を使用して設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末への書き込み時に自動的に色のサポートを検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力が色のサポートを持つ端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.uv.toml ファイルのパスを設定に使用します。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定は pyproject.toml ファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE 環境変数で設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--project を参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY 環境変数で設定することもできます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します

--managed-python--managed-python

Require use of uv-managed Python versions.uv-managed Python バージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンを使用することを好みます。ただし、uv-managed Pythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON 環境変数を使用して設定することもできます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、特にシステムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したいことがあります。

May also be set with the UV_NATIVE_TLS environment variable.環境変数 UV_NATIVE_TLS でも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.環境変数 UV_NO_CACHE でも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル (pyproject.toml, uv.toml) の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.環境変数 UV_NO_CONFIG でも設定できます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.また、UV_NO_MANAGED_PYTHON環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.また、UV_NO_PROGRESS環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.これは、UV_OFFLINE 環境変数を使用して設定することもできます。

--project project--project project

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に歩くことで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.これは、UV_PROJECT 環境変数を使用して設定することもできます。

--quiet, -q--quiet、-q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uvがstdoutに出力を行わないサイレントモードを有効にします。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)細かいログ記録は RUST_LOG 環境変数を使用して設定できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv tool diruv tool dir

Show the path to the uv tools directory.uvツールディレクトリへのパスを表示します。

The tools directory is used to store environments and metadata for installed tools.ツールディレクトリは、インストールされたツールの環境とメタデータを保存するために使用されます。

By default, tools are stored in the uv data directory at $XDG_DATA_HOME/uv/tools or $HOME/.local/share/uv/tools on Unix and %APPDATA%\uv\data\tools on Windows.デフォルトでは、ツールはUnixの$XDG_DATA_HOME/uv/toolsまたは$HOME/.local/share/uv/tools、Windowsの%APPDATA%\uv\data\toolsにあるuvデータディレクトリに保存されます。

The tool installation directory may be overridden with $UV_TOOL_DIR.ツールのインストールディレクトリは$UV_TOOL_DIRで上書きできます。

To instead view the directory uv installs executables into, use the --bin flag.代わりに、uvが実行可能ファイルをインストールするディレクトリを表示するには、--binフラグを使用してください。

Usage使用法

uv tool dir [OPTIONS]

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの安全でない接続を許可します。

Can be provided multiple times.複数回提供できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--bin--bin

Show the directory into which uv tool will install executables.どのディレクトリに uv tool が実行可能ファイルをインストールするかを表示します。

By default, uv tool dir shows the directory into which the tool Python environments themselves are installed, rather than the directory containing the linked executables.デフォルトでは、uv tool dir はツールの Python 環境がインストールされているディレクトリを表示します。リンクされた実行可能ファイルを含むディレクトリではありません。

The tool executable directory is determined according to the XDG standard and is derived from the following environment variables, in order of preference:ツールの実行可能ファイルディレクトリは XDG 標準に従って決定され、次の環境変数から優先順位に従って導出されます：

$UV_TOOL_BIN_DIR$UV_TOOL_BIN_DIR
$XDG_BIN_HOME$XDG_BIN_HOME
$XDG_DATA_HOME/../bin$XDG_DATA_HOME/../bin
$HOME/.local/bin$HOME/.local/bin

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOS と Linux では $XDG_CACHE_HOME/uv または $HOME/.cache/uv にデフォルト設定され、Windows では %LOCALAPPDATA%\uv\cache になります。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数を使用して設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末に書き込む際に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力がサポートされている端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.uv.tomlファイルのパスを設定に使用します。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.pyproject.tomlファイルにuvの設定を含めることはできますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数で設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数で設定することもできます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します

--managed-python--managed-python

Require use of uv-managed Python versions.uvが管理するPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンの使用を優先します。ただし、uvが管理するPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンス（特にmacOSで）が向上します。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、特にシステムの証明書ストアに含まれる企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したい場合があります。

May also be set with the UV_NATIVE_TLS environment variable.UV_NATIVE_TLS環境変数でも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用してください。

May also be set with the UV_NO_CACHE environment variable.これは、UV_NO_CACHE 環境変数でも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml、uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.これは、UV_NO_CONFIG 環境変数でも設定できます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.その代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.これは、UV_NO_MANAGED_PYTHON 環境変数でも設定できます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS 環境変数でも設定できます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数でも設定できます。

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に歩いていくことで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用される場合、効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数を使用して設定することもできます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uv が stdout に出力を行わないサイレントモードを有効にします。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)環境変数 RUST_LOG を使用して、詳細なロギングを構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv pythonuv python

Manage Python versions and installationsPythonのバージョンとインストールを管理します

Generally, uv first searches for Python in a virtual environment, either active or in a .venv directory in the current working directory or any parent directory. If a virtual environment is not required, uv will then search for a Python interpreter. Python interpreters are found by searching for Python executables in the PATH environment variable.一般的に、uvはまず仮想環境内のPythonを検索します。アクティブなものか、現在の作業ディレクトリまたは親ディレクトリ内の.venvディレクトリにあります。仮想環境が必要ない場合、uvは次にPythonインタプリタを検索します。Pythonインタプリタは、PATH環境変数内のPython実行可能ファイルを検索することで見つかります。

On Windows, the registry is also searched for Python executables.Windowsでは、レジストリもPython実行可能ファイルを検索します。

By default, uv will download Python if a version cannot be found. This behavior can be disabled with the --no-python-downloads flag or the python-downloads setting.デフォルトでは、uvはバージョンが見つからない場合、Pythonをダウンロードします。この動作は、--no-python-downloadsフラグまたはpython-downloads設定を使用して無効にできます。

The --python option allows requesting a different interpreter.--pythonオプションを使用すると、別のインタプリタを要求できます。

The following Python version request formats are supported:以下のPythonバージョンリクエスト形式がサポートされています：

<version> e.g. 3, 3.12, 3.12.3<version> 例: 3, 3.12, 3.12.3
<version-specifier> e.g. >=3.12,<3.13<version-specifier> 例: >=3.12,<3.13
<version><short-variant> (e.g., 3.13t, 3.12.0d)<version><short-variant>（例：3.13t、3.12.0d）
<version>+<variant> (e.g., 3.13+freethreaded, 3.12.0+debug)<version>+<variant> (例: 3.13+freethreaded, 3.12.0+debug)
<implementation> e.g. cpython or cp<implementation> 例: cpython または cp
<implementation>@<version> e.g. cpython@3.12<implementation>@<version> 例: cpython@3.12
<implementation><version> e.g. cpython3.12 or cp312<implementation><version> 例: cpython3.12 または cp312
<implementation><version-specifier> e.g. cpython>=3.12,<3.13<implementation><version-specifier> 例: cpython>=3.12,<3.13
<implementation>-<version>-<os>-<arch>-<libc> e.g. cpython-3.12.3-macos-aarch64-none<implementation>-<version>-<os>-<arch>-<libc> 例: cpython-3.12.3-macos-aarch64-none

Additionally, a specific system Python interpreter can often be requested with:さらに、特定のシステムPythonインタプリタを要求することができます:

<executable-path> e.g. /opt/homebrew/bin/python3<executable-path> 例: /opt/homebrew/bin/python3
<executable-name> e.g. mypython3<executable-name> 例: mypython3
<install-dir> e.g. /some/environment/<install-dir> 例: /some/environment/

When the --python option is used, normal discovery rules apply but discovered interpreters are checked for compatibility with the request, e.g., if pypy is requested, uv will first check if the virtual environment contains a PyPy interpreter then check if each executable in the path is a PyPy interpreter.--python オプションが使用されると、通常の発見ルールが適用されますが、発見されたインタプリタはリクエストとの互換性がチェックされます。例えば、pypy がリクエストされた場合、uv はまず仮想環境に PyPy インタプリタが含まれているかを確認し、その後、パス内の各実行可能ファイルが PyPy インタプリタであるかをチェックします。

uv supports discovering CPython, PyPy, and GraalPy interpreters. Unsupported interpreters will be skipped during discovery. If an unsupported interpreter implementation is requested, uv will exit with an error.uv は CPython、PyPy、および GraalPy インタプリタの発見をサポートしています。サポートされていないインタプリタは発見中にスキップされます。サポートされていないインタプリタの実装がリクエストされた場合、uv はエラーで終了します。

Usage使用法

uv python [OPTIONS] <COMMAND>

Commandsコマンド

uv python listuv python list: List the available Python installations利用可能な Python インストールの一覧
uv python installuv python install: Download and install Python versionsPython バージョンをダウンロードしてインストール
uv python upgradeuv python upgrade: Upgrade installed Python versionsインストールされたPythonバージョンをアップグレード
uv python finduv python find: Search for a Python installationPythonインストールを検索
uv python pinuv python pin: Pin to a specific Python version特定のPythonバージョンにピン留め
uv python diruv python dir: Show the uv Python installation directoryuv Pythonインストールディレクトリを表示
uv python uninstalluv python uninstall: Uninstall Python versionsPythonバージョンをアンインストール
uv python update-shelluv python update-shell: Ensure that the Python executable directory is on the PATHPython実行可能ディレクトリがPATHに含まれていることを確認してください。

uv python listuv python list

List the available Python installations.利用可能なPythonインストールを一覧表示します。

By default, installed Python versions and the downloads for latest available patch version of each supported Python major version are shown.デフォルトでは、インストールされたPythonバージョンと、各サポートされているPythonメジャーバージョンの最新のパッチバージョンのダウンロードが表示されます。

Use --managed-python to view only managed Python versions.--managed-pythonを使用して、管理されたPythonバージョンのみを表示します。

Use --no-managed-python to omit managed Python versions.--no-managed-pythonを使用して、管理されたPythonバージョンを省略します。

Use --all-versions to view all available patch versions.--all-versionsを使用して、すべての利用可能なパッチバージョンを表示します。

Use --only-installed to omit available downloads.--only-installedを使用して、利用可能なダウンロードを省略します。

Usage使用法

uv python list [OPTIONS] [REQUEST]

Arguments引数

REQUESTREQUEST

A Python request to filter by.フィルタリングのためのPythonリクエスト。

See uv python to view supported request formats.uv pythonを参照して、サポートされているリクエスト形式を確認してください。

Optionsオプション

--all-arches, --all_architectures--all-arches, --all_architectures

List Python downloads for all architectures.すべてのアーキテクチャのPythonダウンロードをリストします。

By default, only downloads for the current architecture are shown.デフォルトでは、現在のアーキテクチャのダウンロードのみが表示されます。

--all-platforms--all-platforms

List Python downloads for all platforms.すべてのプラットフォームのPythonダウンロードをリストします。

By default, only downloads for the current platform are shown.デフォルトでは、現在のプラットフォームのダウンロードのみが表示されます。

--all-versions--all-versions

List all Python versions, including old patch versions.すべてのPythonバージョンをリスト表示します。古いパッチバージョンも含まれます。

By default, only the latest patch version is shown for each minor version.デフォルトでは、各マイナーバージョンの最新のパッチバージョンのみが表示されます。

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）を受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、検証されたソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数で設定することもできます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvに、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されています。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数を使用して設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末に書き込む際に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力がサポートされている端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.uv.toml ファイルのパスを設定に使用します。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE 環境変数でも設定できます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY 環境変数でも設定できます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します

--managed-python--managed-python

Require use of uv-managed Python versions.uv-managed Python バージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理しているPythonバージョンを使用することを優先します。ただし、uv-managed Pythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON 環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、特にシステムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したい場合があります。

May also be set with the UV_NATIVE_TLS environment variable.環境変数 UV_NATIVE_TLS でも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.環境変数 UV_NO_CACHE でも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル (pyproject.toml, uv.toml) の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.環境変数 UV_NO_CONFIG でも設定できます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.また、UV_NO_MANAGED_PYTHON環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.また、UV_NO_PROGRESS環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.また、UV_OFFLINE 環境変数で設定することもできます。

--only-downloads--only-downloads

Only show available Python downloads.利用可能なPythonのダウンロードのみを表示します。

By default, installed distributions and available downloads for the current platform are shown.デフォルトでは、インストールされたディストリビューションと現在のプラットフォームで利用可能なダウンロードが表示されます。

--only-installed--only-installed

Only show installed Python versions.インストールされたPythonのバージョンのみを表示します。

By default, installed distributions and available downloads for the current platform are shown.デフォルトでは、インストールされたディストリビューションと現在のプラットフォームで利用可能なダウンロードが表示されます。

--output-format output-format--output-format output-format

Select the output format出力形式を選択します

[default: text][default: text]

Possible values:可能な値：

text: Plain text (for humans)text: プレーンテキスト（人間用）
json: JSON (for computers)json: JSON（コンピュータ用）

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見され、プロジェクトの仮想環境（.venv）も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.また、UV_PROJECT 環境変数で設定することもできます。

--python-downloads-json-url python-downloads-json-url--python-downloads-json-url python-downloads-json-url

URL pointing to JSON of custom Python installationsカスタム Python インストールの JSON を指す URL

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uv が stdout に出力を行わないサイレントモードを有効にします。

--show-urls--show-urls

Show the URLs of available Python downloads.利用可能な Python ダウンロードの URL を表示します。

By default, these display as <download available>.デフォルトでは、これらは <download available> として表示されます。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)環境変数 RUST_LOG を使用して、詳細なログ記録を構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv python installuv python install

Download and install Python versions.Pythonのバージョンをダウンロードしてインストールします。

Supports CPython and PyPy. CPython distributions are downloaded from the Astral python-build-standalone project. PyPy distributions are downloaded from python.org. The available Python versions are bundled with each uv release. To install new Python versions, you may need upgrade uv.CPythonとPyPyをサポートしています。CPythonのディストリビューションはAstralの python-build-standalone プロジェクトからダウンロードされます。PyPyのディストリビューションは python.org からダウンロードされます。利用可能なPythonのバージョンは各uvリリースにバンドルされています。新しいPythonのバージョンをインストールするには、uvをアップグレードする必要があります。

Python versions are installed into the uv Python directory, which can be retrieved with uv python dir.Pythonのバージョンは、uv python dir で取得できるuv Pythonディレクトリにインストールされます。

By default, Python executables are added to a directory on the path with a minor version suffix, e.g., python3.13. To install python3 and python, use the --default flag. Use uv python dir --bin to see the target directory.デフォルトでは、Pythonの実行可能ファイルはマイナーバージョンのサフィックスを持つパス上のディレクトリに追加されます。例: python3.13。 python3 と python をインストールするには、--default フラグを使用します。ターゲットディレクトリを確認するには uv python dir --bin を使用します。

Multiple Python versions may be requested.複数のPythonのバージョンをリクエストすることができます。

See uv help python to view supported request formats.サポートされているリクエスト形式を表示するには uv help python を参照してください。

Usage使用法

uv python install [OPTIONS] [TARGETS]...

Arguments引数

TARGETSTARGETS

The Python version(s) to install.インストールするPythonのバージョン。

If not provided, the requested Python version(s) will be read from the UV_PYTHON environment variable then .python-versions or .python-version files. If none of the above are present, uv will check if it has installed any Python versions. If not, it will install the latest stable version of Python.指定されていない場合、要求されたPythonのバージョンはUV_PYTHON環境変数から読み取られ、その後.python-versionsまたは.python-versionファイルから読み取られます。上記のいずれも存在しない場合、uvはインストールされているPythonのバージョンがあるかどうかを確認します。ない場合は、最新の安定版Pythonをインストールします。

See uv python to view supported request formats.uv pythonを参照して、サポートされているリクエスト形式を確認してください。

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正な接続を許可します。

Can be provided multiple times.複数回提供できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告: このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、検証されたソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.デフォルトでは、macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uv、Windowsでは%LOCALAPPDATA%\uv\cacheに設定されています。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行してください。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数でも設定できます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvはターミナルに書き込む際に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力が端末またはTTYに送信される場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用するuv.tomlファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数を使用して設定することもできます。

--default--default

Use as the default Python version.デフォルトのPythonバージョンとして使用します。

By default, only a python{major}.{minor} executable is installed, e.g., python3.10. When the --default flag is used, python{major}, e.g., python3, and python executables are also installed.デフォルトでは、python{major}.{minor} 実行可能ファイルのみがインストールされます。例えば、python3.10 です。--default フラグが使用されると、python{major}（例：python3）および python 実行可能ファイルもインストールされます。

Alternative Python variants will still include their tag. For example, installing 3.13+freethreaded with --default will include in python3t and pythont, not python3 and python.代替のPythonバリアントは、そのタグを含むことになります。例えば、--default を使用して3.13+freethreadedをインストールすると、python3t と pythont が含まれ、python3 と python は含まれません。

If multiple Python versions are requested, uv will exit with an error.複数のPythonバージョンが要求されると、uvはエラーで終了します。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準として解決されます。

See --project to only change the project root directory.--project を参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY 環境変数を使用して設定することもできます。

--force, -f--force, -f

Replace existing Python executables during installation.インストール中に既存のPython実行可能ファイルを置き換えます。

By default, uv will refuse to replace executables that it does not manage.デフォルトでは、uvは管理していない実行可能ファイルの置き換えを拒否します。

Implies --reinstall.--reinstallを含意します。

--help, -h--help、-h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--install-dir, -i install-dir--install-dir、-i install-dir

The directory to store the Python installation in.Pythonインストールを保存するディレクトリです。

If provided, UV_PYTHON_INSTALL_DIR will need to be set for subsequent operations for uv to discover the Python installation.提供された場合、UV_PYTHON_INSTALL_DIRはuvがPythonインストールを発見するための後続の操作に設定する必要があります。

See uv python dir to view the current Python installation directory. Defaults to ~/.local/share/uv/python.uv python dirを参照して現在のPythonインストールディレクトリを表示します。デフォルトは~/.local/share/uv/pythonです。

May also be set with the UV_PYTHON_INSTALL_DIR environment variable.UV_PYTHON_INSTALL_DIR環境変数でも設定できます。

--managed-python--managed-python

Require use of uv-managed Python versions.uvが管理するPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンの使用を優先します。ただし、uvが管理するPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.これは、UV_MANAGED_PYTHON環境変数を使用して設定することもできます。

--mirror mirror--mirror ミラー

Set the URL to use as the source for downloading Python installations.Pythonインストールのダウンロード元として使用するURLを設定します。

The provided URL will replace https://github.com/astral-sh/python-build-standalone/releases/download in, e.g., https://github.com/astral-sh/python-build-standalone/releases/download/20240713/cpython-3.12.4%2B20240713-aarch64-apple-darwin-install_only.tar.gz.提供されたURLは、例えば、https://github.com/astral-sh/python-build-standalone/releases/downloadの部分を置き換えます。例：https://github.com/astral-sh/python-build-standalone/releases/download/20240713/cpython-3.12.4%2B20240713-aarch64-apple-darwin-install_only.tar.gz。

Distributions can be read from a local directory by using the file:// URL scheme.配布物は、file:// URLスキームを使用してローカルディレクトリから読み取ることができます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、いくつかのケースでは、プラットフォームのネイティブ証明書ストアを使用したい場合があります。特に、システムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合です。

May also be set with the UV_NATIVE_TLS environment variable.また、UV_NATIVE_TLS 環境変数で設定することもできます。

--no-bin--no-bin

Do not install a Python executable into the bin directory.bin ディレクトリに Python 実行可能ファイルをインストールしないでください。

This can also be set with UV_PYTHON_INSTALL_BIN=0.これも UV_PYTHON_INSTALL_BIN=0 で設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の期間中は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.また、UV_NO_CACHE 環境変数で設定することもできます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).pyproject.toml や uv.toml のような設定ファイルの発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.また、UV_NO_CONFIG 環境変数で設定することもできます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv-managed Python バージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.また、UV_NO_MANAGED_PYTHON 環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.また、UV_NO_PROGRESS 環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--no-registry--no-registry

Do not register the Python installation in the Windows registry.PythonのインストールをWindowsレジストリに登録しません。

This can also be set with UV_PYTHON_INSTALL_REGISTRY=0.これは UV_PYTHON_INSTALL_REGISTRY=0 で設定することもできます。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数でも設定できます。

--project project--project project

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用される場合には効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数を使用して設定することもできます。

--pypy-mirror pypy-mirror--pypy-mirror pypy-mirror

Set the URL to use as the source for downloading PyPy installations.PyPy インストールをダウンロードするためのソースとして使用する URL を設定します。

The provided URL will replace https://downloads.python.org/pypy in, e.g., https://downloads.python.org/pypy/pypy3.8-v7.3.7-osx64.tar.bz2.提供された URL は、例えば https://downloads.python.org/pypy/pypy3.8-v7.3.7-osx64.tar.bz2 の https://downloads.python.org/pypy を置き換えます。

Distributions can be read from a local directory by using the file:// URL scheme.配布物は、file:// URL スキームを使用してローカルディレクトリから読み取ることができます。

--python-downloads-json-url python-downloads-json-url--python-downloads-json-url python-downloads-json-url

URL pointing to JSON of custom Python installationsカスタムPythonインストールのJSONを指すURL

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uvは標準出力に何も出力しないサイレントモードを有効にします。

--reinstall, -r--reinstall, -r

Reinstall the requested Python version, if it's already installed.要求されたPythonバージョンを再インストールします。すでにインストールされている場合。

By default, uv will exit successfully if the version is already installed.デフォルトでは、uvはバージョンがすでにインストールされている場合、正常に終了します。

--upgrade, -U--upgrade, -U

Upgrade existing Python installations to the latest patch version.既存のPythonインストールを最新のパッチバージョンにアップグレードします。

By default, uv will not upgrade already-installed Python versions to newer patch releases. With --upgrade, uv will upgrade to the latest available patch version for the specified minor version(s).デフォルトでは、uvは既にインストールされているPythonのバージョンを新しいパッチリリースにアップグレードしません。--upgradeを使用すると、uvは指定されたマイナーバージョンの最新のパッチバージョンにアップグレードします。

If the requested versions are not yet installed, uv will install them.要求されたバージョンがまだインストールされていない場合、uvはそれらをインストールします。

This option is only supported for minor version requests, e.g., 3.12; uv will exit with an error if a patch version, e.g., 3.12.2, is requested.このオプションはマイナーバージョンのリクエストのみサポートされています。例えば、3.12のように; パッチバージョン、例えば3.12.2が要求された場合、uvはエラーで終了します。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)RUST_LOG環境変数を使用して、詳細なロギングを構成できます。(https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv python upgradeuv python upgrade

Upgrade installed Python versions.インストールされたPythonのバージョンをアップグレードします。

Upgrades versions to the latest supported patch release. Requires the python-upgrade preview feature.バージョンを最新のサポートされているパッチリリースにアップグレードします。python-upgradeプレビュー機能が必要です。

A target Python minor version to upgrade may be provided, e.g., 3.13. Multiple versions may be provided to perform more than one upgrade.アップグレードするターゲットPythonマイナーバージョンを指定できます。例えば、3.13のように。複数のバージョンを指定して、複数のアップグレードを実行できます。

If no target version is provided, then uv will upgrade all managed CPython versions.ターゲットバージョンが指定されていない場合、uvはすべての管理されたCPythonバージョンをアップグレードします。

During an upgrade, uv will not uninstall outdated patch versions.アップグレード中、uvは古いパッチバージョンをアンインストールしません。

When an upgrade is performed, virtual environments created by uv will automatically use the new version. However, if the virtual environment was created before the upgrade functionality was added, it will continue to use the old Python version; to enable upgrades, the environment must be recreated.アップグレードが行われると、uvによって作成された仮想環境は自動的に新しいバージョンを使用します。ただし、アップグレード機能が追加される前に作成された仮想環境は古いPythonバージョンを使用し続けます。アップグレードを有効にするには、環境を再作成する必要があります。

Upgrades are not yet supported for alternative implementations, like PyPy.PyPyのような代替実装のアップグレードはまだサポートされていません。

Usage使用法

uv python upgrade [OPTIONS] [TARGETS]...

Arguments引数

TARGETSTARGETS

The Python minor version(s) to upgrade.アップグレードするPythonのマイナーバージョン。

If no target version is provided, then uv will upgrade all managed CPython versions.ターゲットバージョンが指定されていない場合、uvはすべての管理されたCPythonバージョンをアップグレードします。

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの安全でない接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvに、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されています。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行してください。

May also be set with the UV_CACHE_DIR environment variable.環境変数 UV_CACHE_DIR でも設定できます。

--color color-choice--color color-choice

Control the use of color in output.出力の色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末に書き込む際に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力がサポートされている端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用する uv.toml ファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uv設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数で設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数で設定することもできます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--install-dir, -i install-dir--install-dir, -i install-dir

The directory Python installations are stored in.Pythonインストールが保存されているディレクトリです。

If provided, UV_PYTHON_INSTALL_DIR will need to be set for subsequent operations for uv to discover the Python installation.指定された場合、UV_PYTHON_INSTALL_DIRはuvがPythonインストールを発見するための後続の操作に設定する必要があります。

See uv python dir to view the current Python installation directory. Defaults to ~/.local/share/uv/python.uv python dirを参照して現在のPythonインストールディレクトリを表示します。デフォルトは~/.local/share/uv/pythonです。

May also be set with the UV_PYTHON_INSTALL_DIR environment variable.UV_PYTHON_INSTALL_DIR環境変数でも設定できます。

--managed-python--managed-python

Require use of uv-managed Python versions.uv管理のPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理しているPythonバージョンの使用を優先します。ただし、uv管理のPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションはシステムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数でも設定できます。

--mirror mirror--mirror mirror

Set the URL to use as the source for downloading Python installations.Pythonインストールをダウンロードするためのソースとして使用するURLを設定します。

The provided URL will replace https://github.com/astral-sh/python-build-standalone/releases/download in, e.g., https://github.com/astral-sh/python-build-standalone/releases/download/20240713/cpython-3.12.4%2B20240713-aarch64-apple-darwin-install_only.tar.gz.提供されたURLは、例えば、https://github.com/astral-sh/python-build-standalone/releases/downloadの代わりになります。https://github.com/astral-sh/python-build-standalone/releases/download/20240713/cpython-3.12.4%2B20240713-aarch64-apple-darwin-install_only.tar.gz。

Distributions can be read from a local directory by using the file:// URL scheme.ディストリビューションは、file:// URLスキームを使用してローカルディレクトリから読み取ることができます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、特にシステムの証明書ストアに含まれる企業の信頼ルート（例えば、必須プロキシのため）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したいことがあります。

May also be set with the UV_NATIVE_TLS environment variable.UV_NATIVE_TLS環境変数でも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の期間中は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.UV_NO_CACHE環境変数でも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml、uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.UV_NO_CONFIG 環境変数で設定することもできます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON 環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバー。

May also be set with the UV_NO_PROGRESS environment variable.環境変数 UV_NO_PROGRESS で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.環境変数 UV_OFFLINE で設定することもできます。

--project project--project project

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトのルートからディレクトリツリーを上に移動することで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更できます。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数を使用して設定することもできます。

--pypy-mirror pypy-mirror--pypy-mirror pypy-mirror

Set the URL to use as the source for downloading PyPy installations.PyPy インストールのダウンロード元として使用する URL を設定します。

The provided URL will replace https://downloads.python.org/pypy in, e.g., https://downloads.python.org/pypy/pypy3.8-v7.3.7-osx64.tar.bz2.提供された URL は、例えば https://downloads.python.org/pypy/pypy3.8-v7.3.7-osx64.tar.bz2 の https://downloads.python.org/pypy を置き換えます。

Distributions can be read from a local directory by using the file:// URL scheme.配布物は、file:// URL スキームを使用してローカルディレクトリから読み取ることができます。

--python-downloads-json-url python-downloads-json-url--python-downloads-json-url python-downloads-json-url

URL pointing to JSON of custom Python installationsカスタムPythonインストールのJSONを指すURL

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すと、例えば-qqのように、uvはstdoutに出力を行わないサイレントモードが有効になります。

--reinstall, -r--reinstall, -r

Reinstall the latest Python patch, if it's already installed.最新のPythonパッチを再インストールします。すでにインストールされている場合。

By default, uv will exit successfully if the latest patch is already installed.デフォルトでは、最新のパッチがすでにインストールされている場合、uvは正常に終了します。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)細かいログ設定はRUST_LOG環境変数を使用して構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv python finduv python find

Search for a Python installation.Pythonのインストールを検索します。

Displays the path to the Python executable.Python実行ファイルへのパスを表示します。

See uv help python to view supported request formats and details on discovery behavior.uv help pythonを参照して、サポートされているリクエスト形式と発見動作の詳細を確認してください。

Usage使用法

uv python find [OPTIONS] [REQUEST]

Arguments引数

REQUESTREQUEST

The Python request.Pythonリクエスト。

See uv python to view supported request formats.uv pythonを参照して、サポートされているリクエスト形式を確認してください。

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、検証済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvに、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されています。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行してください。

May also be set with the UV_CACHE_DIR environment variable.環境変数 UV_CACHE_DIR で設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力の色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末への書き込み時に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力がサポートされている端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用する uv.toml ファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uv設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数で設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数で設定することもできます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--managed-python--managed-python

Require use of uv-managed Python versions.uvが管理するPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンの使用を優先します。ただし、uvが管理するPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンス（特にmacOSで）が向上します。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、特にシステムの証明書ストアに含まれる企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したい場合があります。

May also be set with the UV_NATIVE_TLS environment variable.UV_NATIVE_TLS環境変数でも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りまたは書き込みを避け、操作の期間中は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.環境変数 UV_NO_CACHE でも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml, uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.環境変数 UV_NO_CONFIG でも設定できます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.環境変数 UV_NO_MANAGED_PYTHON でも設定できます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS 環境変数で設定することもできます。

--no-project, --no_workspace--no-project, --no_workspace

Avoid discovering a project or workspace.プロジェクトまたはワークスペースの発見を避けます。

Otherwise, when no request is provided, the Python requirement of a project in the current directory or parent directories will be used.そうでない場合、リクエストが提供されていないときは、現在のディレクトリまたは親ディレクトリにあるプロジェクトのPython要件が使用されます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数で設定することもできます。

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に歩いて発見され、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用されると効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数で設定することもできます。

--python-downloads-json-url python-downloads-json-url--python-downloads-json-url python-downloads-json-url

URL pointing to JSON of custom Python installationsカスタムPythonインストールのJSONを指すURL

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uvがstdoutに出力を行わないサイレントモードを有効にします。

--script script--script script

Find the environment for a Python script, rather than the current project現在のプロジェクトではなく、Pythonスクリプトの環境を見つけます。

--show-version--show-version

Show the Python version that would be used instead of the path to the interpreterインタープリタへのパスの代わりに使用されるPythonのバージョンを表示します。

--system--system

Only find system Python interpreters.システムPythonインタープリタのみを見つけます。

By default, uv will report the first Python interpreter it would use, including those in an active virtual environment or a virtual environment in the current working directory or any parent directory.デフォルトでは、uvは使用する最初のPythonインタープリタを報告します。これには、アクティブな仮想環境や現在の作業ディレクトリまたは親ディレクトリにある仮想環境が含まれます。

The --system option instructs uv to skip virtual environment Python interpreters and restrict its search to the system path.この--systemオプションは、uvに仮想環境のPythonインタープリタをスキップさせ、システムパスのみに検索を制限するよう指示します。

May also be set with the UV_SYSTEM_PYTHON environment variable.UV_SYSTEM_PYTHON環境変数を使用して設定することもできます。

--verbose, -v--verbose、-v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)RUST_LOG環境変数を使用して、詳細なロギングを構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv python pinuv python pin

Pin to a specific Python version.特定のPythonバージョンに固定します。

Writes the pinned Python version to a .python-version file, which is used by other uv commands to determine the required Python version.固定されたPythonバージョンを.python-versionファイルに書き込みます。このファイルは、他のuvコマンドが必要なPythonバージョンを決定するために使用されます。

If no version is provided, uv will look for an existing .python-version file and display the currently pinned version. If no .python-version file is found, uv will exit with an error.バージョンが提供されていない場合、uvは既存の.python-versionファイルを探し、現在の固定バージョンを表示します。.python-versionファイルが見つからない場合、uvはエラーで終了します。

See uv help python to view supported request formats.サポートされているリクエストフォーマットを表示するには uv help python を参照してください。

Usage使用法

uv python pin [OPTIONS] [REQUEST]

Arguments引数

REQUESTREQUEST

The Python version request.Pythonバージョンリクエスト。

uv supports more formats than other tools that read .python-version files, i.e., pyenv. If compatibility with those tools is needed, only use version numbers instead of complex requests such as cpython@3.10.uvは、.python-versionファイルを読み取る他のツール、つまりpyenvよりも多くのフォーマットをサポートしています。これらのツールとの互換性が必要な場合は、cpython@3.10のような複雑なリクエストの代わりに、バージョン番号のみを使用してください。

If no request is provided, the currently pinned version will be shown.リクエストが提供されていない場合、現在ピン留めされているバージョンが表示されます。

See uv python to view supported request formats.サポートされているリクエストフォーマットを表示するには uv python を参照してください。

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数で設定することもできます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvに、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されています。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数で設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末への書き込み時に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力がサポートされている端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用するuv.tomlファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.環境変数 UV_CONFIG_FILE でも設定できます。

--directory directory--directory ディレクトリ

Change to the given directory prior to running the command.コマンドを実行する前に指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--project を参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.環境変数 UV_WORKING_DIRECTORY でも設定できます。

--global--global

Update the global Python version pin.グローバルなPythonバージョンピンを更新します。

Writes the pinned Python version to a .python-version file in the uv user configuration directory: XDG_CONFIG_HOME/uv on Linux/macOS and %APPDATA%/uv on Windows.ピン留めされたPythonバージョンを、uvユーザー設定ディレクトリの .python-version ファイルに書き込みます: Linux/macOSでは XDG_CONFIG_HOME/uv、Windowsでは %APPDATA%/uv です。

When a local Python version pin is not found in the working directory or an ancestor directory, this version will be used instead.作業ディレクトリまたはその祖先ディレクトリにローカルPythonバージョンピンが見つからない場合、このバージョンが代わりに使用されます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します

--managed-python--managed-python

Require use of uv-managed Python versions.uv-managed Python バージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンを使用することを好みます。ただし、uv-managed Pythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON 環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、特にシステムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したい場合があります。

May also be set with the UV_NATIVE_TLS environment variable.環境変数 UV_NATIVE_TLS でも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.環境変数 UV_NO_CACHE でも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml, uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.環境変数 UV_NO_CONFIG でも設定できます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.また、UV_NO_MANAGED_PYTHON環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.また、UV_NO_PROGRESS環境変数で設定することもできます。

--no-project, --no-workspace--no-project、--no-workspace

Avoid validating the Python pin is compatible with the project or workspace.Pythonピンがプロジェクトまたはワークスペースと互換性があるかどうかの検証を避けます。

By default, a project or workspace is discovered in the current directory or any parent directory. If a workspace is found, the Python pin is validated against the workspace's requires-python constraint.デフォルトでは、プロジェクトまたはワークスペースは現在のディレクトリまたは親ディレクトリ内で発見されます。ワークスペースが見つかった場合、Pythonピンはワークスペースのrequires-python制約に対して検証されます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数を使用して設定することもできます。

--project project--project project

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に歩いて発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数でも設定できます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uvがstdoutに出力しないサイレントモードが有効になります。

--resolved--resolved

Write the resolved Python interpreter path instead of the request.リクエストの代わりに解決されたPythonインタープリタのパスを書き込みます。

Ensures that the exact same interpreter is used.同じインタープリタが使用されることを保証します。

This option is usually not safe to use when committing the .python-version file to version control.このオプションは、通常、.python-version ファイルをバージョン管理にコミットする際には安全ではありません。

--rm--rm

Remove the Python version pinPythonのバージョンピンを削除する

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)細かいログ記録は、RUST_LOG環境変数を使用して構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv python diruv python dir

Show the uv Python installation directory.uv Pythonのインストールディレクトリを表示します。

By default, Python installations are stored in the uv data directory at $XDG_DATA_HOME/uv/python or $HOME/.local/share/uv/python on Unix and %APPDATA%\uv\data\python on Windows.デフォルトでは、Pythonのインストールは、Unixでは$XDG_DATA_HOME/uv/pythonまたは$HOME/.local/share/uv/pythonに、Windowsでは%APPDATA%\uv\data\pythonに保存されます。

The Python installation directory may be overridden with $UV_PYTHON_INSTALL_DIR.Pythonのインストールディレクトリは$UV_PYTHON_INSTALL_DIRで上書きできます。

To view the directory where uv installs Python executables instead, use the --bin flag. The Python executable directory may be overridden with $UV_PYTHON_BIN_DIR. Note that Python executables are only installed when preview mode is enabled.代わりにuvがPython実行可能ファイルをインストールするディレクトリを表示するには、--binフラグを使用します。Python実行可能ファイルのディレクトリは$UV_PYTHON_BIN_DIRで上書きできます。Python実行可能ファイルはプレビューモードが有効な場合にのみインストールされることに注意してください。

Usage使用法

uv python dir [OPTIONS]

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例: localhost）、ホスト-ポートペア（例: localhost:8080）、またはURL（例: https://localhost）のいずれかを受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告: このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--bin--bin

Show the directory into which uv python will install Python executables.uv pythonがPython実行可能ファイルをインストールするディレクトリを表示します。

Note that this directory is only used when installing Python with preview mode enabled.このディレクトリは、プレビューモードが有効なときにのみPythonをインストールする際に使用されることに注意してください。

The Python executable directory is determined according to the XDG standard and is derived from the following environment variables, in order of preference:Pythonの実行可能ファイルのディレクトリはXDG標準に従って決定され、以下の環境変数から優先順位に従って導出されます：

$UV_PYTHON_BIN_DIR$UV_PYTHON_BIN_DIR
$XDG_BIN_HOME$XDG_BIN_HOME
$XDG_DATA_HOME/../bin$XDG_DATA_HOME/../bin
$HOME/.local/bin$HOME/.local/bin

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvにデフォルト設定され、Windowsでは%LOCALAPPDATA%\uv\cacheに設定されます。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数を使用して設定することもできます。

--color color-choice--color 色の選択

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末への書き込み時に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力がサポートされている端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file 設定ファイル

The path to a uv.toml file to use for configuration.設定に使用するuv.tomlファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.また、UV_CONFIG_FILE 環境変数で設定することもできます。

--directory directory--directory ディレクトリ

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--project を参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.また、UV_WORKING_DIRECTORY 環境変数で設定することもできます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--managed-python--managed-python

Require use of uv-managed Python versions.uv-managed Python バージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理しているPythonバージョンを使用することを好みます。ただし、uvが管理しているPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.また、UV_MANAGED_PYTHON環境変数で設定することもできます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、特にシステムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したいことがあります。

May also be set with the UV_NATIVE_TLS environment variable.また、UV_NATIVE_TLS環境変数で設定することもできます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の期間中は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.また、UV_NO_CACHE環境変数で設定することもできます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml、uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.UV_NO_CONFIG 環境変数で設定することもできます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON 環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバー。

May also be set with the UV_NO_PROGRESS environment variable.環境変数 UV_NO_PROGRESS で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.環境変数 UV_OFFLINE で設定することもできます。

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に歩いていくことで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更できます。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数を使用して設定することもできます。

--quiet, -q--quiet、-q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uv が stdout に出力しないサイレントモードを有効にします。

--verbose, -v--verbose、-v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)細かいログ設定は、RUST_LOG 環境変数を使用して構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv python uninstalluv python uninstall

Uninstall Python versionsPython バージョンのアンインストール

Usage使用法

uv python uninstall [OPTIONS] <TARGETS>...

Arguments引数

TARGETSTARGETS

The Python version(s) to uninstall.アンインストールする Python バージョン。

See uv python to view supported request formats.uv python を参照して、サポートされているリクエスト形式を確認してください。

Optionsオプション

--all--all

Uninstall all managed Python versions管理されたすべてのPythonバージョンをアンインストールする

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）を受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、検証されたソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvにデフォルト設定され、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されます。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数で設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末に書き込む際に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力がサポートされている端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.uv.tomlファイルの設定に使用するパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.pyproject.tomlファイルにuvの設定を含めることはできますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数で設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数で設定することもできます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します

--install-dir, -i install-dir--install-dir, -i install-dir

The directory where the Python was installedPythonがインストールされたディレクトリ

May also be set with the UV_PYTHON_INSTALL_DIR environment variable.UV_PYTHON_INSTALL_DIR 環境変数で設定することもできます。

--managed-python--managed-python

Require use of uv-managed Python versions.uv-managed Pythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理しているPythonバージョンを使用することを好みます。ただし、uv-managed Pythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON 環境変数で設定することもできます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートセットであり、これをuvに含めることでポータビリティとパフォーマンス（特にmacOSで）が向上します。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、いくつかのケースでは、プラットフォームのネイティブ証明書ストアを使用したい場合があります。特に、システムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合です。

May also be set with the UV_NATIVE_TLS environment variable.また、UV_NATIVE_TLS 環境変数で設定することもできます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の期間中は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.また、UV_NO_CACHE 環境変数で設定することもできます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml, uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.また、UV_NO_CONFIG 環境変数で設定することもできます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.その代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数でも設定できます。

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に辿ることで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.作業ディレクトリを完全に変更するには --directory を参照してください。

This setting has no effect when used in the uv pip interface.この設定は uv pip インターフェースで使用されると効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数でも設定できます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すと、例えば -qq のように、uvは標準出力に何も出力しないサイレントモードを有効にします。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)細かいログ記録は、RUST_LOG 環境変数を使用して設定できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv python update-shelluv python update-shell

Ensure that the Python executable directory is on the PATH.Python実行可能ファイルのディレクトリが PATH に含まれていることを確認してください。

If the Python executable directory is not present on the PATH, uv will attempt to add it to the relevant shell configuration files.Python実行可能ファイルのディレクトリが PATH に存在しない場合、uvは関連するシェル設定ファイルに追加しようとします。

If the shell configuration files already include a blurb to add the executable directory to the path, but the directory is not present on the PATH, uv will exit with an error.シェル設定ファイルに実行可能ディレクトリをパスに追加するための記述が既に含まれているが、ディレクトリが PATH に存在しない場合、uvはエラーで終了します。

The Python executable directory is determined according to the XDG standard and can be retrieved with uv python dir --bin.Pythonの実行可能ファイルのディレクトリはXDG標準に従って決定され、uv python dir --binで取得できます。

Usage使用法

uv python update-shell [OPTIONS]

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告: このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、検証されたソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvに、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されています。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数を使用して設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvはターミナルに書き込む際に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力が色のサポートを持つターミナルまたはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.uv.toml ファイルのパスを設定に使用します。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定は pyproject.toml ファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE 環境変数で設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--project を参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY 環境変数で設定することもできます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します

--managed-python--managed-python

Require use of uv-managed Python versions.uv-managed Python バージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理しているPythonバージョンを使用することを好みます。ただし、uv-managed Pythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON 環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンス（特にmacOSで）が向上します。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、特にシステムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したいことがあります。

May also be set with the UV_NATIVE_TLS environment variable.環境変数 UV_NATIVE_TLS でも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.環境変数 UV_NO_CACHE でも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル (pyproject.toml, uv.toml) の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.環境変数 UV_NO_CONFIG でも設定できます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.また、UV_NO_MANAGED_PYTHON環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.また、UV_NO_PROGRESS環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.これは、UV_OFFLINE 環境変数を使用して設定することもできます。

--project project--project project

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見され、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.これは、UV_PROJECT 環境変数を使用して設定することもできます。

--quiet, -q--quiet、-q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uvがstdoutに出力を行わないサイレントモードを有効にします。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)RUST_LOG 環境変数を使用して、細かいログ設定を行うことができます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv pipuv pip

Manage Python packages with a pip-compatible interfacepip互換のインターフェースでPythonパッケージを管理します。

Usage使用法

uv pip [OPTIONS] <COMMAND>

Commandsコマンド

uv pip compileuv pip compile: Compile a requirements.in file to a requirements.txt or pylock.toml filerequirements.in ファイルを requirements.txt または pylock.toml ファイルにコンパイルします
uv pip syncuv pip sync: Sync an environment with a requirements.txt or pylock.toml filerequirements.txt または pylock.toml ファイルで環境を同期します
uv pip installuv pip install: Install packages into an environment環境にパッケージをインストールします
uv pip uninstalluv pip uninstall: Uninstall packages from an environment環境からパッケージをアンインストールします
uv pip freezeuv pip freeze: List, in requirements format, packages installed in an environment環境にインストールされたパッケージを要求形式でリストします
uv pip listuv pip list: List, in tabular format, packages installed in an environment環境にインストールされたパッケージを表形式で一覧表示します
uv pip showuv pip show: Show information about one or more installed packagesインストールされたパッケージの情報を表示します
uv pip treeuv pip tree: Display the dependency tree for an environment環境の依存関係ツリーを表示します
uv pip checkuv pip check: Verify installed packages have compatible dependenciesインストールされたパッケージが互換性のある依存関係を持っているか確認します

uv pip compileuv pip compile

Compile a requirements.in file to a requirements.txt or pylock.toml filerequirements.inファイルをrequirements.txtまたはpylock.tomlファイルにコンパイルします

Usage使用法

uv pip compile [OPTIONS] <SRC_FILE|--group <GROUP>>

Arguments引数

SRC_FILESRC_FILE

Include the packages listed in the given files.指定されたファイルにリストされたパッケージを含めます。

The following formats are supported: requirements.txt, .py files with inline metadata, pylock.toml, pyproject.toml, setup.py, and setup.cfg.サポートされているフォーマットは次の通りです: requirements.txt、.py ファイルのインラインメタデータ、pylock.toml、pyproject.toml、setup.py、および setup.cfg。

If a pyproject.toml, setup.py, or setup.cfg file is provided, uv will extract the requirements for the relevant project.pyproject.toml、setup.py、または setup.cfg ファイルが提供されている場合、uvは関連するプロジェクトの要件を抽出します。

If - is provided, then requirements will be read from stdin.- が提供されている場合、要件はstdinから読み取られます。

The order of the requirements files and the requirements in them is used to determine priority during resolution.要件ファイルの順序とその中の要件は、解決時の優先順位を決定するために使用されます。

Optionsオプション

--all-extras--all-extras

Include all optional dependencies.すべてのオプション依存関係を含めます。

Only applies to pyproject.toml, setup.py, and setup.cfg sources.これは pyproject.toml、setup.py、および setup.cfg ソースにのみ適用されます。

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host、--trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回提供することができます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、検証されたソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST 環境変数でも設定できます。

--annotation-style annotation-style--annotation-style annotation-style

The style of the annotation comments included in the output file, used to indicate the source of each package.出力ファイルに含まれる注釈コメントのスタイルで、各パッケージのソースを示すために使用されます。

Defaults to split.デフォルトは split です。

Possible values:可能な値：

line: Render the annotations on a single, comma-separated lineline: 注釈を単一のカンマ区切りの行にレンダリングします
split: Render each annotation on its own linesplit: 各注釈を独自の行にレンダリングします

--build-constraints, --build-constraint, -b build-constraints--build-constraints, --build-constraint, -b build-constraints

Constrain build dependencies using the given requirements files when building source distributions.ソース配布物をビルドする際に、指定された要件ファイルを使用してビルド依存関係を制約します。

Constraints files are requirements.txt-like files that only control the version of a requirement that's installed. However, including a package in a constraints file will not trigger the installation of that package.制約ファイルは、インストールされる要件のバージョンのみを制御するrequirements.txtのようなファイルです。ただし、制約ファイルにパッケージを含めても、そのパッケージのインストールはトリガーされません。

May also be set with the UV_BUILD_CONSTRAINT environment variable.UV_BUILD_CONSTRAINT環境変数を使用して設定することもできます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvに、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されています。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数を使用して設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力の色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvはターミナルに書き込む際に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: ターミナルまたはサポートのあるTTYに出力される場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.uv.tomlファイルのパスを設定に使用します。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数で設定することもできます。

--config-setting, --config-settings, -C config-setting--config-setting, --config-settings, -C config-setting

Settings to pass to the PEP 517 build backend, specified as KEY=VALUE pairsPEP 517ビルドバックエンドに渡す設定で、KEY=VALUEペアとして指定します。

--config-settings-package, --config-settings-package config-settings-package--config-settings-package, --config-settings-package config-settings-package

Settings to pass to the PEP 517 build backend for a specific package, specified as PACKAGE:KEY=VALUE pairs特定のパッケージに対してPEP 517ビルドバックエンドに渡す設定で、PACKAGE:KEY=VALUEペアとして指定します。

--constraints, --constraint, -c constraints--constraints, --constraint, -c constraints

Constrain versions using the given requirements files.指定された要件ファイルを使用してバージョンを制約します。

Constraints files are requirements.txt-like files that only control the version of a requirement that's installed. However, including a package in a constraints file will not trigger the installation of that package.制約ファイルはrequirements.txtのようなファイルで、インストールされる要件のバージョンのみを制御します。ただし、制約ファイルにパッケージを含めても、そのパッケージのインストールはトリガーされません。

This is equivalent to pip's --constraint option.これはpipの--constraintオプションと同等です。

May also be set with the UV_CONSTRAINT environment variable.UV_CONSTRAINT環境変数を使用して設定することもできます。

--custom-compile-command custom-compile-command--custom-compile-command custom-compile-command

The header comment to include at the top of the output file generated by uv pip compile.uv pip compileによって生成される出力ファイルの先頭に含めるヘッダーコメント。

Used to reflect custom build scripts and commands that wrap uv pip compile.uv pip compileをラップするカスタムビルドスクリプトやコマンドを反映するために使用されます。

May also be set with the UV_CUSTOM_COMPILE_COMMAND environment variable.UV_CUSTOM_COMPILE_COMMAND環境変数を使用して設定することもできます。

--default-index default-index--default-index default-index

The URL of the default package index (by default: https://pypi.org/simple).デフォルトのパッケージインデックスのURL（デフォルトでは: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --index flag.このフラグで指定されたインデックスは、--indexフラグで指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_DEFAULT_INDEX environment variable.環境変数 UV_DEFAULT_INDEX でも設定できます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--project を参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.環境変数 UV_WORKING_DIRECTORY でも設定できます。

--emit-build-options--emit-build-options

Include --no-binary and --only-binary entries in the generated output file生成された出力ファイルに --no-binary と --only-binary のエントリを含めます。

--emit-find-links--emit-find-links

Include --find-links entries in the generated output file生成された出力ファイルに --find-links のエントリを含めます。

--emit-index-annotation--emit-index-annotation

Include comment annotations indicating the index used to resolve each package (e.g., # from https://pypi.org/simple)各パッケージを解決するために使用されるインデックスを示すコメント注釈を含めます（例：# from https://pypi.org/simple）

--emit-index-url--emit-index-url

Include --index-url and --extra-index-url entries in the generated output file生成された出力ファイルに--index-urlおよび--extra-index-urlエントリを含めます

--exclude-newer exclude-newer--exclude-newer exclude-newer

Limit candidate packages to those that were uploaded prior to the given date.候補パッケージを指定された日付以前にアップロードされたものに制限します。

Accepts both RFC 3339 timestamps (e.g., 2006-12-02T02:07:43Z) and local dates in the same format (e.g., 2006-12-02) in your system's configured time zone.RFC 3339 タイムスタンプ（例：2006-12-02T02:07:43Z）およびシステムの設定されたタイムゾーンでの同じ形式のローカル日付（例：2006-12-02）の両方を受け入れます。

May also be set with the UV_EXCLUDE_NEWER environment variable.UV_EXCLUDE_NEWER 環境変数で設定することもできます。

--exclude-newer-package exclude-newer-package--exclude-newer-package exclude-newer-package

Limit candidate packages for a specific package to those that were uploaded prior to the given date.特定のパッケージの候補パッケージを指定された日付以前にアップロードされたものに制限します。

Accepts package-date pairs in the format PACKAGE=DATE, where DATE is an RFC 3339 timestamp (e.g., 2006-12-02T02:07:43Z) or local date (e.g., 2006-12-02) in your system's configured time zone.パッケージ-日付ペアをPACKAGE=DATEの形式で受け入れます。ここで、DATEはRFC 3339タイムスタンプ（例：2006-12-02T02:07:43Z）またはローカル日付（例：2006-12-02）であり、システムの設定されたタイムゾーンに基づいています。

Can be provided multiple times for different packages.異なるパッケージに対して複数回提供できます。

--excludes, --exclude excludes--excludes、--exclude excludes

Exclude packages from resolution using the given requirements files.指定された要件ファイルを使用して、解決からパッケージを除外します。

Excludes files are requirements.txt-like files that specify packages to exclude from the resolution. When a package is excluded, it will be omitted from the dependency list entirely and its own dependencies will be ignored during the resolution phase. Excludes are unconditional in that requirement specifiers and markers are ignored; any package listed in the provided file will be omitted from all resolved environments.除外ファイルは、解決から除外するパッケージを指定するrequirements.txtのようなファイルです。パッケージが除外されると、その依存関係リストから完全に省かれ、解決フェーズ中にその依存関係は無視されます。除外は無条件であり、要件指定子やマーカーは無視されます。提供されたファイルにリストされたパッケージは、すべての解決された環境から省かれます。

May also be set with the UV_EXCLUDE environment variable.また、UV_EXCLUDE環境変数で設定することもできます。

--extra extra--extra extra

Include optional dependencies from the specified extra name; may be provided more than once.指定された追加名からオプションの依存関係を含めます。複数回提供することができます。

Only applies to pyproject.toml, setup.py, and setup.cfg sources.これはpyproject.toml、setup.py、およびsetup.cfgソースにのみ適用されます。

--extra-index-url extra-index-url--extra-index-url extra-index-url

(Deprecated: use --index instead) Extra URLs of package indexes to use, in addition to --index-url.(非推奨: 代わりに --index を使用してください) --index-url に加えて使用するパッケージインデックスの追加URL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --index-url (which defaults to PyPI). When multiple --extra-index-url flags are provided, earlier values take priority.このフラグを介して提供されたすべてのインデックスは、--index-url（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の --extra-index-url フラグが提供される場合、早い値が優先されます。

May also be set with the UV_EXTRA_INDEX_URL environment variable.UV_EXTRA_INDEX_URL 環境変数を使用して設定することもできます。

--find-links, -f find-links--find-links, -f find-links

Locations to search for candidate distributions, in addition to those found in the registry indexes.レジストリインデックスで見つかったものに加えて、候補の配布物を検索する場所。

If a path, the target must be a directory that contains packages as wheel files (.whl) or source distributions (e.g., .tar.gz or .zip) at the top level.パスの場合、ターゲットはトップレベルにホイールファイル（.whl）またはソース配布（例: .tar.gz または .zip）を含むディレクトリでなければなりません。

If a URL, the page must contain a flat list of links to package files adhering to the formats described above.URLの場合、ページは上記の形式に従ったパッケージファイルへのリンクのフラットリストを含む必要があります。

May also be set with the UV_FIND_LINKS environment variable.UV_FIND_LINKS 環境変数を使用して設定することもできます。

--fork-strategy fork-strategy--fork-strategy fork-strategy

The strategy to use when selecting multiple versions of a given package across Python versions and platforms.特定のパッケージの複数のバージョンをPythonのバージョンやプラットフォームにわたって選択する際に使用する戦略。

By default, uv will optimize for selecting the latest version of each package for each supported Python version (requires-python), while minimizing the number of selected versions across platforms.デフォルトでは、uvは各サポートされているPythonバージョン（requires-python）ごとに各パッケージの最新バージョンを選択することを最適化し、プラットフォーム間で選択されたバージョンの数を最小限に抑えます。

Under fewest, uv will minimize the number of selected versions for each package, preferring older versions that are compatible with a wider range of supported Python versions or platforms.fewestの下では、uvは各パッケージの選択されたバージョンの数を最小限に抑え、より広範囲のサポートされているPythonバージョンやプラットフォームと互換性のある古いバージョンを優先します。

May also be set with the UV_FORK_STRATEGY environment variable.UV_FORK_STRATEGY環境変数で設定することもできます。

Possible values:可能な値：

fewest: Optimize for selecting the fewest number of versions for each package. Older versions may be preferred if they are compatible with a wider range of supported Python versions or platformsfewest: 各パッケージの選択されたバージョンの数を最小限に抑えることを最適化します。より広範囲のサポートされているPythonバージョンやプラットフォームと互換性がある場合、古いバージョンが優先されることがあります。
requires-python: Optimize for selecting latest supported version of each package, for each supported Python versionrequires-python: 各サポートされているPythonバージョンごとに各パッケージの最新のサポートバージョンを選択することを最適化します。

--format format--format format

The format in which the resolution should be output.解決結果を出力する形式。

Supports both requirements.txt and pylock.toml (PEP 751) output formats.requirements.txtとpylock.toml（PEP 751）出力形式の両方をサポートしています。

uv will infer the output format from the file extension of the output file, if provided. Otherwise, defaults to requirements.txt.uvは、出力ファイルの拡張子から出力形式を推測します。指定されていない場合は、デフォルトでrequirements.txtになります。

Possible values:可能な値：

requirements.txt: Export in requirements.txt formatrequirements.txt: requirements.txt形式でエクスポート
pylock.toml: Export in pylock.toml formatpylock.toml: pylock.toml形式でエクスポート

--generate-hashes--generate-hashes

Include distribution hashes in the output file出力ファイルに配布ハッシュを含める

--group group--group group

Install the specified dependency group from a pyproject.toml.pyproject.tomlから指定された依存関係グループをインストールします。

If no path is provided, the pyproject.toml in the working directory is used.パスが指定されていない場合は、作業ディレクトリのpyproject.tomlが使用されます。

May be provided multiple times.複数回指定することができます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します

--index index--index index

The URLs to use when resolving dependencies, in addition to the default index.デフォルトのインデックスに加えて、依存関係を解決するために使用するURL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式で配置されたローカルディレクトリのいずれかを受け入れます。

All indexes provided via this flag take priority over the index specified by --default-index (which defaults to PyPI). When multiple --index flags are provided, earlier values take priority.このフラグで提供されたすべてのインデックスは、--default-index（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の--indexフラグが提供される場合、早い値が優先されます。

Index names are not supported as values. Relative paths must be disambiguated from index names with ./ or ../ on Unix or .\\, ..\\, ./ or ../ on Windows.インデックス名は値としてサポートされていません。相対パスは、Unixでは./または../、Windowsでは.\\、..\\、./または../でインデックス名と区別する必要があります。

May also be set with the UV_INDEX environment variable.UV_INDEX環境変数で設定することもできます。

--index-strategy index-strategy--index-strategy index-strategy

The strategy to use when resolving against multiple index URLs.複数のインデックスURLに対して解決する際に使用する戦略。

By default, uv will stop at the first index on which a given package is available, and limit resolutions to those present on that first index (first-index). This prevents "dependency confusion" attacks, whereby an attacker can upload a malicious package under the same name to an alternate index.デフォルトでは、uvは指定されたパッケージが利用可能な最初のインデックスで停止し、その最初のインデックスに存在するものに解決を制限します (first-index)。これにより、攻撃者が同じ名前の悪意のあるパッケージを別のインデックスにアップロードすることによる「依存関係の混乱」攻撃を防ぎます。

May also be set with the UV_INDEX_STRATEGY environment variable.また、UV_INDEX_STRATEGY 環境変数で設定することもできます。

Possible values:可能な値：

first-index: Only use results from the first index that returns a match for a given package namefirst-index: 指定されたパッケージ名に対して一致を返す最初のインデックスからの結果のみを使用します。
unsafe-first-match: Search for every package name across all indexes, exhausting the versions from the first index before moving on to the nextunsafe-first-match: すべてのインデックスで各パッケージ名を検索し、次のインデックスに移動する前に最初のインデックスからのバージョンを使い果たします。
unsafe-best-match: Search for every package name across all indexes, preferring the "best" version found. If a package version is in multiple indexes, only look at the entry for the first indexunsafe-best-match: すべてのインデックスで各パッケージ名を検索し、見つかった「最良」のバージョンを優先します。パッケージバージョンが複数のインデックスに存在する場合、最初のインデックスのエントリのみを参照します。

--index-url, -i index-url--index-url, -i index-url

(Deprecated: use --default-index instead) The URL of the Python package index (by default: https://pypi.org/simple).(非推奨: 代わりに --default-index を使用してください) PythonパッケージインデックスのURL（デフォルト: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリまたは同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --extra-index-url flag.このフラグで指定されたインデックスは、--extra-index-url フラグを介して指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_INDEX_URL environment variable.環境変数 UV_INDEX_URL でも設定できます。

--keyring-provider keyring-provider--keyring-provider keyring-provider

Attempt to use keyring for authentication for index URLs.インデックスURLの認証に keyring を使用しようとします。

At present, only --keyring-provider subprocess is supported, which configures uv to use the keyring CLI to handle authentication.現在、--keyring-provider subprocess のみがサポートされており、これは uv が認証を処理するために keyring CLI を使用するように構成します。

Defaults to disabled.デフォルトは disabled です。

May also be set with the UV_KEYRING_PROVIDER environment variable.環境変数 UV_KEYRING_PROVIDER でも設定できます。

Possible values:可能な値:

disabled: Do not use keyring for credential lookupdisabled: 認証情報の検索に keyring を使用しない
subprocess: Use the keyring command for credential lookupsubprocess: 認証情報の検索に keyring コマンドを使用する

--link-mode link-mode--link-mode link-mode

The method to use when installing packages from the global cache.グローバルキャッシュからパッケージをインストールする際に使用する方法。

This option is only used when building source distributions.このオプションは、ソース配布をビルドする際にのみ使用されます。

Defaults to clone (also known as Copy-on-Write) on macOS, and hardlink on Linux and Windows.macOSではclone（コピーオンライトとも呼ばれる）にデフォルト設定されており、LinuxおよびWindowsではhardlinkにデフォルト設定されています。

WARNING: The use of symlink link mode is discouraged, as they create tight coupling between the cache and the target environment. For example, clearing the cache (uv cache clean) will break all installed packages by way of removing the underlying source files. Use symlinks with caution.警告: シンボリックリンクモードの使用は推奨されません。これはキャッシュとターゲット環境の間に強い結合を生じさせるためです。たとえば、キャッシュをクリアする（uv cache clean）と、基盤となるソースファイルが削除されることで、すべてのインストールされたパッケージが壊れます。シンボリックリンクは注意して使用してください。

May also be set with the UV_LINK_MODE environment variable.UV_LINK_MODE環境変数で設定することもできます。

Possible values:可能な値:

clone: Clone (i.e., copy-on-write) packages from the wheel into the site-packages directoryclone: ホイールからsite-packagesディレクトリにパッケージをクローン（すなわち、コピーオンライト）します。
copy: Copy packages from the wheel into the site-packages directorycopy: ホイールからsite-packagesディレクトリにパッケージをコピーします。
hardlink: Hard link packages from the wheel into the site-packages directoryhardlink: ホイールからsite-packagesディレクトリにパッケージをハードリンクします。
symlink: Symbolically link packages from the wheel into the site-packages directorysymlink: ホイールからsite-packagesディレクトリにパッケージをシンボリックリンクします。

--managed-python--managed-python

Require use of uv-managed Python versions.uvが管理するPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンを使用することを優先します。ただし、uvが管理するPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON 環境変数で設定することもできます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンス（特にmacOSで）が向上します。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、プラットフォームのネイティブ証明書ストアを使用したいことがあります。特に、システムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合です。

May also be set with the UV_NATIVE_TLS environment variable.UV_NATIVE_TLS 環境変数で設定することもできます。

--no-annotate--no-annotate

Exclude comment annotations indicating the source of each package各パッケージのソースを示すコメントアノテーションを除外します

--no-binary no-binary--no-binary no-binary

Don't install pre-built wheels.事前にビルドされたホイールをインストールしません。

The given packages will be built and installed from source. The resolver will still use pre-built wheels to extract package metadata, if available.指定されたパッケージはソースからビルドされ、インストールされます。リゾルバーは、利用可能な場合、パッケージメタデータを抽出するために事前にビルドされたホイールを使用します。

Multiple packages may be provided. Disable binaries for all packages with :all:. Clear previously specified packages with :none:.複数のパッケージを指定できます。すべてのパッケージのバイナリを無効にするには :all: を使用します。以前に指定したパッケージをクリアするには :none: を使用します。

--no-build--no-build

Don't build source distributions.ソース配布物をビルドしません。

When enabled, resolving will not run arbitrary Python code. The cached wheels of already-built source distributions will be reused, but operations that require building distributions will exit with an error.有効にすると、リゾルビングは任意のPythonコードを実行しません。すでにビルドされたソース配布物のキャッシュされたホイールは再利用されますが、配布物のビルドを必要とする操作はエラーで終了します。

Alias for --only-binary :all:.--only-binary :all: のエイリアスです。

--no-build-isolation--no-build-isolation

Disable isolation when building source distributions.ソース配布物をビルドする際にアイソレーションを無効にします。

Assumes that build dependencies specified by PEP 518 are already installed.PEP 518で指定されたビルド依存関係がすでにインストールされていると仮定します。

May also be set with the UV_NO_BUILD_ISOLATION environment variable.UV_NO_BUILD_ISOLATION 環境変数でも設定できます。

--no-build-isolation-package no-build-isolation-package--no-build-isolation-package no-build-isolation-package

Disable isolation when building source distributions for a specific package.特定のパッケージのソース配布物をビルドする際にアイソレーションを無効にします。

Assumes that the packages' build dependencies specified by PEP 518 are already installed.そのパッケージのビルド依存関係がPEP 518で指定されていると仮定します。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.UV_NO_CACHE 環境変数でも設定できます。

--no-deps--no-deps

Ignore package dependencies, instead only add those packages explicitly listed on the command line to the resulting requirements fileパッケージの依存関係を無視し、コマンドラインに明示的にリストされたパッケージのみを結果の要件ファイルに追加します。

--no-emit-package, --unsafe-package no-emit-package--no-emit-package, --unsafe-package no-emit-package

Specify a package to omit from the output resolution. Its dependencies will still be included in the resolution. Equivalent to pip-compile's --unsafe-package option出力解決から省略するパッケージを指定します。その依存関係は解決に含まれます。これはpip-compileの--unsafe-packageオプションと同等です。

--no-header--no-header

Exclude the comment header at the top of the generated output file生成された出力ファイルの先頭にあるコメントヘッダーを除外します。

--no-index--no-index

Ignore the registry index (e.g., PyPI), instead relying on direct URL dependencies and those provided via --find-linksレジストリインデックス（例：PyPI）を無視し、直接URL依存関係および--find-linksを介して提供されたものに依存します。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.その代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.環境変数 UV_NO_MANAGED_PYTHON でも設定できます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなど。

May also be set with the UV_NO_PROGRESS environment variable.環境変数 UV_NO_PROGRESS でも設定できます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--no-sources--no-sources

Ignore the tool.uv.sources table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any workspace, Git, URL, or local path sources依存関係を解決する際に tool.uv.sources テーブルを無視します。ワークスペース、Git、URL、またはローカルパスソースを使用するのではなく、標準準拠の公開可能なパッケージメタデータに対してロックするために使用されます。

May also be set with the UV_NO_SOURCES environment variable.環境変数 UV_NO_SOURCES でも設定できます。

--no-strip-extras--no-strip-extras

Include extras in the output file.出力ファイルにエクストラを含めます。

By default, uv strips extras, as any packages pulled in by the extras are already included as dependencies in the output file directly. Further, output files generated with --no-strip-extras cannot be used as constraints files in install and sync invocations.デフォルトでは、uvはエクストラを削除します。なぜなら、エクストラによって引き込まれるパッケージはすでに出力ファイルに直接依存関係として含まれているからです。さらに、--no-strip-extrasを使用して生成された出力ファイルは、installおよびsyncの呼び出しで制約ファイルとして使用できません。

--no-strip-markers--no-strip-markers

Include environment markers in the output file.出力ファイルに環境マーカーを含めます。

By default, uv strips environment markers, as the resolution generated by compile is only guaranteed to be correct for the target environment.デフォルトでは、uvは環境マーカーを削除します。なぜなら、compileによって生成される解決は、ターゲット環境に対してのみ正しいことが保証されているからです。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE環境変数を使用して設定することもできます。

--only-binary only-binary--only-binary only-binary

Only use pre-built wheels; don't build source distributions.事前にビルドされたホイールのみを使用します。ソース配布物はビルドしません。

When enabled, resolving will not run code from the given packages. The cached wheels of already-built source distributions will be reused, but operations that require building distributions will exit with an error.有効にすると、解決時に指定されたパッケージのコードは実行されません。すでにビルドされたソース配布物のキャッシュされたホイールが再利用されますが、配布物のビルドを必要とする操作はエラーで終了します。

Multiple packages may be provided. Disable binaries for all packages with :all:. Clear previously specified packages with :none:.複数のパッケージを指定できます。すべてのパッケージのバイナリを無効にするには :all: を使用します。以前に指定したパッケージをクリアするには :none: を使用します。

--output-file, -o output-file--output-file, -o output-file

Write the compiled requirements to the given requirements.txt or pylock.toml file.コンパイルされた要件を指定された requirements.txt または pylock.toml ファイルに書き込みます。

If the file already exists, the existing versions will be preferred when resolving dependencies, unless --upgrade is also specified.ファイルがすでに存在する場合、依存関係を解決する際には既存のバージョンが優先されます。ただし、--upgrade も指定されている場合はこの限りではありません。

--overrides, --override overrides--overrides, --override overrides

Override versions using the given requirements files.指定された要件ファイルを使用してバージョンを上書きします。

Overrides files are requirements.txt-like files that force a specific version of a requirement to be installed, regardless of the requirements declared by any constituent package, and regardless of whether this would be considered an invalid resolution.オーバーライドファイルは requirements.txt に似たファイルで、構成パッケージによって宣言された要件に関係なく、特定の要件のバージョンを強制的にインストールさせるものであり、これが無効な解決と見なされるかどうかに関係なく適用されます。

While constraints are additive, in that they're combined with the requirements of the constituent packages, overrides are absolute, in that they completely replace the requirements of the constituent packages.制約は加算的であり、構成パッケージの要件と組み合わされますが、オーバーライドは絶対的であり、構成パッケージの要件を完全に置き換えます。

May also be set with the UV_OVERRIDE environment variable.また、UV_OVERRIDE環境変数で設定することもできます。

--prerelease prerelease--prerelease プレリリース

The strategy to use when considering pre-release versions.プレリリースバージョンを考慮する際に使用する戦略。

By default, uv will accept pre-releases for packages that only publish pre-releases, along with first-party requirements that contain an explicit pre-release marker in the declared specifiers (if-necessary-or-explicit).デフォルトでは、uvはのみプレリリースを公開するパッケージと、宣言された指定子に明示的なプレリリースマーカーを含むファーストパーティの要件に対してプレリリースを受け入れます（if-necessary-or-explicit）。

May also be set with the UV_PRERELEASE environment variable.また、UV_PRERELEASE環境変数で設定することもできます。

Possible values:可能な値：

disallow: Disallow all pre-release versionsdisallow: すべてのプレリリースバージョンを禁止
allow: Allow all pre-release versionsallow: すべてのプレリリースバージョンを許可
if-necessary: Allow pre-release versions if all versions of a package are pre-releaseif-necessary: すべてのバージョンがプレリリースである場合にプレリリースバージョンを許可
explicit: Allow pre-release versions for first-party packages with explicit pre-release markers in their version requirementsexplicit: 明示的なプレリリースマーカーを持つファーストパーティパッケージのプレリリースバージョンを許可します。
if-necessary-or-explicit: Allow pre-release versions if all versions of a package are pre-release, or if the package has an explicit pre-release marker in its version requirementsif-necessary-or-explicit: すべてのバージョンがプレリリースである場合、またはパッケージが明示的なプレリリースマーカーを持つ場合にプレリリースバージョンを許可します。

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数を使用して設定することもできます。

--python, -p python--python, -p python

The Python interpreter to use during resolution.解決中に使用するPythonインタプリタ。

A Python interpreter is required for building source distributions to determine package metadata when there are not wheels.ソース配布をビルドするにはPythonインタプリタが必要で、ホイールがない場合にパッケージメタデータを決定します。

The interpreter is also used to determine the default minimum Python version, unless --python-version is provided.インタプリタは、--python-versionが提供されていない限り、デフォルトの最小Pythonバージョンを決定するためにも使用されます。

This option respects UV_PYTHON, but when set via environment variable, it is overridden by --python-version.このオプションはUV_PYTHONを尊重しますが、環境変数経由で設定された場合は--python-versionによって上書きされます。

See uv python for details on Python discovery and supported request formats.Pythonの発見とサポートされているリクエスト形式の詳細については、uv pythonを参照してください。

--python-platform python-platform--python-platform python-platform

The platform for which requirements should be resolved.要件を解決すべきプラットフォーム。

Represented as a "target triple", a string that describes the target platform in terms of its CPU, vendor, and operating system name, like x86_64-unknown-linux-gnu or aarch64-apple-darwin."ターゲットトリプル"として表され、CPU、ベンダー、およびオペレーティングシステム名に関するターゲットプラットフォームを説明する文字列で、x86_64-unknown-linux-gnuやaarch64-apple-darwinのようになります。

When targeting macOS (Darwin), the default minimum version is 13.0. Use MACOSX_DEPLOYMENT_TARGET to specify a different minimum version, e.g., 14.0.macOS（Darwin）をターゲットにする場合、デフォルトの最小バージョンは13.0です。異なる最小バージョンを指定するにはMACOSX_DEPLOYMENT_TARGETを使用します。例：14.0。

When targeting iOS, the default minimum version is 13.0. Use IPHONEOS_DEPLOYMENT_TARGET to specify a different minimum version, e.g., 14.0.iOSをターゲットにする場合、デフォルトの最小バージョンは13.0です。異なる最小バージョンを指定するにはIPHONEOS_DEPLOYMENT_TARGETを使用します。例：14.0。

When targeting Android, the default minimum Android API level is 24. Use ANDROID_API_LEVEL to specify a different minimum version, e.g., 26.Androidをターゲットにする場合、デフォルトの最小Android APIレベルは24です。異なる最小バージョンを指定するにはANDROID_API_LEVELを使用します。例：26。

Possible values:可能な値：

windows: An alias for x86_64-pc-windows-msvc, the default target for Windowswindows: x86_64-pc-windows-msvcのエイリアスで、Windowsのデフォルトターゲットです。
linux: An alias for x86_64-unknown-linux-gnu, the default target for Linuxlinux: x86_64-unknown-linux-gnuのエイリアスで、Linuxのデフォルトターゲットです。
macos: An alias for aarch64-apple-darwin, the default target for macOSmacos: aarch64-apple-darwinのエイリアスで、macOSのデフォルトターゲットです。
x86_64-pc-windows-msvc: A 64-bit x86 Windows targetx86_64-pc-windows-msvc: 64ビットx86 Windowsターゲットです。
aarch64-pc-windows-msvc: An ARM64 Windows targetaarch64-pc-windows-msvc: ARM64 Windowsターゲットです。
i686-pc-windows-msvc: A 32-bit x86 Windows targeti686-pc-windows-msvc: 32ビットx86 Windowsターゲットです。
x86_64-unknown-linux-gnu: An x86 Linux target. Equivalent to x86_64-manylinux_2_28x86_64-unknown-linux-gnu: x86 Linuxターゲットです。x86_64-manylinux_2_28と同等です。
aarch64-apple-darwin: An ARM-based macOS target, as seen on Apple Silicon devicesaarch64-apple-darwin: Apple Siliconデバイスで見られるARMベースのmacOSターゲットです。
x86_64-apple-darwin: An x86 macOS targetx86_64-apple-darwin: x86 macOS ターゲット
aarch64-unknown-linux-gnu: An ARM64 Linux target. Equivalent to aarch64-manylinux_2_28aarch64-unknown-linux-gnu: ARM64 Linux ターゲット。aarch64-manylinux_2_28 と同等
aarch64-unknown-linux-musl: An ARM64 Linux targetaarch64-unknown-linux-musl: ARM64 Linux ターゲット
x86_64-unknown-linux-musl: An x86_64 Linux targetx86_64-unknown-linux-musl: x86_64 Linux ターゲット
riscv64-unknown-linux: A RISCV64 Linux targetriscv64-unknown-linux: RISCV64 Linux ターゲット
x86_64-manylinux2014: An x86_64 target for the manylinux2014 platform. Equivalent to x86_64-manylinux_2_17x86_64-manylinux2014: manylinux2014 プラットフォーム用の x86_64 ターゲット。x86_64-manylinux_2_17 と同等
x86_64-manylinux_2_17: An x86_64 target for the manylinux_2_17 platformx86_64-manylinux_2_17: manylinux_2_17 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_28: An x86_64 target for the manylinux_2_28 platformx86_64-manylinux_2_28: manylinux_2_28 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_31: An x86_64 target for the manylinux_2_31 platformx86_64-manylinux_2_31: manylinux_2_31 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_32: An x86_64 target for the manylinux_2_32 platformx86_64-manylinux_2_32: manylinux_2_32 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_33: An x86_64 target for the manylinux_2_33 platformx86_64-manylinux_2_33: manylinux_2_33 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_34: An x86_64 target for the manylinux_2_34 platformx86_64-manylinux_2_34: manylinux_2_34 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_35: An x86_64 target for the manylinux_2_35 platformx86_64-manylinux_2_35: manylinux_2_35 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_36: An x86_64 target for the manylinux_2_36 platformx86_64-manylinux_2_36: manylinux_2_36 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_37: An x86_64 target for the manylinux_2_37 platformx86_64-manylinux_2_37: manylinux_2_37 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_38: An x86_64 target for the manylinux_2_38 platformx86_64-manylinux_2_38: manylinux_2_38 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_39: An x86_64 target for the manylinux_2_39 platformx86_64-manylinux_2_39: manylinux_2_39 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_40: An x86_64 target for the manylinux_2_40 platformx86_64-manylinux_2_40: manylinux_2_40 プラットフォーム用の x86_64 ターゲット
aarch64-manylinux2014: An ARM64 target for the manylinux2014 platform. Equivalent to aarch64-manylinux_2_17aarch64-manylinux2014: manylinux2014 プラットフォーム用の ARM64 ターゲット。aarch64-manylinux_2_17 と同等
aarch64-manylinux_2_17: An ARM64 target for the manylinux_2_17 platformaarch64-manylinux_2_17: manylinux_2_17 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_28: An ARM64 target for the manylinux_2_28 platformaarch64-manylinux_2_28: manylinux_2_28 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_31: An ARM64 target for the manylinux_2_31 platformaarch64-manylinux_2_31: manylinux_2_31 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_32: An ARM64 target for the manylinux_2_32 platformaarch64-manylinux_2_32: manylinux_2_32 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_33: An ARM64 target for the manylinux_2_33 platformaarch64-manylinux_2_33: manylinux_2_33 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_34: An ARM64 target for the manylinux_2_34 platformaarch64-manylinux_2_34: manylinux_2_34 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_35: An ARM64 target for the manylinux_2_35 platformaarch64-manylinux_2_35: manylinux_2_35 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_36: An ARM64 target for the manylinux_2_36 platformaarch64-manylinux_2_36: manylinux_2_36 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_37: An ARM64 target for the manylinux_2_37 platformaarch64-manylinux_2_37: manylinux_2_37 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_38: An ARM64 target for the manylinux_2_38 platformaarch64-manylinux_2_38: manylinux_2_38 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_39: An ARM64 target for the manylinux_2_39 platformaarch64-manylinux_2_39: manylinux_2_39 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_40: An ARM64 target for the manylinux_2_40 platformaarch64-manylinux_2_40: manylinux_2_40プラットフォーム用のARM64ターゲット
aarch64-linux-android: An ARM64 Android targetaarch64-linux-android: ARM64 Androidターゲット
x86_64-linux-android: An x86_64 Android targetx86_64-linux-android: x86_64 Androidターゲット
wasm32-pyodide2024: A wasm32 target using the Pyodide 2024 platform. Meant for use with Python 3.12wasm32-pyodide2024: Pyodide 2024プラットフォームを使用したwasm32ターゲット。Python 3.12用に設計されています
arm64-apple-ios: An ARM64 target for iOS devicearm64-apple-ios: iOSデバイス用のARM64ターゲット
arm64-apple-ios-simulator: An ARM64 target for iOS simulatorarm64-apple-ios-simulator: iOSシミュレーター用のARM64ターゲット
x86_64-apple-ios-simulator: An x86_64 target for iOS simulatorx86_64-apple-ios-simulator: iOSシミュレーター用のx86_64ターゲット

--python-version python-version--python-version python-version

The Python version to use for resolution.解決に使用するPythonのバージョン。

For example, 3.8 or 3.8.17.例えば、3.8または3.8.17。

Defaults to the version of the Python interpreter used for resolution.解決に使用されるPythonインタプリタのバージョンにデフォルト設定されます。

Defines the minimum Python version that must be supported by the resolved requirements.解決された要件がサポートしなければならない最小のPythonバージョンを定義します。

If a patch version is omitted, the minimum patch version is assumed. For example, 3.8 is mapped to 3.8.0.パッチバージョンが省略された場合、最小のパッチバージョンが仮定されます。例えば、3.8は3.8.0にマッピングされます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば-qq、uvはstdoutに出力を行わないサイレントモードを有効にします。

--refresh--refresh

Refresh all cached dataすべてのキャッシュデータを更新します。

--refresh-package refresh-package--refresh-package refresh-package

Refresh cached data for a specific package特定のパッケージのキャッシュデータを更新します。

--resolution resolution--resolution 解像度

The strategy to use when selecting between the different compatible versions for a given package requirement.特定のパッケージ要件に対して異なる互換バージョンを選択する際に使用する戦略。

By default, uv will use the latest compatible version of each package (highest).デフォルトでは、uvは各パッケージの最新の互換バージョンを使用します（highest）。

May also be set with the UV_RESOLUTION environment variable.UV_RESOLUTION 環境変数を使用して設定することもできます。

Possible values:可能な値：

highest: Resolve the highest compatible version of each packagehighest: 各パッケージの最高の互換バージョンを解決します
lowest: Resolve the lowest compatible version of each packagelowest: 各パッケージの最低の互換バージョンを解決します
lowest-direct: Resolve the lowest compatible version of any direct dependencies, and the highest compatible version of any transitive dependencieslowest-direct: 直接依存関係の最低の互換バージョンを解決し、間接依存関係の最高の互換バージョンを解決します

--system--system

Install packages into the system Python environment.パッケージをシステムのPython環境にインストールします。

By default, uv uses the virtual environment in the current working directory or any parent directory, falling back to searching for a Python executable in PATH. The --system option instructs uv to avoid using a virtual environment Python and restrict its search to the system path.デフォルトでは、uvは現在の作業ディレクトリまたは親ディレクトリにある仮想環境を使用し、PATH内のPython実行可能ファイルを検索します。--systemオプションは、uvに仮想環境のPythonを使用せず、システムパスのみに検索を制限するよう指示します。

May also be set with the UV_SYSTEM_PYTHON environment variable.UV_SYSTEM_PYTHON環境変数を使用して設定することもできます。

--torch-backend torch-backend--torch-backend torch-backend

The backend to use when fetching packages in the PyTorch ecosystem (e.g., cpu, cu126, or auto).PyTorchエコシステム内でパッケージを取得する際に使用するバックエンド（例：cpu、cu126、またはauto）。

When set, uv will ignore the configured index URLs for packages in the PyTorch ecosystem, and will instead use the defined backend.設定されている場合、uvはPyTorchエコシステム内のパッケージのために構成されたインデックスURLを無視し、代わりに定義されたバックエンドを使用します。

For example, when set to cpu, uv will use the CPU-only PyTorch index; when set to cu126, uv will use the PyTorch index for CUDA 12.6.例えば、cpuに設定されている場合、uvはCPU専用のPyTorchインデックスを使用します。cu126に設定されている場合、uvはCUDA 12.6用のPyTorchインデックスを使用します。

The auto mode will attempt to detect the appropriate PyTorch index based on the currently installed CUDA drivers.autoモードは、現在インストールされているCUDAドライバに基づいて適切なPyTorchインデックスを検出しようとします。

This option is in preview and may change in any future release.このオプションはプレビュー中であり、将来のリリースで変更される可能性があります。

May also be set with the UV_TORCH_BACKEND environment variable.UV_TORCH_BACKEND環境変数を使用して設定することもできます。

Possible values:可能な値：

auto: Select the appropriate PyTorch index based on the operating system and CUDA driver versionauto: オペレーティングシステムとCUDAドライバーバージョンに基づいて適切なPyTorchインデックスを選択します
cpu: Use the CPU-only PyTorch indexcpu: CPU専用のPyTorchインデックスを使用します
cu130: Use the PyTorch index for CUDA 13.0cu130: CUDA 13.0用のPyTorchインデックスを使用します
cu129: Use the PyTorch index for CUDA 12.9cu129: CUDA 12.9用のPyTorchインデックスを使用します
cu128: Use the PyTorch index for CUDA 12.8cu128: CUDA 12.8用のPyTorchインデックスを使用します
cu126: Use the PyTorch index for CUDA 12.6cu126: CUDA 12.6用のPyTorchインデックスを使用します
cu125: Use the PyTorch index for CUDA 12.5cu125: CUDA 12.5用のPyTorchインデックスを使用します
cu124: Use the PyTorch index for CUDA 12.4cu124: CUDA 12.4用のPyTorchインデックスを使用します
cu123: Use the PyTorch index for CUDA 12.3cu123: CUDA 12.3用のPyTorchインデックスを使用します
cu122: Use the PyTorch index for CUDA 12.2cu122: CUDA 12.2用のPyTorchインデックスを使用します
cu121: Use the PyTorch index for CUDA 12.1cu121: CUDA 12.1用のPyTorchインデックスを使用します
cu120: Use the PyTorch index for CUDA 12.0cu120: CUDA 12.0用のPyTorchインデックスを使用します
cu118: Use the PyTorch index for CUDA 11.8cu118: CUDA 11.8用のPyTorchインデックスを使用します
cu117: Use the PyTorch index for CUDA 11.7cu117: CUDA 11.7用のPyTorchインデックスを使用します
cu116: Use the PyTorch index for CUDA 11.6cu116: CUDA 11.6用のPyTorchインデックスを使用します
cu115: Use the PyTorch index for CUDA 11.5cu115: CUDA 11.5用のPyTorchインデックスを使用します
cu114: Use the PyTorch index for CUDA 11.4cu114: CUDA 11.4用のPyTorchインデックスを使用します
cu113: Use the PyTorch index for CUDA 11.3cu113: CUDA 11.3用のPyTorchインデックスを使用します
cu112: Use the PyTorch index for CUDA 11.2cu112: CUDA 11.2用のPyTorchインデックスを使用します
cu111: Use the PyTorch index for CUDA 11.1cu111: CUDA 11.1用のPyTorchインデックスを使用します
cu110: Use the PyTorch index for CUDA 11.0cu110: CUDA 11.0 用の PyTorch インデックスを使用します
cu102: Use the PyTorch index for CUDA 10.2cu102: CUDA 10.2 用の PyTorch インデックスを使用します
cu101: Use the PyTorch index for CUDA 10.1cu101: CUDA 10.1 用の PyTorch インデックスを使用します
cu100: Use the PyTorch index for CUDA 10.0cu100: CUDA 10.0 用の PyTorch インデックスを使用します
cu92: Use the PyTorch index for CUDA 9.2cu92: CUDA 9.2 用の PyTorch インデックスを使用します
cu91: Use the PyTorch index for CUDA 9.1cu91: CUDA 9.1 用の PyTorch インデックスを使用します
cu90: Use the PyTorch index for CUDA 9.0cu90: CUDA 9.0 用の PyTorch インデックスを使用します
cu80: Use the PyTorch index for CUDA 8.0cu80: CUDA 8.0 用の PyTorch インデックスを使用します
rocm6.3: Use the PyTorch index for ROCm 6.3rocm6.3: ROCm 6.3 用の PyTorch インデックスを使用します
rocm6.2.4: Use the PyTorch index for ROCm 6.2.4rocm6.2.4: ROCm 6.2.4 用の PyTorch インデックスを使用します
rocm6.2: Use the PyTorch index for ROCm 6.2rocm6.2: ROCm 6.2 のための PyTorch インデックスを使用してください
rocm6.1: Use the PyTorch index for ROCm 6.1rocm6.1: ROCm 6.1 のための PyTorch インデックスを使用してください
rocm6.0: Use the PyTorch index for ROCm 6.0rocm6.0: ROCm 6.0 のための PyTorch インデックスを使用してください
rocm5.7: Use the PyTorch index for ROCm 5.7rocm5.7: ROCm 5.7 のための PyTorch インデックスを使用してください
rocm5.6: Use the PyTorch index for ROCm 5.6rocm5.6: ROCm 5.6 のための PyTorch インデックスを使用してください
rocm5.5: Use the PyTorch index for ROCm 5.5rocm5.5: ROCm 5.5 のための PyTorch インデックスを使用してください
rocm5.4.2: Use the PyTorch index for ROCm 5.4.2rocm5.4.2: ROCm 5.4.2 のための PyTorch インデックスを使用してください
rocm5.4: Use the PyTorch index for ROCm 5.4rocm5.4: ROCm 5.4 のための PyTorch インデックスを使用してください
rocm5.3: Use the PyTorch index for ROCm 5.3rocm5.3: ROCm 5.3 のための PyTorch インデックスを使用してください
rocm5.2: Use the PyTorch index for ROCm 5.2rocm5.2: ROCm 5.2 のための PyTorch インデックスを使用してください
rocm5.1.1: Use the PyTorch index for ROCm 5.1.1rocm5.1.1: ROCm 5.1.1のためのPyTorchインデックスを使用します
rocm4.2: Use the PyTorch index for ROCm 4.2rocm4.2: ROCm 4.2のためのPyTorchインデックスを使用します
rocm4.1: Use the PyTorch index for ROCm 4.1rocm4.1: ROCm 4.1のためのPyTorchインデックスを使用します
rocm4.0.1: Use the PyTorch index for ROCm 4.0.1rocm4.0.1: ROCm 4.0.1のためのPyTorchインデックスを使用します
xpu: Use the PyTorch index for Intel XPUxpu: Intel XPUのためのPyTorchインデックスを使用します

--universal--universal

Perform a universal resolution, attempting to generate a single requirements.txt output file that is compatible with all operating systems, architectures, and Python implementations.ユニバーサル解決を実行し、すべてのオペレーティングシステム、アーキテクチャ、およびPython実装に互換性のある単一のrequirements.txt出力ファイルを生成しようとします。

In universal mode, the current Python version (or user-provided --python-version) will be treated as a lower bound. For example, --universal --python-version 3.7 would produce a universal resolution for Python 3.7 and later.ユニバーサルモードでは、現在のPythonバージョン（またはユーザー提供の--python-version）が下限として扱われます。例えば、--universal --python-version 3.7はPython 3.7以降のためのユニバーサル解決を生成します。

Implies --no-strip-markers.--no-strip-markersを含意します。

--upgrade, -U--upgrade, -U

Allow package upgrades, ignoring pinned versions in any existing output file. Implies --refreshパッケージのアップグレードを許可し、既存の出力ファイルにある固定バージョンを無視します。--refreshを含意します。

--upgrade-package, -P upgrade-package--upgrade-package, -P upgrade-package

Allow upgrades for a specific package, ignoring pinned versions in any existing output file. Implies --refresh-package特定のパッケージのアップグレードを許可し、既存の出力ファイルにある固定バージョンを無視します。--refresh-packageを含意します。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)RUST_LOG環境変数を使用して、細かいログ設定を行うことができます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv pip syncuv pip sync

Sync an environment with a requirements.txt or pylock.toml file.requirements.txtまたはpylock.tomlファイルで環境を同期します。

When syncing an environment, any packages not listed in the requirements.txt or pylock.toml file will be removed. To retain extraneous packages, use uv pip install instead.環境を同期する際、requirements.txtまたはpylock.tomlファイルにリストされていないパッケージは削除されます。余分なパッケージを保持するには、代わりにuv pip installを使用してください。

The input file is presumed to be the output of a pip compile or uv export operation, in which it will include all transitive dependencies. If transitive dependencies are not present in the file, they will not be installed. Use --strict to warn if any transitive dependencies are missing.入力ファイルは、pip compileまたはuv export操作の出力であると見なされ、すべての遷移依存関係が含まれます。遷移依存関係がファイルに存在しない場合、それらはインストールされません。--strictを使用して、遷移依存関係が不足している場合に警告を表示します。

Usage使用法

uv pip sync [OPTIONS] <SRC_FILE>...

Arguments引数

SRC_FILESRC_FILE

Include the packages listed in the given files.指定されたファイルにリストされたパッケージを含めます。

The following formats are supported: requirements.txt, .py files with inline metadata, pylock.toml, pyproject.toml, setup.py, and setup.cfg.サポートされているフォーマットは次のとおりです: requirements.txt, .py ファイルのインラインメタデータ, pylock.toml, pyproject.toml, setup.py, および setup.cfg。

If a pyproject.toml, setup.py, or setup.cfg file is provided, uv will extract the requirements for the relevant project.pyproject.toml, setup.py, または setup.cfg ファイルが提供されている場合、uvは関連するプロジェクトの要件を抽出します。

If - is provided, then requirements will be read from stdin.- が提供されている場合、要件はstdinから読み取られます。

Optionsオプション

--all-extras--all-extras

Include all optional dependencies.すべてのオプション依存関係を含めます。

Only applies to pylock.toml, pyproject.toml, setup.py, and setup.cfg sources.これは pylock.toml、pyproject.toml、setup.py、および setup.cfg ソースにのみ適用されます。

--allow-empty-requirements--allow-empty-requirements

Allow sync of empty requirements, which will clear the environment of all packages空の依存関係の同期を許可し、すべてのパッケージを環境からクリアします。

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host、--trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回提供できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告: このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、検証されたソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST 環境変数でも設定できます。

--break-system-packages--break-system-packages

Allow uv to modify an EXTERNALLY-MANAGED Python installation.uvがEXTERNALLY-MANAGEDのPythonインストールを変更できるようにします。

WARNING: --break-system-packages is intended for use in continuous integration (CI) environments, when installing into Python installations that are managed by an external package manager, like apt. It should be used with caution, as such Python installations explicitly recommend against modifications by other package managers (like uv or pip).WARNING: --break-system-packagesは、aptのような外部パッケージマネージャによって管理されているPythonインストールにインストールする際の継続的インテグレーション（CI）環境での使用を意図しています。他のパッケージマネージャ（uvやpipなど）による変更を明示的に推奨していないため、注意して使用する必要があります。

May also be set with the UV_BREAK_SYSTEM_PACKAGES environment variable.UV_BREAK_SYSTEM_PACKAGES環境変数で設定することもできます。

--build-constraints, --build-constraint, -b build-constraints--build-constraints, --build-constraint, -b build-constraints

Constrain build dependencies using the given requirements files when building source distributions.ソース配布をビルドする際に、指定された要件ファイルを使用してビルド依存関係を制約します。

Constraints files are requirements.txt-like files that only control the version of a requirement that's installed. However, including a package in a constraints file will not trigger the installation of that package.制約ファイルはrequirements.txtのようなファイルで、インストールされる要件のバージョンのみを制御します。ただし、制約ファイルにパッケージを含めても、そのパッケージのインストールはトリガーされません。

May also be set with the UV_BUILD_CONSTRAINT environment variable.UV_BUILD_CONSTRAINT環境変数で設定することもできます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvに、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されています。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数を使用して設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末に書き込む際に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力がサポートされている端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--compile-bytecode, --compile--compile-bytecode, --compile

Compile Python files to bytecode after installation.インストール後にPythonファイルをバイトコードにコンパイルします。

By default, uv does not compile Python (.py) files to bytecode (__pycache__/*.pyc); instead, compilation is performed lazily the first time a module is imported. For use-cases in which start time is critical, such as CLI applications and Docker containers, this option can be enabled to trade longer installation times for faster start times.デフォルトでは、uvはPython（.py）ファイルをバイトコード（__pycache__/*.pyc）にコンパイルしません。代わりに、モジュールが初めてインポートされるときに遅延的にコンパイルが行われます。CLIアプリケーションやDockerコンテナなど、起動時間が重要なユースケースでは、このオプションを有効にすることで、インストール時間が長くなる代わりに起動時間を短縮できます。

When enabled, uv will process the entire site-packages directory (including packages that are not being modified by the current operation) for consistency. Like pip, it will also ignore errors.有効にすると、uvは整合性のためにサイトパッケージディレクトリ全体（現在の操作によって変更されていないパッケージを含む）を処理します。pipと同様に、エラーは無視されます。

May also be set with the UV_COMPILE_BYTECODE environment variable.環境変数UV_COMPILE_BYTECODEでも設定できます。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用するuv.tomlファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.環境変数UV_CONFIG_FILEでも設定できます。

--config-setting, --config-settings, -C config-setting--config-setting, --config-settings, -C config-setting

Settings to pass to the PEP 517 build backend, specified as KEY=VALUE pairsPEP 517ビルドバックエンドに渡す設定で、KEY=VALUEペアとして指定します。

--config-settings-package, --config-settings-package config-settings-package--config-settings-package, --config-settings-package config-settings-package

Settings to pass to the PEP 517 build backend for a specific package, specified as PACKAGE:KEY=VALUE pairs特定のパッケージのためにPEP 517ビルドバックエンドに渡す設定で、PACKAGE:KEY=VALUEペアとして指定されます。

--constraints, --constraint, -c constraints--constraints, --constraint, -c constraints

Constrain versions using the given requirements files.指定された要件ファイルを使用してバージョンを制約します。

Constraints files are requirements.txt-like files that only control the version of a requirement that's installed. However, including a package in a constraints file will not trigger the installation of that package.制約ファイルは、インストールされる要件のバージョンのみを制御するrequirements.txtに似たファイルです。ただし、制約ファイルにパッケージを含めても、そのパッケージのインストールはトリガーされません。

This is equivalent to pip's --constraint option.これはpipの--constraintオプションと同等です。

May also be set with the UV_CONSTRAINT environment variable.UV_CONSTRAINT環境変数で設定することもできます。

--default-index default-index--default-index default-index

The URL of the default package index (by default: https://pypi.org/simple).デフォルトのパッケージインデックスのURL（デフォルトでは: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリまたは同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --index flag.このフラグによって指定されたインデックスは、--indexフラグを介して指定された他のすべてのインデックスよりも低い優先度が与えられます。

May also be set with the UV_DEFAULT_INDEX environment variable.UV_DEFAULT_INDEX環境変数でも設定できます。

--directory directory--directory ディレクトリ

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準として解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数でも設定できます。

--dry-run--dry-run

Perform a dry run, i.e., don't actually install anything but resolve the dependencies and print the resulting planドライランを実行します。つまり、実際には何もインストールせず、依存関係を解決して結果の計画を表示します。

--exclude-newer exclude-newer--exclude-newer exclude-newer

Limit candidate packages to those that were uploaded prior to the given date.候補パッケージを指定された日付以前にアップロードされたものに制限します。

Accepts both RFC 3339 timestamps (e.g., 2006-12-02T02:07:43Z) and local dates in the same format (e.g., 2006-12-02) in your system's configured time zone.RFC 3339 タイムスタンプ（例: 2006-12-02T02:07:43Z）と、システムの設定されたタイムゾーンでの同じ形式のローカル日付（例: 2006-12-02）の両方を受け入れます。

May also be set with the UV_EXCLUDE_NEWER environment variable.UV_EXCLUDE_NEWER 環境変数で設定することもできます。

--exclude-newer-package exclude-newer-package--exclude-newer-package exclude-newer-package

Limit candidate packages for specific packages to those that were uploaded prior to the given date.特定のパッケージの候補パッケージを指定された日付以前にアップロードされたものに制限します。

Accepts package-date pairs in the format PACKAGE=DATE, where DATE is an RFC 3339 timestamp (e.g., 2006-12-02T02:07:43Z) or local date (e.g., 2006-12-02) in your system's configured time zone.PACKAGE=DATE 形式のパッケージ-日付ペアを受け入れます。ここで DATE は RFC 3339 タイムスタンプ（例: 2006-12-02T02:07:43Z）またはローカル日付（例: 2006-12-02）で、システムの設定されたタイムゾーンに基づきます。

Can be provided multiple times for different packages.異なるパッケージのために複数回提供することができます。

--extra extra--extra extra

Include optional dependencies from the specified extra name; may be provided more than once.指定されたエクストラ名からオプションの依存関係を含めます。複数回提供することができます。

Only applies to pylock.toml, pyproject.toml, setup.py, and setup.cfg sources.pylock.toml、pyproject.toml、setup.py、および setup.cfg ソースにのみ適用されます。

--extra-index-url extra-index-url--extra-index-url extra-index-url

(Deprecated: use --index instead) Extra URLs of package indexes to use, in addition to --index-url.(非推奨: 代わりに --index を使用してください) --index-url に加えて使用するパッケージインデックスの追加URL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --index-url (which defaults to PyPI). When multiple --extra-index-url flags are provided, earlier values take priority.このフラグを介して提供されるすべてのインデックスは、--index-url（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の --extra-index-url フラグが提供される場合、先に指定された値が優先されます。

May also be set with the UV_EXTRA_INDEX_URL environment variable.UV_EXTRA_INDEX_URL 環境変数で設定することもできます。

--find-links, -f find-links--find-links, -f find-links

Locations to search for candidate distributions, in addition to those found in the registry indexes.レジストリインデックスで見つかったものに加えて、候補の配布物を検索する場所。

If a path, the target must be a directory that contains packages as wheel files (.whl) or source distributions (e.g., .tar.gz or .zip) at the top level.パスの場合、ターゲットはトップレベルにホイールファイル（.whl）またはソース配布（例: .tar.gz または .zip）を含むディレクトリでなければなりません。

If a URL, the page must contain a flat list of links to package files adhering to the formats described above.URLの場合、ページは上記の形式に従ったパッケージファイルへのリンクのフラットリストを含む必要があります。

May also be set with the UV_FIND_LINKS environment variable.UV_FIND_LINKS 環境変数で設定することもできます。

--group group--group グループ

Install the specified dependency group from a pylock.toml or pyproject.toml.指定された依存関係グループを pylock.toml または pyproject.toml からインストールします。

If no path is provided, the pylock.toml or pyproject.toml in the working directory is used.パスが指定されていない場合、作業ディレクトリ内の pylock.toml または pyproject.toml が使用されます。

May be provided multiple times.複数回指定することができます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--index index--index インデックス

The URLs to use when resolving dependencies, in addition to the default index.依存関係を解決する際に使用するURLで、デフォルトのインデックスに加えて指定します。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリまたは同じ形式でレイアウトされたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --default-index (which defaults to PyPI). When multiple --index flags are provided, earlier values take priority.このフラグを介して提供されたすべてのインデックスは、--default-index（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の --index フラグが提供された場合、先に指定された値が優先されます。

Index names are not supported as values. Relative paths must be disambiguated from index names with ./ or ../ on Unix or .\\, ..\\, ./ or ../ on Windows.インデックス名は値としてサポートされていません。相対パスは、Unixでは./または../、Windowsでは.\\、..\\、./または../を使用してインデックス名と区別する必要があります。

May also be set with the UV_INDEX environment variable.UV_INDEX環境変数を使用して設定することもできます。

--index-strategy index-strategy--index-strategy index-strategy

The strategy to use when resolving against multiple index URLs.複数のインデックスURLに対して解決する際に使用する戦略。

By default, uv will stop at the first index on which a given package is available, and limit resolutions to those present on that first index (first-index). This prevents "dependency confusion" attacks, whereby an attacker can upload a malicious package under the same name to an alternate index.デフォルトでは、uvは指定されたパッケージが利用可能な最初のインデックスで停止し、その最初のインデックスに存在するものに解決を制限します（first-index）。これにより、攻撃者が同じ名前の悪意のあるパッケージを別のインデックスにアップロードすることによる「依存関係の混乱」攻撃を防ぎます。

May also be set with the UV_INDEX_STRATEGY environment variable.UV_INDEX_STRATEGY環境変数を使用して設定することもできます。

Possible values:可能な値：

first-index: Only use results from the first index that returns a match for a given package namefirst-index: 指定されたパッケージ名に対して一致を返す最初のインデックスからの結果のみを使用します。
unsafe-first-match: Search for every package name across all indexes, exhausting the versions from the first index before moving on to the nextunsafe-first-match: すべてのインデックスで各パッケージ名を検索し、次のインデックスに移動する前に最初のインデックスからのバージョンを使い果たします。
unsafe-best-match: Search for every package name across all indexes, preferring the "best" version found. If a package version is in multiple indexes, only look at the entry for the first indexunsafe-best-match: すべてのインデックスで各パッケージ名を検索し、見つかった「最良」のバージョンを優先します。パッケージバージョンが複数のインデックスに存在する場合、最初のインデックスのエントリのみを確認します。

--index-url, -i index-url--index-url, -i index-url

(Deprecated: use --default-index instead) The URL of the Python package index (by default: https://pypi.org/simple).(非推奨: 代わりに --default-index を使用してください) PythonパッケージインデックスのURL（デフォルト: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --extra-index-url flag.このフラグで指定されたインデックスは、--extra-index-urlフラグを介して指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_INDEX_URL environment variable.UV_INDEX_URL 環境変数で設定することもできます。

--keyring-provider keyring-provider--keyring-provider keyring-provider

Attempt to use keyring for authentication for index URLs.インデックスURLの認証に keyring を使用しようとします。

At present, only --keyring-provider subprocess is supported, which configures uv to use the keyring CLI to handle authentication.現在、--keyring-provider subprocess のみがサポートされており、これはuvが認証を処理するためにkeyring CLIを使用するように設定します。

Defaults to disabled.デフォルトはdisabledです。

May also be set with the UV_KEYRING_PROVIDER environment variable.UV_KEYRING_PROVIDER 環境変数で設定することもできます。

Possible values:可能な値：

disabled: Do not use keyring for credential lookupdisabled: キーリングを使用して資格情報を検索しない
subprocess: Use the keyring command for credential lookupsubprocess: 資格情報の検索にkeyringコマンドを使用する

--link-mode link-mode--link-mode link-mode

The method to use when installing packages from the global cache.グローバルキャッシュからパッケージをインストールする際に使用する方法。

Defaults to clone (also known as Copy-on-Write) on macOS, and hardlink on Linux and Windows.macOSではclone（コピーオンライトとも呼ばれる）にデフォルト設定されており、LinuxおよびWindowsではhardlinkに設定されています。

WARNING: The use of symlink link mode is discouraged, as they create tight coupling between the cache and the target environment. For example, clearing the cache (uv cache clean) will break all installed packages by way of removing the underlying source files. Use symlinks with caution.警告：シンボリックリンクモードの使用は推奨されません。キャッシュとターゲット環境の間に強い結合を作成するためです。たとえば、キャッシュをクリアする（uv cache clean）と、基になるソースファイルが削除されることで、すべてのインストールされたパッケージが壊れます。シンボリックリンクは注意して使用してください。

May also be set with the UV_LINK_MODE environment variable.UV_LINK_MODE環境変数で設定することもできます。

Possible values:可能な値：

clone: Clone (i.e., copy-on-write) packages from the wheel into the site-packages directoryclone: ホイールからsite-packagesディレクトリにパッケージをクローン（すなわち、コピーオンライト）する
copy: Copy packages from the wheel into the site-packages directorycopy: ホイールからsite-packagesディレクトリにパッケージをコピーします
hardlink: Hard link packages from the wheel into the site-packages directoryhardlink: ホイールからsite-packagesディレクトリにパッケージをハードリンクします
symlink: Symbolically link packages from the wheel into the site-packages directorysymlink: ホイールからsite-packagesディレクトリにパッケージをシンボリックリンクします

--managed-python--managed-python

Require use of uv-managed Python versions.uv管理のPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンの使用を優先します。ただし、uv管理のPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、いくつかのケースでは、プラットフォームのネイティブ証明書ストアを使用したい場合があります。特に、システムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合です。

May also be set with the UV_NATIVE_TLS environment variable.環境変数 UV_NATIVE_TLS でも設定できます。

--no-allow-empty-requirements--no-allow-empty-requirements

--no-binary no-binary--no-binary no-binary

Don't install pre-built wheels.事前にビルドされたホイールをインストールしないでください。

The given packages will be built and installed from source. The resolver will still use pre-built wheels to extract package metadata, if available.指定されたパッケージはソースからビルドされ、インストールされます。リゾルバは、利用可能な場合、パッケージメタデータを抽出するために事前にビルドされたホイールを使用します。

Multiple packages may be provided. Disable binaries for all packages with :all:. Clear previously specified packages with :none:.複数のパッケージを指定できます。すべてのパッケージのバイナリを無効にするには :all: を使用します。以前に指定したパッケージをクリアするには :none: を使用します。

--no-break-system-packages--no-break-system-packages

--no-build--no-build

Don't build source distributions.ソース配布物をビルドしないでください。

When enabled, resolving will not run arbitrary Python code. The cached wheels of already-built source distributions will be reused, but operations that require building distributions will exit with an error.有効にすると、解決は任意のPythonコードを実行しません。すでにビルドされたソース配布のキャッシュされたホイールが再利用されますが、配布をビルドする必要がある操作はエラーで終了します。

Alias for --only-binary :all:.--only-binary :all: のエイリアスです。

--no-build-isolation--no-build-isolation

Disable isolation when building source distributions.ソース配布をビルドする際にアイソレーションを無効にします。

Assumes that build dependencies specified by PEP 518 are already installed.PEP 518で指定されたビルド依存関係がすでにインストールされていると仮定します。

May also be set with the UV_NO_BUILD_ISOLATION environment variable.UV_NO_BUILD_ISOLATION 環境変数でも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.UV_NO_CACHE 環境変数でも設定できます。

--no-index--no-index

Ignore the registry index (e.g., PyPI), instead relying on direct URL dependencies and those provided via --find-linksレジストリインデックス（例：PyPI）を無視し、代わりに直接URL依存関係と--find-linksで提供されるものに依存します。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.その代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON環境変数でも設定できます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーや進行状況バーなどです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS環境変数でも設定できます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--no-sources--no-sources

Ignore the tool.uv.sources table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any workspace, Git, URL, or local path sources依存関係を解決する際にtool.uv.sourcesテーブルを無視します。ワークスペース、Git、URL、またはローカルパスソースを使用するのではなく、標準準拠の公開可能なパッケージメタデータに対してロックするために使用されます。

May also be set with the UV_NO_SOURCES environment variable.UV_NO_SOURCES環境変数でも設定できます。

--no-verify-hashes--no-verify-hashes

Disable validation of hashes in the requirements file.requirementsファイル内のハッシュの検証を無効にします。

By default, uv will verify any available hashes in the requirements file, but will not require that all requirements have an associated hash. To enforce hash validation, use --require-hashes.デフォルトでは、uvはrequirementsファイル内の利用可能なハッシュを検証しますが、すべてのrequirementsに関連付けられたハッシュが必要であるとは要求しません。ハッシュ検証を強制するには、--require-hashesを使用します。

May also be set with the UV_NO_VERIFY_HASHES environment variable.UV_NO_VERIFY_HASHES環境変数でも設定できます。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.これは、UV_OFFLINE 環境変数でも設定できます。

--only-binary only-binary--only-binary only-binary

Only use pre-built wheels; don't build source distributions.事前にビルドされたホイールのみを使用します。ソース配布物はビルドしません。

When enabled, resolving will not run code from the given packages. The cached wheels of already-built source distributions will be reused, but operations that require building distributions will exit with an error.有効にすると、解決時に指定されたパッケージからコードは実行されません。すでにビルドされたソース配布物のキャッシュされたホイールが再利用されますが、配布物のビルドを必要とする操作はエラーで終了します。

Multiple packages may be provided. Disable binaries for all packages with :all:. Clear previously specified packages with :none:.複数のパッケージを指定できます。すべてのパッケージのバイナリを無効にするには:all:を使用します。以前に指定したパッケージをクリアするには:none:を使用します。

--prefix prefix--prefix prefix

Install packages into lib, bin, and other top-level folders under the specified directory, as if a virtual environment were present at that location.指定されたディレクトリの下にあるlib、bin、およびその他のトップレベルフォルダーにパッケージをインストールします。まるでその場所に仮想環境が存在するかのように。

In general, prefer the use of --python to install into an alternate environment, as scripts and other artifacts installed via --prefix will reference the installing interpreter, rather than any interpreter added to the --prefix directory, rendering them non-portable.一般的に、--pythonを使用して別の環境にインストールすることを推奨します。--prefixを介してインストールされたスクリプトやその他のアーティファクトは、--prefixディレクトリに追加されたインタプリタではなく、インストール中のインタプリタを参照するため、ポータブルではなくなります。

Unlike other install operations, this command does not require discovery of an existing Python environment and only searches for a Python interpreter to use for package resolution. If a suitable Python interpreter cannot be found, uv will install one. To disable this, add --no-python-downloads.他のインストール操作とは異なり、このコマンドは既存のPython環境の発見を必要とせず、パッケージ解決に使用するPythonインタプリタを検索するだけです。適切なPythonインタプリタが見つからない場合、uvは1つをインストールします。これを無効にするには、--no-python-downloadsを追加します。

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用される場合には効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数を使用して設定することもできます。

--python, -p python--python, -p python

The Python interpreter into which packages should be installed.パッケージをインストールするためのPythonインタプリタ。

By default, syncing requires a virtual environment. A path to an alternative Python can be provided, but it is only recommended in continuous integration (CI) environments and should be used with caution, as it can modify the system Python installation.デフォルトでは、同期には仮想環境が必要です。代替のPythonへのパスを提供することもできますが、これは継続的インテグレーション（CI）環境でのみ推奨され、システムのPythonインストールを変更する可能性があるため注意して使用する必要があります。

See uv python for details on Python discovery and supported request formats.詳細についてはuv pythonを参照してください。

May also be set with the UV_PYTHON environment variable.UV_PYTHON環境変数を使用して設定することもできます。

--python-platform python-platform--python-platform python-platform

The platform for which requirements should be installed.要件をインストールするプラットフォーム。

Represented as a "target triple", a string that describes the target platform in terms of its CPU, vendor, and operating system name, like x86_64-unknown-linux-gnu or aarch64-apple-darwin."target triple"として表現され、CPU、ベンダー、およびオペレーティングシステム名に関するターゲットプラットフォームを説明する文字列で、x86_64-unknown-linux-gnuやaarch64-apple-darwinのようになります。

When targeting macOS (Darwin), the default minimum version is 13.0. Use MACOSX_DEPLOYMENT_TARGET to specify a different minimum version, e.g., 14.0.macOS (Darwin)をターゲットにする場合、デフォルトの最小バージョンは13.0です。異なる最小バージョンを指定するにはMACOSX_DEPLOYMENT_TARGETを使用します。例：14.0。

When targeting iOS, the default minimum version is 13.0. Use IPHONEOS_DEPLOYMENT_TARGET to specify a different minimum version, e.g., 14.0.iOSをターゲットにする場合、デフォルトの最小バージョンは13.0です。異なる最小バージョンを指定するにはIPHONEOS_DEPLOYMENT_TARGETを使用します。例：14.0。

When targeting Android, the default minimum Android API level is 24. Use ANDROID_API_LEVEL to specify a different minimum version, e.g., 26.Androidをターゲットにする場合、デフォルトの最小Android APIレベルは24です。異なる最小バージョンを指定するにはANDROID_API_LEVELを使用します。例：26。

WARNING: When specified, uv will select wheels that are compatible with the target platform; as a result, the installed distributions may not be compatible with the current platform. Conversely, any distributions that are built from source may be incompatible with the target platform, as they will be built for the current platform. The --python-platform option is intended for advanced use cases.警告: 指定された場合、uvはtargetプラットフォームと互換性のあるホイールを選択します。その結果、インストールされたディストリビューションはcurrentプラットフォームと互換性がない可能性があります。逆に、ソースからビルドされたディストリビューションはtargetプラットフォームと互換性がない可能性があります。なぜなら、それらはcurrentプラットフォーム用にビルドされるからです。--python-platformオプションは高度な使用ケースを想定しています。

Possible values:可能な値:

windows: An alias for x86_64-pc-windows-msvc, the default target for Windowswindows: x86_64-pc-windows-msvcのエイリアスで、Windowsのデフォルトターゲットです。
linux: An alias for x86_64-unknown-linux-gnu, the default target for Linuxlinux: x86_64-unknown-linux-gnuのエイリアスで、Linuxのデフォルトターゲットです。
macos: An alias for aarch64-apple-darwin, the default target for macOSmacos: aarch64-apple-darwinのエイリアスで、macOSのデフォルトターゲットです。
x86_64-pc-windows-msvc: A 64-bit x86 Windows targetx86_64-pc-windows-msvc: 64ビットx86 Windowsターゲットです。
aarch64-pc-windows-msvc: An ARM64 Windows targetaarch64-pc-windows-msvc: ARM64 Windowsターゲットです。
i686-pc-windows-msvc: A 32-bit x86 Windows targeti686-pc-windows-msvc: 32ビットx86 Windowsターゲットです。
x86_64-unknown-linux-gnu: An x86 Linux target. Equivalent to x86_64-manylinux_2_28x86_64-unknown-linux-gnu: x86 Linuxターゲットです。x86_64-manylinux_2_28と同等です。
aarch64-apple-darwin: An ARM-based macOS target, as seen on Apple Silicon devicesaarch64-apple-darwin: Apple Siliconデバイスで見られるARMベースのmacOSターゲットです。
x86_64-apple-darwin: An x86 macOS targetx86_64-apple-darwin: x86 macOSターゲットです。
aarch64-unknown-linux-gnu: An ARM64 Linux target. Equivalent to aarch64-manylinux_2_28aarch64-unknown-linux-gnu: ARM64 Linuxターゲットです。aarch64-manylinux_2_28と同等です。
aarch64-unknown-linux-musl: An ARM64 Linux targetaarch64-unknown-linux-musl: ARM64 Linux ターゲット
x86_64-unknown-linux-musl: An x86_64 Linux targetx86_64-unknown-linux-musl: x86_64 Linux ターゲット
riscv64-unknown-linux: A RISCV64 Linux targetriscv64-unknown-linux: RISCV64 Linux ターゲット
x86_64-manylinux2014: An x86_64 target for the manylinux2014 platform. Equivalent to x86_64-manylinux_2_17x86_64-manylinux2014: manylinux2014 プラットフォーム用の x86_64 ターゲット。 x86_64-manylinux_2_17 と同等
x86_64-manylinux_2_17: An x86_64 target for the manylinux_2_17 platformx86_64-manylinux_2_17: manylinux_2_17 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_28: An x86_64 target for the manylinux_2_28 platformx86_64-manylinux_2_28: manylinux_2_28 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_31: An x86_64 target for the manylinux_2_31 platformx86_64-manylinux_2_31: manylinux_2_31 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_32: An x86_64 target for the manylinux_2_32 platformx86_64-manylinux_2_32: manylinux_2_32 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_33: An x86_64 target for the manylinux_2_33 platformx86_64-manylinux_2_33: manylinux_2_33 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_34: An x86_64 target for the manylinux_2_34 platformx86_64-manylinux_2_34: manylinux_2_34 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_35: An x86_64 target for the manylinux_2_35 platformx86_64-manylinux_2_35: x86_64 ターゲットの manylinux_2_35 プラットフォーム
x86_64-manylinux_2_36: An x86_64 target for the manylinux_2_36 platformx86_64-manylinux_2_36: x86_64 ターゲットの manylinux_2_36 プラットフォーム
x86_64-manylinux_2_37: An x86_64 target for the manylinux_2_37 platformx86_64-manylinux_2_37: x86_64 ターゲットの manylinux_2_37 プラットフォーム
x86_64-manylinux_2_38: An x86_64 target for the manylinux_2_38 platformx86_64-manylinux_2_38: x86_64 ターゲットの manylinux_2_38 プラットフォーム
x86_64-manylinux_2_39: An x86_64 target for the manylinux_2_39 platformx86_64-manylinux_2_39: x86_64 ターゲットの manylinux_2_39 プラットフォーム
x86_64-manylinux_2_40: An x86_64 target for the manylinux_2_40 platformx86_64-manylinux_2_40: x86_64 ターゲットの manylinux_2_40 プラットフォーム
aarch64-manylinux2014: An ARM64 target for the manylinux2014 platform. Equivalent to aarch64-manylinux_2_17aarch64-manylinux2014: ARM64 ターゲットの manylinux2014 プラットフォーム。 aarch64-manylinux_2_17 と同等
aarch64-manylinux_2_17: An ARM64 target for the manylinux_2_17 platformaarch64-manylinux_2_17: ARM64 ターゲットの manylinux_2_17 プラットフォーム
aarch64-manylinux_2_28: An ARM64 target for the manylinux_2_28 platformaarch64-manylinux_2_28: ARM64 ターゲットの manylinux_2_28 プラットフォーム
aarch64-manylinux_2_31: An ARM64 target for the manylinux_2_31 platformaarch64-manylinux_2_31: ARM64 ターゲットの manylinux_2_31 プラットフォーム
aarch64-manylinux_2_32: An ARM64 target for the manylinux_2_32 platformaarch64-manylinux_2_32: manylinux_2_32 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_33: An ARM64 target for the manylinux_2_33 platformaarch64-manylinux_2_33: manylinux_2_33 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_34: An ARM64 target for the manylinux_2_34 platformaarch64-manylinux_2_34: manylinux_2_34 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_35: An ARM64 target for the manylinux_2_35 platformaarch64-manylinux_2_35: manylinux_2_35 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_36: An ARM64 target for the manylinux_2_36 platformaarch64-manylinux_2_36: manylinux_2_36 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_37: An ARM64 target for the manylinux_2_37 platformaarch64-manylinux_2_37: manylinux_2_37 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_38: An ARM64 target for the manylinux_2_38 platformaarch64-manylinux_2_38: manylinux_2_38 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_39: An ARM64 target for the manylinux_2_39 platformaarch64-manylinux_2_39: manylinux_2_39 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_40: An ARM64 target for the manylinux_2_40 platformaarch64-manylinux_2_40: manylinux_2_40 プラットフォーム用の ARM64 ターゲット
aarch64-linux-android: An ARM64 Android targetaarch64-linux-android: ARM64 Android ターゲット
x86_64-linux-android: An x86_64 Android targetx86_64-linux-android: x86_64 Android ターゲット
wasm32-pyodide2024: A wasm32 target using the Pyodide 2024 platform. Meant for use with Python 3.12wasm32-pyodide2024: Pyodide 2024 プラットフォームを使用した wasm32 ターゲット。Python 3.12 と共に使用することを意図しています。
arm64-apple-ios: An ARM64 target for iOS devicearm64-apple-ios: iOS デバイス用の ARM64 ターゲット
arm64-apple-ios-simulator: An ARM64 target for iOS simulatorarm64-apple-ios-simulator: iOS シミュレーター用の ARM64 ターゲット
x86_64-apple-ios-simulator: An x86_64 target for iOS simulatorx86_64-apple-ios-simulator: iOS シミュレーター用の x86_64 ターゲット

--python-version python-version--python-version python-version

The minimum Python version that should be supported by the requirements (e.g., 3.7 or 3.7.9).要件によってサポートされるべき最小の Python バージョン（例: 3.7 または 3.7.9）。

If a patch version is omitted, the minimum patch version is assumed. For example, 3.7 is mapped to 3.7.0.パッチバージョンが省略された場合、最小のパッチバージョンが仮定されます。例えば、3.7 は 3.7.0 にマッピングされます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uvはstdoutに出力を行わないサイレントモードを有効にします。

--refresh--refresh

Refresh all cached dataすべてのキャッシュデータを更新します

--refresh-package refresh-package--refresh-package refresh-package

Refresh cached data for a specific package特定のパッケージのキャッシュデータを更新します

--reinstall, --force-reinstall--reinstall, --force-reinstall

Reinstall all packages, regardless of whether they're already installed. Implies --refreshすべてのパッケージを再インストールします。すでにインストールされているかどうかに関わらず。--refreshを含意します。

--reinstall-package reinstall-package--reinstall-package reinstall-package

Reinstall a specific package, regardless of whether it's already installed. Implies --refresh-package特定のパッケージを再インストールします。すでにインストールされているかどうかに関わらず。--refresh-packageを含意します。

--require-hashes--require-hashes

Require a matching hash for each requirement.各要件に対して一致するハッシュが必要です。

By default, uv will verify any available hashes in the requirements file, but will not require that all requirements have an associated hash.デフォルトでは、uvは要件ファイル内の利用可能なハッシュを検証しますが、すべての要件に関連付けられたハッシュが必要とはしません。

When --require-hashes is enabled, all requirements must include a hash or set of hashes, and all requirements must either be pinned to exact versions (e.g., ==1.0.0), or be specified via direct URL.--require-hashesが有効な場合、すべての要件にはハッシュまたはハッシュのセットが含まれている必要があり、すべての要件は正確なバージョンに固定される必要があります（例：==1.0.0）、または直接URLで指定される必要があります。

Hash-checking mode introduces a number of additional constraints:ハッシュチェックモードは、いくつかの追加の制約を導入します：

Git dependencies are not supported. - Editable installations are not supported. - Local dependencies are not supported, unless they point to a specific wheel (.whl) or source archive (.zip, .tar.gz), as opposed to a directory.Git依存関係はサポートされていません。 - 編集可能なインストールはサポートされていません。 - ローカル依存関係は、特定のホイール（.whl）またはソースアーカイブ（.zip、.tar.gz）を指す場合を除き、サポートされていません。

May also be set with the UV_REQUIRE_HASHES environment variable.UV_REQUIRE_HASHES環境変数でも設定できます。

--strict--strict

Validate the Python environment after completing the installation, to detect packages with missing dependencies or other issuesインストール完了後にPython環境を検証し、依存関係が欠けているパッケージやその他の問題を検出します。

--system--system

Install packages into the system Python environment.パッケージをシステムPython環境にインストールします。

By default, uv installs into the virtual environment in the current working directory or any parent directory. The --system option instructs uv to instead use the first Python found in the system PATH.デフォルトでは、uvは現在の作業ディレクトリまたは親ディレクトリの仮想環境にインストールされます。--systemオプションは、uvにシステムのPATHで見つかった最初のPythonを使用するよう指示します。

WARNING: --system is intended for use in continuous integration (CI) environments and should be used with caution, as it can modify the system Python installation.警告: --systemは継続的インテグレーション（CI）環境での使用を目的としており、システムのPythonインストールを変更する可能性があるため、注意して使用する必要があります。

May also be set with the UV_SYSTEM_PYTHON environment variable.UV_SYSTEM_PYTHON環境変数で設定することもできます。

--target target--target target

Install packages into the specified directory, rather than into the virtual or system Python environment. The packages will be installed at the top-level of the directory.指定されたディレクトリにパッケージをインストールします。仮想環境やシステムPython環境ではなく、ディレクトリのトップレベルにパッケージがインストールされます。

Unlike other install operations, this command does not require discovery of an existing Python environment and only searches for a Python interpreter to use for package resolution. If a suitable Python interpreter cannot be found, uv will install one. To disable this, add --no-python-downloads.他のインストール操作とは異なり、このコマンドは既存のPython環境の発見を必要とせず、パッケージ解決に使用するPythonインタプリタを検索するだけです。適切なPythonインタプリタが見つからない場合、uvは1つをインストールします。これを無効にするには、--no-python-downloadsを追加します。

--torch-backend torch-backend--torch-backend torch-backend

The backend to use when fetching packages in the PyTorch ecosystem (e.g., cpu, cu126, or auto).PyTorchエコシステムでパッケージを取得する際に使用するバックエンド（例: cpu, cu126, または auto）。

When set, uv will ignore the configured index URLs for packages in the PyTorch ecosystem, and will instead use the defined backend.設定されている場合、uvはPyTorchエコシステムのパッケージに対して構成されたインデックスURLを無視し、定義されたバックエンドを使用します。

For example, when set to cpu, uv will use the CPU-only PyTorch index; when set to cu126, uv will use the PyTorch index for CUDA 12.6.例えば、cpuに設定されている場合、uvはCPU専用のPyTorchインデックスを使用します。cu126に設定されている場合、uvはCUDA 12.6用のPyTorchインデックスを使用します。

The auto mode will attempt to detect the appropriate PyTorch index based on the currently installed CUDA drivers.この auto モードは、現在インストールされているCUDAドライバに基づいて適切なPyTorchインデックスを検出しようとします。

This option is in preview and may change in any future release.このオプションはプレビュー中であり、今後のリリースで変更される可能性があります。

May also be set with the UV_TORCH_BACKEND environment variable.UV_TORCH_BACKEND 環境変数を使用して設定することもできます。

Possible values:可能な値：

auto: Select the appropriate PyTorch index based on the operating system and CUDA driver versionauto: オペレーティングシステムとCUDAドライバのバージョンに基づいて適切なPyTorchインデックスを選択します。
cpu: Use the CPU-only PyTorch indexcpu: CPU専用のPyTorchインデックスを使用します。
cu130: Use the PyTorch index for CUDA 13.0cu130: CUDA 13.0用のPyTorchインデックスを使用します。
cu129: Use the PyTorch index for CUDA 12.9cu129: CUDA 12.9用のPyTorchインデックスを使用します。
cu128: Use the PyTorch index for CUDA 12.8cu128: CUDA 12.8用のPyTorchインデックスを使用します。
cu126: Use the PyTorch index for CUDA 12.6cu126: CUDA 12.6用のPyTorchインデックスを使用します。
cu125: Use the PyTorch index for CUDA 12.5cu125: CUDA 12.5 のための PyTorch インデックスを使用します
cu124: Use the PyTorch index for CUDA 12.4cu124: CUDA 12.4 のための PyTorch インデックスを使用します
cu123: Use the PyTorch index for CUDA 12.3cu123: CUDA 12.3 のための PyTorch インデックスを使用します
cu122: Use the PyTorch index for CUDA 12.2cu122: CUDA 12.2 のための PyTorch インデックスを使用します
cu121: Use the PyTorch index for CUDA 12.1cu121: CUDA 12.1 のための PyTorch インデックスを使用します
cu120: Use the PyTorch index for CUDA 12.0cu120: CUDA 12.0 のための PyTorch インデックスを使用します
cu118: Use the PyTorch index for CUDA 11.8cu118: CUDA 11.8 のための PyTorch インデックスを使用します
cu117: Use the PyTorch index for CUDA 11.7cu117: CUDA 11.7 のための PyTorch インデックスを使用します
cu116: Use the PyTorch index for CUDA 11.6cu116: CUDA 11.6 のための PyTorch インデックスを使用します
cu115: Use the PyTorch index for CUDA 11.5cu115: CUDA 11.5 のための PyTorch インデックスを使用します
cu114: Use the PyTorch index for CUDA 11.4cu114: CUDA 11.4 のための PyTorch インデックスを使用します
cu113: Use the PyTorch index for CUDA 11.3cu113: CUDA 11.3 のための PyTorch インデックスを使用します
cu112: Use the PyTorch index for CUDA 11.2cu112: CUDA 11.2 のための PyTorch インデックスを使用します
cu111: Use the PyTorch index for CUDA 11.1cu111: CUDA 11.1 のための PyTorch インデックスを使用します
cu110: Use the PyTorch index for CUDA 11.0cu110: CUDA 11.0 のための PyTorch インデックスを使用します
cu102: Use the PyTorch index for CUDA 10.2cu102: CUDA 10.2 のための PyTorch インデックスを使用します
cu101: Use the PyTorch index for CUDA 10.1cu101: CUDA 10.1 のための PyTorch インデックスを使用します
cu100: Use the PyTorch index for CUDA 10.0cu100: CUDA 10.0 のための PyTorch インデックスを使用します
cu92: Use the PyTorch index for CUDA 9.2cu92: CUDA 9.2 のための PyTorch インデックスを使用します
cu91: Use the PyTorch index for CUDA 9.1cu91: CUDA 9.1 のための PyTorch インデックスを使用します
cu90: Use the PyTorch index for CUDA 9.0cu90: CUDA 9.0 用の PyTorch インデックスを使用します
cu80: Use the PyTorch index for CUDA 8.0cu80: CUDA 8.0 用の PyTorch インデックスを使用します
rocm6.3: Use the PyTorch index for ROCm 6.3rocm6.3: ROCm 6.3 用の PyTorch インデックスを使用します
rocm6.2.4: Use the PyTorch index for ROCm 6.2.4rocm6.2.4: ROCm 6.2.4 用の PyTorch インデックスを使用します
rocm6.2: Use the PyTorch index for ROCm 6.2rocm6.2: ROCm 6.2 用の PyTorch インデックスを使用します
rocm6.1: Use the PyTorch index for ROCm 6.1rocm6.1: ROCm 6.1 用の PyTorch インデックスを使用します
rocm6.0: Use the PyTorch index for ROCm 6.0rocm6.0: ROCm 6.0 用の PyTorch インデックスを使用します
rocm5.7: Use the PyTorch index for ROCm 5.7rocm5.7: ROCm 5.7 用の PyTorch インデックスを使用します
rocm5.6: Use the PyTorch index for ROCm 5.6rocm5.6: ROCm 5.6 用の PyTorch インデックスを使用します
rocm5.5: Use the PyTorch index for ROCm 5.5rocm5.5: ROCm 5.5 用の PyTorch インデックスを使用します
rocm5.4.2: Use the PyTorch index for ROCm 5.4.2rocm5.4.2: ROCm 5.4.2のためのPyTorchインデックスを使用します
rocm5.4: Use the PyTorch index for ROCm 5.4rocm5.4: ROCm 5.4のためのPyTorchインデックスを使用します
rocm5.3: Use the PyTorch index for ROCm 5.3rocm5.3: ROCm 5.3のためのPyTorchインデックスを使用します
rocm5.2: Use the PyTorch index for ROCm 5.2rocm5.2: ROCm 5.2のためのPyTorchインデックスを使用します
rocm5.1.1: Use the PyTorch index for ROCm 5.1.1rocm5.1.1: ROCm 5.1.1のためのPyTorchインデックスを使用します
rocm4.2: Use the PyTorch index for ROCm 4.2rocm4.2: ROCm 4.2のためのPyTorchインデックスを使用します
rocm4.1: Use the PyTorch index for ROCm 4.1rocm4.1: ROCm 4.1のためのPyTorchインデックスを使用します
rocm4.0.1: Use the PyTorch index for ROCm 4.0.1rocm4.0.1: ROCm 4.0.1のためのPyTorchインデックスを使用します
xpu: Use the PyTorch index for Intel XPUxpu: Intel XPUのためのPyTorchインデックスを使用します

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)RUST_LOG 環境変数を使用して、細かいログ記録を構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv pip installuv pip install

Install packages into an environment環境にパッケージをインストールします

Usage使用法

uv pip install [OPTIONS] <PACKAGE|--requirements <REQUIREMENTS>|--editable <EDITABLE>|--group <GROUP>>

Arguments引数

PACKAGEPACKAGE

Install all listed packages.リストされたすべてのパッケージをインストールします。

The order of the packages is used to determine priority during resolution.パッケージの順序は、解決中の優先順位を決定するために使用されます。

Optionsオプション

--all-extras--all-extras

Include all optional dependencies.すべてのオプション依存関係を含めます。

Only applies to pylock.toml, pyproject.toml, setup.py, and setup.cfg sources.pylock.toml、pyproject.toml、setup.py、および setup.cfg ソースにのみ適用されます。

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host、--trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告: このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、検証されたソースを持つ安全なネットワーク内でのみ使用してください。これはSSL検証をバイパスし、MITM攻撃にさらされる可能性があります。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST 環境変数で設定することもできます。

--break-system-packages--break-system-packages

Allow uv to modify an EXTERNALLY-MANAGED Python installation.uvがEXTERNALLY-MANAGEDのPythonインストールを変更できるようにします。

WARNING: --break-system-packages is intended for use in continuous integration (CI) environments, when installing into Python installations that are managed by an external package manager, like apt. It should be used with caution, as such Python installations explicitly recommend against modifications by other package managers (like uv or pip).WARNING: --break-system-packagesは、aptのような外部パッケージマネージャによって管理されているPythonインストールにインストールする際の継続的インテグレーション（CI）環境での使用を目的としています。他のパッケージマネージャ（uvやpipなど）による変更を明示的に推奨しないため、注意して使用する必要があります。

May also be set with the UV_BREAK_SYSTEM_PACKAGES environment variable.UV_BREAK_SYSTEM_PACKAGES環境変数でも設定できます。

--build-constraints, --build-constraint, -b build-constraints--build-constraints, --build-constraint, -b build-constraints

Constrain build dependencies using the given requirements files when building source distributions.ソース配布をビルドする際に、指定された要件ファイルを使用してビルド依存関係を制約します。

Constraints files are requirements.txt-like files that only control the version of a requirement that's installed. However, including a package in a constraints file will not trigger the installation of that package.制約ファイルは、インストールされる要件のバージョンのみを制御するrequirements.txtのようなファイルです。ただし、制約ファイルにパッケージを含めても、そのパッケージのインストールはトリガーされません。

May also be set with the UV_BUILD_CONSTRAINT environment variable.UV_BUILD_CONSTRAINT環境変数でも設定できます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvにデフォルト設定され、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されます。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数を使用して設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力の色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末に書き込む際に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力がサポートされている端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--compile-bytecode, --compile--compile-bytecode, --compile

Compile Python files to bytecode after installation.インストール後にPythonファイルをバイトコードにコンパイルします。

By default, uv does not compile Python (.py) files to bytecode (__pycache__/*.pyc); instead, compilation is performed lazily the first time a module is imported. For use-cases in which start time is critical, such as CLI applications and Docker containers, this option can be enabled to trade longer installation times for faster start times.デフォルトでは、uvはPython（.py）ファイルをバイトコード（__pycache__/*.pyc）にコンパイルしません。代わりに、モジュールが初めてインポートされるときに遅延的にコンパイルが行われます。CLIアプリケーションやDockerコンテナなど、起動時間が重要なユースケースでは、このオプションを有効にすることで、より長いインストール時間と引き換えに、より速い起動時間を得ることができます。

When enabled, uv will process the entire site-packages directory (including packages that are not being modified by the current operation) for consistency. Like pip, it will also ignore errors.有効にすると、uvは整合性のためにサイトパッケージディレクトリ全体（現在の操作によって変更されていないパッケージを含む）を処理します。pipと同様に、エラーは無視されます。

May also be set with the UV_COMPILE_BYTECODE environment variable.また、UV_COMPILE_BYTECODE環境変数で設定することもできます。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.uv.tomlファイルのパスを設定に使用します。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.また、UV_CONFIG_FILE環境変数で設定することもできます。

--config-setting, --config-settings, -C config-setting--config-setting, --config-settings, -C config-setting

Settings to pass to the PEP 517 build backend, specified as KEY=VALUE pairsPEP 517ビルドバックエンドに渡す設定で、KEY=VALUEペアとして指定します。

--config-settings-package, --config-settings-package config-settings-package--config-settings-package, --config-settings-package config-settings-package

Settings to pass to the PEP 517 build backend for a specific package, specified as PACKAGE:KEY=VALUE pairs特定のパッケージのためにPEP 517ビルドバックエンドに渡す設定で、PACKAGE:KEY=VALUEペアとして指定されます。

--constraints, --constraint, -c constraints--constraints, --constraint, -c constraints

Constrain versions using the given requirements files.指定された要件ファイルを使用してバージョンを制約します。

Constraints files are requirements.txt-like files that only control the version of a requirement that's installed. However, including a package in a constraints file will not trigger the installation of that package.制約ファイルは、インストールされる要件のバージョンのみを制御するrequirements.txtのようなファイルです。ただし、制約ファイルにパッケージを含めても、そのパッケージのインストールはトリガーされません。

This is equivalent to pip's --constraint option.これはpipの--constraintオプションと同等です。

May also be set with the UV_CONSTRAINT environment variable.UV_CONSTRAINT環境変数でも設定できます。

--default-index default-index--default-index default-index

The URL of the default package index (by default: https://pypi.org/simple).デフォルトのパッケージインデックスのURL（デフォルトでは: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリまたは同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --index flag.このフラグで指定されたインデックスは、--indexフラグで指定された他のすべてのインデックスよりも低い優先度が与えられます。

May also be set with the UV_DEFAULT_INDEX environment variable.UV_DEFAULT_INDEX環境変数でも設定できます。

--directory directory--directory ディレクトリ

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数でも設定できます。

--dry-run--dry-run

Perform a dry run, i.e., don't actually install anything but resolve the dependencies and print the resulting planドライランを実行します。つまり、実際には何もインストールせず、依存関係を解決して結果の計画を表示します。

--editable, -e editable--editable, -e 編集可能

Install the editable package based on the provided local file path提供されたローカルファイルパスに基づいて、編集可能なパッケージをインストールします。

--exact--exact

Perform an exact sync, removing extraneous packages.余分なパッケージを削除して、正確な同期を行います。

By default, installing will make the minimum necessary changes to satisfy the requirements. When enabled, uv will update the environment to exactly match the requirements, removing packages that are not included in the requirements.デフォルトでは、インストールは要件を満たすために必要最小限の変更を行います。有効にすると、uvは要件に正確に一致するように環境を更新し、要件に含まれていないパッケージを削除します。

--exclude-newer exclude-newer--exclude-newer exclude-newer

Limit candidate packages to those that were uploaded prior to the given date.候補パッケージを、指定された日付以前にアップロードされたものに制限します。

Accepts both RFC 3339 timestamps (e.g., 2006-12-02T02:07:43Z) and local dates in the same format (e.g., 2006-12-02) in your system's configured time zone.RFC 3339 タイムスタンプ（例：2006-12-02T02:07:43Z）と、システムの設定されたタイムゾーンでの同じ形式のローカル日付（例：2006-12-02）の両方を受け入れます。

May also be set with the UV_EXCLUDE_NEWER environment variable.UV_EXCLUDE_NEWER 環境変数で設定することもできます。

--exclude-newer-package exclude-newer-package--exclude-newer-package exclude-newer-package

Limit candidate packages for specific packages to those that were uploaded prior to the given date.特定のパッケージの候補パッケージを、指定された日付以前にアップロードされたものに制限します。

Accepts package-date pairs in the format PACKAGE=DATE, where DATE is an RFC 3339 timestamp (e.g., 2006-12-02T02:07:43Z) or local date (e.g., 2006-12-02) in your system's configured time zone.パッケージ-日付ペアをPACKAGE=DATEの形式で受け入れます。ここで、DATEはRFC 3339タイムスタンプ（例：2006-12-02T02:07:43Z）またはローカル日付（例：2006-12-02）で、システムの設定されたタイムゾーンに基づいています。

Can be provided multiple times for different packages.異なるパッケージのために複数回提供できます。

--excludes, --exclude excludes--excludes, --exclude excludes

Exclude packages from resolution using the given requirements files.指定された要件ファイルを使用して、解決からパッケージを除外します。

Excludes files are requirements.txt-like files that specify packages to exclude from the resolution. When a package is excluded, it will be omitted from the dependency list entirely and its own dependencies will be ignored during the resolution phase. Excludes are unconditional in that requirement specifiers and markers are ignored; any package listed in the provided file will be omitted from all resolved environments.除外ファイルは、解決から除外するパッケージを指定するrequirements.txtのようなファイルです。パッケージが除外されると、その依存関係リストから完全に省略され、解決フェーズ中にその依存関係は無視されます。除外は無条件であり、要件指定子やマーカーは無視されます。提供されたファイルにリストされたパッケージは、すべての解決された環境から省略されます。

May also be set with the UV_EXCLUDE environment variable.UV_EXCLUDE環境変数でも設定できます。

--extra extra--extra extra

Include optional dependencies from the specified extra name; may be provided more than once.指定された追加名からオプションの依存関係を含めます。複数回提供することができます。

Only applies to pylock.toml, pyproject.toml, setup.py, and setup.cfg sources.これはpylock.toml、pyproject.toml、setup.py、およびsetup.cfgソースにのみ適用されます。

--extra-index-url extra-index-url--extra-index-url extra-index-url

(Deprecated: use --index instead) Extra URLs of package indexes to use, in addition to --index-url.(非推奨: 代わりに --index を使用してください) --index-url に加えて使用するパッケージインデックスの追加URL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式で配置されたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --index-url (which defaults to PyPI). When multiple --extra-index-url flags are provided, earlier values take priority.このフラグを介して提供されたすべてのインデックスは、--index-url（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の --extra-index-url フラグが提供される場合、先に指定された値が優先されます。

May also be set with the UV_EXTRA_INDEX_URL environment variable.UV_EXTRA_INDEX_URL 環境変数を使用して設定することもできます。

--find-links, -f find-links--find-links, -f find-links

Locations to search for candidate distributions, in addition to those found in the registry indexes.レジストリインデックスで見つかったものに加えて、候補の配布物を検索する場所。

If a path, the target must be a directory that contains packages as wheel files (.whl) or source distributions (e.g., .tar.gz or .zip) at the top level.パスの場合、ターゲットはトップレベルにホイールファイル（.whl）またはソース配布（例: .tar.gz または .zip）を含むディレクトリでなければなりません。

If a URL, the page must contain a flat list of links to package files adhering to the formats described above.URLの場合、ページは上記の形式に従ったパッケージファイルへのリンクのフラットリストを含む必要があります。

May also be set with the UV_FIND_LINKS environment variable.UV_FIND_LINKS 環境変数を使用して設定することもできます。

--fork-strategy fork-strategy--fork-strategy fork-strategy

The strategy to use when selecting multiple versions of a given package across Python versions and platforms.特定のパッケージの複数のバージョンをPythonのバージョンやプラットフォームにわたって選択する際に使用する戦略。

By default, uv will optimize for selecting the latest version of each package for each supported Python version (requires-python), while minimizing the number of selected versions across platforms.デフォルトでは、uvは各サポートされているPythonバージョン（requires-python）ごとに各パッケージの最新バージョンを選択するよう最適化し、プラットフォーム間で選択されたバージョンの数を最小限に抑えます。

Under fewest, uv will minimize the number of selected versions for each package, preferring older versions that are compatible with a wider range of supported Python versions or platforms.fewestの下では、uvは各パッケージの選択されたバージョンの数を最小限に抑え、より広範囲のサポートされているPythonバージョンやプラットフォームと互換性のある古いバージョンを優先します。

May also be set with the UV_FORK_STRATEGY environment variable.UV_FORK_STRATEGY環境変数で設定することもできます。

Possible values:可能な値：

fewest: Optimize for selecting the fewest number of versions for each package. Older versions may be preferred if they are compatible with a wider range of supported Python versions or platformsfewest: 各パッケージの選択されたバージョンの数を最小限に抑えるよう最適化します。より広範囲のサポートされているPythonバージョンやプラットフォームと互換性がある場合、古いバージョンが優先されることがあります。
requires-python: Optimize for selecting latest supported version of each package, for each supported Python versionrequires-python: 各サポートされているPythonバージョンごとに各パッケージの最新のサポートバージョンを選択するよう最適化します。

--group group--group group

Install the specified dependency group from a pylock.toml or pyproject.toml.pylock.tomlまたはpyproject.tomlから指定された依存関係グループをインストールします。

If no path is provided, the pylock.toml or pyproject.toml in the working directory is used.パスが提供されていない場合、作業ディレクトリ内のpylock.tomlまたはpyproject.tomlが使用されます。

May be provided multiple times.複数回提供される場合があります。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します

--index index--index index

The URLs to use when resolving dependencies, in addition to the default index.デフォルトのインデックスに加えて、依存関係を解決するために使用するURL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式で配置されたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --default-index (which defaults to PyPI). When multiple --index flags are provided, earlier values take priority.このフラグで提供されたすべてのインデックスは、--default-index（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の--indexフラグが提供された場合、先に指定された値が優先されます。

Index names are not supported as values. Relative paths must be disambiguated from index names with ./ or ../ on Unix or .\\, ..\\, ./ or ../ on Windows.インデックス名は値としてサポートされていません。相対パスは、Unixでは./または../、Windowsでは.\\、..\\、./または../でインデックス名と区別する必要があります。

May also be set with the UV_INDEX environment variable.UV_INDEX環境変数で設定することもできます。

--index-strategy index-strategy--index-strategy index-strategy

The strategy to use when resolving against multiple index URLs.複数のインデックスURLに対して解決する際に使用する戦略。

By default, uv will stop at the first index on which a given package is available, and limit resolutions to those present on that first index (first-index). This prevents "dependency confusion" attacks, whereby an attacker can upload a malicious package under the same name to an alternate index.デフォルトでは、uvは指定されたパッケージが利用可能な最初のインデックスで停止し、その最初のインデックス（first-index）に存在するものに解決を制限します。これにより、攻撃者が別のインデックスに同じ名前の悪意のあるパッケージをアップロードできる「依存関係の混乱」攻撃を防ぎます。

May also be set with the UV_INDEX_STRATEGY environment variable.UV_INDEX_STRATEGY環境変数で設定することもできます。

Possible values:可能な値：

first-index: Only use results from the first index that returns a match for a given package namefirst-index: 指定されたパッケージ名に対して一致を返す最初のインデックスからの結果のみを使用します。
unsafe-first-match: Search for every package name across all indexes, exhausting the versions from the first index before moving on to the nextunsafe-first-match: すべてのインデックスで各パッケージ名を検索し、次のインデックスに移動する前に最初のインデックスからのバージョンを使い果たします。
unsafe-best-match: Search for every package name across all indexes, preferring the "best" version found. If a package version is in multiple indexes, only look at the entry for the first indexunsafe-best-match: すべてのインデックスで各パッケージ名を検索し、見つかった「最良」のバージョンを優先します。パッケージバージョンが複数のインデックスに存在する場合、最初のインデックスのエントリのみを見ます。

--index-url, -i index-url--index-url, -i index-url

(Deprecated: use --default-index instead) The URL of the Python package index (by default: https://pypi.org/simple).(非推奨: 代わりに--default-indexを使用してください) PythonパッケージインデックスのURL（デフォルト: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリのいずれかを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --extra-index-url flag.このフラグによって指定されたインデックスは、--extra-index-urlフラグを介して指定された他のすべてのインデックスよりも低い優先度が与えられます。

May also be set with the UV_INDEX_URL environment variable.UV_INDEX_URL環境変数を使用して設定することもできます。

--keyring-provider keyring-provider--keyring-provider keyring-provider

Attempt to use keyring for authentication for index URLs.インデックスURLの認証にkeyringを使用しようとします。

At present, only --keyring-provider subprocess is supported, which configures uv to use the keyring CLI to handle authentication.現在のところ、--keyring-provider subprocessのみがサポートされており、これはuvが認証を処理するためにkeyring CLIを使用するように構成します。

Defaults to disabled.デフォルトはdisabledです。

May also be set with the UV_KEYRING_PROVIDER environment variable.UV_KEYRING_PROVIDER環境変数を使用して設定することもできます。

Possible values:可能な値：

disabled: Do not use keyring for credential lookupdisabled: 認証情報の検索にkeyringを使用しない
subprocess: Use the keyring command for credential lookupsubprocess: 認証情報の検索にkeyringコマンドを使用する

--link-mode link-mode--link-mode リンクモード

The method to use when installing packages from the global cache.グローバルキャッシュからパッケージをインストールする際に使用する方法。

Defaults to clone (also known as Copy-on-Write) on macOS, and hardlink on Linux and Windows.macOSではclone（コピーオンライトとも呼ばれる）がデフォルトで使用され、LinuxおよびWindowsではhardlinkがデフォルトです。

WARNING: The use of symlink link mode is discouraged, as they create tight coupling between the cache and the target environment. For example, clearing the cache (uv cache clean) will break all installed packages by way of removing the underlying source files. Use symlinks with caution.警告: シンボリックリンクモードの使用は推奨されません。これはキャッシュとターゲット環境の間に強い結合を生じさせるためです。たとえば、キャッシュをクリアすること（uv cache clean）は、基盤となるソースファイルを削除することによってすべてのインストールされたパッケージを壊します。シンボリックリンクは注意して使用してください。

May also be set with the UV_LINK_MODE environment variable.UV_LINK_MODE 環境変数で設定することもできます。

Possible values:可能な値:

clone: Clone (i.e., copy-on-write) packages from the wheel into the site-packages directoryclone: ホイールからsite-packagesディレクトリにパッケージをクローン（すなわち、コピーオンライト）します。
copy: Copy packages from the wheel into the site-packages directorycopy: ホイールからsite-packagesディレクトリにパッケージをコピーします。
hardlink: Hard link packages from the wheel into the site-packages directoryhardlink: ホイールからsite-packagesディレクトリにパッケージをハードリンクします。
symlink: Symbolically link packages from the wheel into the site-packages directorysymlink: ホイールからsite-packagesディレクトリにパッケージをシンボリックリンクします。

--managed-python--managed-python

Require use of uv-managed Python versions.uvが管理するPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンを使用することを好みます。ただし、uvが管理するPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON 環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、特にシステムの証明書ストアに含まれる企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したいことがあります。

May also be set with the UV_NATIVE_TLS environment variable.UV_NATIVE_TLS 環境変数でも設定できます。

--no-binary no-binary--no-binary no-binary

Don't install pre-built wheels.事前にビルドされたホイールをインストールしないでください。

The given packages will be built and installed from source. The resolver will still use pre-built wheels to extract package metadata, if available.指定されたパッケージはソースからビルドされ、インストールされます。リゾルバーは、利用可能な場合、パッケージメタデータを抽出するために事前にビルドされたホイールを使用します。

Multiple packages may be provided. Disable binaries for all packages with :all:. Clear previously specified packages with :none:.複数のパッケージを指定できます。すべてのパッケージのバイナリを無効にするには:all:を使用します。以前に指定したパッケージをクリアするには:none:を使用します。

--no-break-system-packages--no-break-system-packages

--no-build--no-build

Don't build source distributions.ソース配布物をビルドしないでください。

When enabled, resolving will not run arbitrary Python code. The cached wheels of already-built source distributions will be reused, but operations that require building distributions will exit with an error.有効にすると、リゾルビングは任意のPythonコードを実行しません。すでにビルドされたソース配布物のキャッシュされたホイールは再利用されますが、配布物のビルドを必要とする操作はエラーで終了します。

Alias for --only-binary :all:.--only-binary :all:のエイリアスです。

--no-build-isolation--no-build-isolation

Disable isolation when building source distributions.ソース配布物をビルドする際の隔離を無効にします。

Assumes that build dependencies specified by PEP 518 are already installed.PEP 518で指定されたビルド依存関係がすでにインストールされていることを前提とします。

May also be set with the UV_NO_BUILD_ISOLATION environment variable.環境変数 UV_NO_BUILD_ISOLATION でも設定できます。

--no-build-isolation-package no-build-isolation-package--no-build-isolation-package no-build-isolation-package

Disable isolation when building source distributions for a specific package.特定のパッケージのソース配布物をビルドする際に、隔離を無効にします。

Assumes that the packages' build dependencies specified by PEP 518 are already installed.パッケージのビルド依存関係がPEP 518で指定されていることを前提とします。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.環境変数 UV_NO_CACHE でも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml, uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.また、UV_NO_CONFIG 環境変数で設定することもできます。

--no-deps--no-deps

Ignore package dependencies, instead only installing those packages explicitly listed on the command line or in the requirements filesパッケージの依存関係を無視し、コマンドラインまたは要件ファイルに明示的にリストされたパッケージのみをインストールします。

--no-index--no-index

Ignore the registry index (e.g., PyPI), instead relying on direct URL dependencies and those provided via --find-linksレジストリインデックス（例：PyPI）を無視し、代わりに直接URL依存関係および--find-linksを介して提供されるものに依存します。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.その代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.また、UV_NO_MANAGED_PYTHON 環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS 環境変数を使用して設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--no-sources--no-sources

Ignore the tool.uv.sources table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any workspace, Git, URL, or local path sourcestool.uv.sources テーブルを無視して依存関係を解決します。ワークスペース、Git、URL、またはローカルパスソースを使用するのではなく、標準準拠の公開可能なパッケージメタデータに対してロックするために使用されます。

May also be set with the UV_NO_SOURCES environment variable.UV_NO_SOURCES 環境変数を使用して設定することもできます。

--no-verify-hashes--no-verify-hashes

Disable validation of hashes in the requirements file.requirementsファイル内のハッシュの検証を無効にします。

By default, uv will verify any available hashes in the requirements file, but will not require that all requirements have an associated hash. To enforce hash validation, use --require-hashes.デフォルトでは、uvはrequirementsファイル内の利用可能なハッシュを検証しますが、すべての要件に関連付けられたハッシュが必要であるとは限りません。ハッシュ検証を強制するには、--require-hashesを使用してください。

May also be set with the UV_NO_VERIFY_HASHES environment variable.UV_NO_VERIFY_HASHES環境変数を使用して設定することもできます。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE環境変数を使用して設定することもできます。

--only-binary only-binary--only-binary only-binary

Only use pre-built wheels; don't build source distributions.事前にビルドされたホイールのみを使用します。ソース配布物をビルドしません。

When enabled, resolving will not run code from the given packages. The cached wheels of already-built source distributions will be reused, but operations that require building distributions will exit with an error.有効にすると、解決時に指定されたパッケージからコードが実行されません。すでにビルドされたソース配布物のキャッシュされたホイールが再利用されますが、配布物のビルドを必要とする操作はエラーで終了します。

Multiple packages may be provided. Disable binaries for all packages with :all:. Clear previously specified packages with :none:.複数のパッケージが提供される場合があります。すべてのパッケージのバイナリを無効にするには :all: を使用します。以前に指定したパッケージをクリアするには :none: を使用します。

--overrides, --override overrides--overrides, --override overrides

Override versions using the given requirements files.指定された要件ファイルを使用してバージョンを上書きします。

Overrides files are requirements.txt-like files that force a specific version of a requirement to be installed, regardless of the requirements declared by any constituent package, and regardless of whether this would be considered an invalid resolution.Overridesファイルは requirements.txt に似たファイルで、構成パッケージによって宣言された要件に関係なく、特定の要件のバージョンを強制的にインストールします。これが無効な解決と見なされるかどうかに関係なく、インストールされます。

While constraints are additive, in that they're combined with the requirements of the constituent packages, overrides are absolute, in that they completely replace the requirements of the constituent packages.制約は構成パッケージの要件と組み合わされるため 加算的 ですが、オーバーライドは構成パッケージの要件を完全に置き換えるため 絶対的 です。

May also be set with the UV_OVERRIDE environment variable.UV_OVERRIDE 環境変数を使用しても設定できます。

--prefix prefix--prefix prefix

Install packages into lib, bin, and other top-level folders under the specified directory, as if a virtual environment were present at that location.指定されたディレクトリの下にある lib、bin、およびその他のトップレベルフォルダーにパッケージをインストールします。まるでその場所に仮想環境が存在するかのように。

In general, prefer the use of --python to install into an alternate environment, as scripts and other artifacts installed via --prefix will reference the installing interpreter, rather than any interpreter added to the --prefix directory, rendering them non-portable.一般的に、代替環境にインストールするには --python の使用を優先してください。--prefix を介してインストールされたスクリプトやその他のアーティファクトは、--prefix ディレクトリに追加されたインタプリタではなく、インストール中のインタプリタを参照するため、ポータブルではなくなります。

Unlike other install operations, this command does not require discovery of an existing Python environment and only searches for a Python interpreter to use for package resolution. If a suitable Python interpreter cannot be found, uv will install one. To disable this, add --no-python-downloads.他のインストール操作とは異なり、このコマンドは既存のPython環境の発見を必要とせず、パッケージ解決に使用するPythonインタプリタを検索するだけです。適切なPythonインタプリタが見つからない場合、uvは1つをインストールします。これを無効にするには、--no-python-downloads を追加します。

--prerelease prerelease--prerelease プレリリース

The strategy to use when considering pre-release versions.プレリリースバージョンを考慮する際に使用する戦略。

By default, uv will accept pre-releases for packages that only publish pre-releases, along with first-party requirements that contain an explicit pre-release marker in the declared specifiers (if-necessary-or-explicit).デフォルトでは、uvはプレリリースのみを公開するパッケージと、宣言された指定子に明示的なプレリリースマーカーを含むファーストパーティの要件に対してプレリリースを受け入れます (if-necessary-or-explicit)。

May also be set with the UV_PRERELEASE environment variable.UV_PRERELEASE 環境変数を使用して設定することもできます。

Possible values:可能な値：

disallow: Disallow all pre-release versionsdisallow: すべてのプレリリースバージョンを禁止する
allow: Allow all pre-release versionsallow: すべてのプレリリースバージョンを許可する
if-necessary: Allow pre-release versions if all versions of a package are pre-releaseif-necessary: パッケージのすべてのバージョンがプレリリースである場合にプレリリースバージョンを許可する
explicit: Allow pre-release versions for first-party packages with explicit pre-release markers in their version requirementsexplicit: バージョン要件に明示的なプレリリースマーカーを持つファーストパーティパッケージに対してプレリリースバージョンを許可する
if-necessary-or-explicit: Allow pre-release versions if all versions of a package are pre-release, or if the package has an explicit pre-release marker in its version requirementsif-necessary-or-explicit: パッケージのすべてのバージョンがプレリリースである場合、またはパッケージのバージョン要件に明示的なプレリリースマーカーがある場合にプレリリースバージョンを許可する

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数を使用して設定することもできます。

--python, -p python--python、-p python

The Python interpreter into which packages should be installed.パッケージをインストールするためのPythonインタープリター。

By default, installation requires a virtual environment. A path to an alternative Python can be provided, but it is only recommended in continuous integration (CI) environments and should be used with caution, as it can modify the system Python installation.デフォルトでは、インストールには仮想環境が必要です。代替のPythonへのパスを提供することもできますが、これは継続的インテグレーション（CI）環境でのみ推奨され、システムのPythonインストールを変更する可能性があるため注意して使用する必要があります。

See uv python for details on Python discovery and supported request formats.詳細についてはuv pythonを参照してください。Pythonの発見とサポートされているリクエスト形式について。

May also be set with the UV_PYTHON environment variable.UV_PYTHON環境変数を使用して設定することもできます。

--python-platform python-platform--python-platform python-platform

The platform for which requirements should be installed.要件をインストールするプラットフォーム。

Represented as a "target triple", a string that describes the target platform in terms of its CPU, vendor, and operating system name, like x86_64-unknown-linux-gnu or aarch64-apple-darwin.CPU、ベンダー、およびオペレーティングシステム名に関してターゲットプラットフォームを説明する文字列である「ターゲットトリプル」として表されます。例：x86_64-unknown-linux-gnuまたはaarch64-apple-darwin。

When targeting macOS (Darwin), the default minimum version is 13.0. Use MACOSX_DEPLOYMENT_TARGET to specify a different minimum version, e.g., 14.0.macOS（Darwin）をターゲットにする場合、デフォルトの最小バージョンは13.0です。異なる最小バージョンを指定するにはMACOSX_DEPLOYMENT_TARGETを使用します。例：14.0。

When targeting iOS, the default minimum version is 13.0. Use IPHONEOS_DEPLOYMENT_TARGET to specify a different minimum version, e.g., 14.0.iOSをターゲットにする場合、デフォルトの最小バージョンは13.0です。異なる最小バージョンを指定するにはIPHONEOS_DEPLOYMENT_TARGETを使用します。例：14.0。

When targeting Android, the default minimum Android API level is 24. Use ANDROID_API_LEVEL to specify a different minimum version, e.g., 26.Androidをターゲットにする場合、デフォルトの最小Android APIレベルは24です。異なる最小バージョンを指定するにはANDROID_API_LEVELを使用します。例：26。

WARNING: When specified, uv will select wheels that are compatible with the target platform; as a result, the installed distributions may not be compatible with the current platform. Conversely, any distributions that are built from source may be incompatible with the target platform, as they will be built for the current platform. The --python-platform option is intended for advanced use cases.警告：指定された場合、uvはターゲットプラットフォームと互換性のあるホイールを選択します。その結果、インストールされたディストリビューションは現在のプラットフォームと互換性がない可能性があります。逆に、ソースからビルドされたディストリビューションはターゲットプラットフォームと互換性がない可能性があります。なぜなら、それらは現在のプラットフォーム用にビルドされるからです。--python-platformオプションは高度な使用ケースを想定しています。

Possible values:可能な値：

windows: An alias for x86_64-pc-windows-msvc, the default target for Windowswindows: x86_64-pc-windows-msvcのエイリアスで、Windowsのデフォルトターゲットです。
linux: An alias for x86_64-unknown-linux-gnu, the default target for Linuxlinux: x86_64-unknown-linux-gnuのエイリアスで、Linuxのデフォルトターゲットです。
macos: An alias for aarch64-apple-darwin, the default target for macOSmacos: aarch64-apple-darwinのエイリアスで、macOSのデフォルトターゲットです。
x86_64-pc-windows-msvc: A 64-bit x86 Windows targetx86_64-pc-windows-msvc: 64ビットx86 Windowsターゲットです。
aarch64-pc-windows-msvc: An ARM64 Windows targetaarch64-pc-windows-msvc: ARM64 Windowsターゲットです。
i686-pc-windows-msvc: A 32-bit x86 Windows targeti686-pc-windows-msvc: 32ビットx86 Windowsターゲットです。
x86_64-unknown-linux-gnu: An x86 Linux target. Equivalent to x86_64-manylinux_2_28x86_64-unknown-linux-gnu: x86 Linuxターゲットです。x86_64-manylinux_2_28と同等です。
aarch64-apple-darwin: An ARM-based macOS target, as seen on Apple Silicon devicesaarch64-apple-darwin: Apple Siliconデバイスで見られるARMベースのmacOSターゲットです。
x86_64-apple-darwin: An x86 macOS targetx86_64-apple-darwin: x86 macOSターゲットです。
aarch64-unknown-linux-gnu: An ARM64 Linux target. Equivalent to aarch64-manylinux_2_28aarch64-unknown-linux-gnu: ARM64 Linuxターゲットです。aarch64-manylinux_2_28と同等です。
aarch64-unknown-linux-musl: An ARM64 Linux targetaarch64-unknown-linux-musl: ARM64 Linux ターゲット
x86_64-unknown-linux-musl: An x86_64 Linux targetx86_64-unknown-linux-musl: x86_64 Linux ターゲット
riscv64-unknown-linux: A RISCV64 Linux targetriscv64-unknown-linux: RISCV64 Linux ターゲット
x86_64-manylinux2014: An x86_64 target for the manylinux2014 platform. Equivalent to x86_64-manylinux_2_17x86_64-manylinux2014: manylinux2014 プラットフォーム用の x86_64 ターゲット。x86_64-manylinux_2_17 と同等
x86_64-manylinux_2_17: An x86_64 target for the manylinux_2_17 platformx86_64-manylinux_2_17: manylinux_2_17 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_28: An x86_64 target for the manylinux_2_28 platformx86_64-manylinux_2_28: manylinux_2_28 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_31: An x86_64 target for the manylinux_2_31 platformx86_64-manylinux_2_31: manylinux_2_31 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_32: An x86_64 target for the manylinux_2_32 platformx86_64-manylinux_2_32: manylinux_2_32 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_33: An x86_64 target for the manylinux_2_33 platformx86_64-manylinux_2_33: manylinux_2_33 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_34: An x86_64 target for the manylinux_2_34 platformx86_64-manylinux_2_34: manylinux_2_34 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_35: An x86_64 target for the manylinux_2_35 platformx86_64-manylinux_2_35: manylinux_2_35 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_36: An x86_64 target for the manylinux_2_36 platformx86_64-manylinux_2_36: manylinux_2_36 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_37: An x86_64 target for the manylinux_2_37 platformx86_64-manylinux_2_37: manylinux_2_37 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_38: An x86_64 target for the manylinux_2_38 platformx86_64-manylinux_2_38: manylinux_2_38 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_39: An x86_64 target for the manylinux_2_39 platformx86_64-manylinux_2_39: manylinux_2_39 プラットフォーム用の x86_64 ターゲット
x86_64-manylinux_2_40: An x86_64 target for the manylinux_2_40 platformx86_64-manylinux_2_40: manylinux_2_40 プラットフォーム用の x86_64 ターゲット
aarch64-manylinux2014: An ARM64 target for the manylinux2014 platform. Equivalent to aarch64-manylinux_2_17aarch64-manylinux2014: manylinux2014 プラットフォーム用の ARM64 ターゲット。aarch64-manylinux_2_17 と同等
aarch64-manylinux_2_17: An ARM64 target for the manylinux_2_17 platformaarch64-manylinux_2_17: manylinux_2_17 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_28: An ARM64 target for the manylinux_2_28 platformaarch64-manylinux_2_28: manylinux_2_28 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_31: An ARM64 target for the manylinux_2_31 platformaarch64-manylinux_2_31: manylinux_2_31 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_32: An ARM64 target for the manylinux_2_32 platformaarch64-manylinux_2_32: manylinux_2_32 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_33: An ARM64 target for the manylinux_2_33 platformaarch64-manylinux_2_33: manylinux_2_33 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_34: An ARM64 target for the manylinux_2_34 platformaarch64-manylinux_2_34: manylinux_2_34 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_35: An ARM64 target for the manylinux_2_35 platformaarch64-manylinux_2_35: manylinux_2_35 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_36: An ARM64 target for the manylinux_2_36 platformaarch64-manylinux_2_36: manylinux_2_36 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_37: An ARM64 target for the manylinux_2_37 platformaarch64-manylinux_2_37: manylinux_2_37 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_38: An ARM64 target for the manylinux_2_38 platformaarch64-manylinux_2_38: manylinux_2_38 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_39: An ARM64 target for the manylinux_2_39 platformaarch64-manylinux_2_39: manylinux_2_39 プラットフォーム用の ARM64 ターゲット
aarch64-manylinux_2_40: An ARM64 target for the manylinux_2_40 platformaarch64-manylinux_2_40: manylinux_2_40 プラットフォーム用の ARM64 ターゲット
aarch64-linux-android: An ARM64 Android targetaarch64-linux-android: ARM64 Android ターゲット
x86_64-linux-android: An x86_64 Android targetx86_64-linux-android: x86_64 Android ターゲット
wasm32-pyodide2024: A wasm32 target using the Pyodide 2024 platform. Meant for use with Python 3.12wasm32-pyodide2024: Pyodide 2024 プラットフォームを使用した wasm32 ターゲット。Python 3.12 と共に使用することを意図しています。
arm64-apple-ios: An ARM64 target for iOS devicearm64-apple-ios: iOS デバイス用の ARM64 ターゲット
arm64-apple-ios-simulator: An ARM64 target for iOS simulatorarm64-apple-ios-simulator: iOS シミュレーター用の ARM64 ターゲット
x86_64-apple-ios-simulator: An x86_64 target for iOS simulatorx86_64-apple-ios-simulator: iOS シミュレーター用の x86_64 ターゲット

--python-version python-version--python-version python-version

The minimum Python version that should be supported by the requirements (e.g., 3.7 or 3.7.9).要件によってサポートされるべき最小 Python バージョン (例: 3.7 または 3.7.9)。

If a patch version is omitted, the minimum patch version is assumed. For example, 3.7 is mapped to 3.7.0.パッチバージョンが省略された場合、最小パッチバージョンが仮定されます。例えば、3.7 は 3.7.0 にマッピングされます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すと、例えば -qq のように、uvはstdoutに出力を行わないサイレントモードが有効になります。

--refresh--refresh

Refresh all cached dataすべてのキャッシュデータを更新します

--refresh-package refresh-package--refresh-package refresh-package

Refresh cached data for a specific package特定のパッケージのキャッシュデータを更新します

--reinstall, --force-reinstall--reinstall, --force-reinstall

Reinstall all packages, regardless of whether they're already installed. Implies --refreshすべてのパッケージを再インストールします。すでにインストールされているかどうかに関わらず。--refreshを含意します。

--reinstall-package reinstall-package--reinstall-package reinstall-package

Reinstall a specific package, regardless of whether it's already installed. Implies --refresh-package特定のパッケージを再インストールします。すでにインストールされているかどうかに関わらず。--refresh-packageを含意します。

--require-hashes--require-hashes

Require a matching hash for each requirement.各要件に対して一致するハッシュが必要です。

By default, uv will verify any available hashes in the requirements file, but will not require that all requirements have an associated hash.デフォルトでは、uvは要件ファイル内の利用可能なハッシュを検証しますが、すべての要件に関連するハッシュが必要というわけではありません。

When --require-hashes is enabled, all requirements must include a hash or set of hashes, and all requirements must either be pinned to exact versions (e.g., ==1.0.0), or be specified via direct URL.--require-hashesが有効になっている場合、すべての要件にはハッシュまたはハッシュのセットが含まれている必要があり、すべての要件は正確なバージョンに固定される必要があります（例：==1.0.0）、または直接URLで指定される必要があります。

Hash-checking mode introduces a number of additional constraints:ハッシュチェックモードは、いくつかの追加の制約を導入します：

Git dependencies are not supported. - Editable installations are not supported. - Local dependencies are not supported, unless they point to a specific wheel (.whl) or source archive (.zip, .tar.gz), as opposed to a directory.Git依存関係はサポートされていません。 - 編集可能なインストールはサポートされていません。 - ローカル依存関係は、特定のホイール（.whl）またはソースアーカイブ（.zip、.tar.gz）を指す場合を除き、サポートされていません。

May also be set with the UV_REQUIRE_HASHES environment variable.UV_REQUIRE_HASHES環境変数でも設定できます。

--requirements, --requirement, -r requirements--requirements、--requirement、-r requirements

Install the packages listed in the given files.指定されたファイルにリストされたパッケージをインストールします。

The following formats are supported: requirements.txt, .py files with inline metadata, pylock.toml, pyproject.toml, setup.py, and setup.cfg.サポートされているフォーマットは次のとおりです：requirements.txt、.pyファイルのインラインメタデータ、pylock.toml、pyproject.toml、setup.py、およびsetup.cfg。

If a pyproject.toml, setup.py, or setup.cfg file is provided, uv will extract the requirements for the relevant project.pyproject.toml、setup.py、またはsetup.cfgファイルが提供されている場合、uvは関連するプロジェクトの要件を抽出します。

If - is provided, then requirements will be read from stdin.もし - が指定されている場合、要件は stdin から読み込まれます。

--resolution resolution--resolution 解像度

The strategy to use when selecting between the different compatible versions for a given package requirement.特定のパッケージ要件に対して異なる互換バージョンを選択する際に使用する戦略。

By default, uv will use the latest compatible version of each package (highest).デフォルトでは、uv は各パッケージの最新の互換バージョンを使用します (highest)。

May also be set with the UV_RESOLUTION environment variable.また、UV_RESOLUTION 環境変数で設定することもできます。

Possible values:可能な値：

highest: Resolve the highest compatible version of each packagehighest: 各パッケージの最高の互換バージョンを解決します
lowest: Resolve the lowest compatible version of each packagelowest: 各パッケージの最低の互換バージョンを解決します
lowest-direct: Resolve the lowest compatible version of any direct dependencies, and the highest compatible version of any transitive dependencieslowest-direct: 直接依存関係の最低の互換バージョンを解決し、間接依存関係の最高の互換バージョンを解決します

--strict--strict

Validate the Python environment after completing the installation, to detect packages with missing dependencies or other issuesインストールが完了した後、Python環境を検証して、依存関係が欠けているパッケージやその他の問題を検出します。

--system--system

Install packages into the system Python environment.パッケージをシステムのPython環境にインストールします。

By default, uv installs into the virtual environment in the current working directory or any parent directory. The --system option instructs uv to instead use the first Python found in the system PATH.デフォルトでは、uvは現在の作業ディレクトリまたは親ディレクトリの仮想環境にインストールします。--systemオプションは、uvにシステムのPATHで最初に見つかったPythonを使用するよう指示します。

WARNING: --system is intended for use in continuous integration (CI) environments and should be used with caution, as it can modify the system Python installation.警告: --systemは継続的インテグレーション（CI）環境での使用を意図しており、システムのPythonインストールを変更する可能性があるため、注意して使用する必要があります。

May also be set with the UV_SYSTEM_PYTHON environment variable.UV_SYSTEM_PYTHON環境変数で設定することもできます。

--target target--target target

Install packages into the specified directory, rather than into the virtual or system Python environment. The packages will be installed at the top-level of the directory.指定されたディレクトリにパッケージをインストールします。仮想環境やシステムのPython環境にはインストールされません。パッケージはディレクトリのトップレベルにインストールされます。

Unlike other install operations, this command does not require discovery of an existing Python environment and only searches for a Python interpreter to use for package resolution. If a suitable Python interpreter cannot be found, uv will install one. To disable this, add --no-python-downloads.他のインストール操作とは異なり、このコマンドは既存のPython環境の発見を必要とせず、パッケージ解決に使用するPythonインタプリタを検索するだけです。適切なPythonインタプリタが見つからない場合、uvは1つをインストールします。これを無効にするには、--no-python-downloadsを追加します。

--torch-backend torch-backend--torch-backend torch-backend

The backend to use when fetching packages in the PyTorch ecosystem (e.g., cpu, cu126, or auto)PyTorchエコシステムでパッケージを取得する際に使用するバックエンド（例：cpu、cu126、またはauto）

When set, uv will ignore the configured index URLs for packages in the PyTorch ecosystem, and will instead use the defined backend.設定すると、uvはPyTorchエコシステム内のパッケージのために構成されたインデックスURLを無視し、代わりに定義されたバックエンドを使用します。

For example, when set to cpu, uv will use the CPU-only PyTorch index; when set to cu126, uv will use the PyTorch index for CUDA 12.6.例えば、cpuに設定すると、uvはCPU専用のPyTorchインデックスを使用します；cu126に設定すると、uvはCUDA 12.6用のPyTorchインデックスを使用します。

The auto mode will attempt to detect the appropriate PyTorch index based on the currently installed CUDA drivers.autoモードは、現在インストールされているCUDAドライバーに基づいて適切なPyTorchインデックスを検出しようとします。

This option is in preview and may change in any future release.このオプションはプレビュー中であり、将来のリリースで変更される可能性があります。

May also be set with the UV_TORCH_BACKEND environment variable.UV_TORCH_BACKEND環境変数で設定することもできます。

Possible values:可能な値：

auto: Select the appropriate PyTorch index based on the operating system and CUDA driver versionauto: オペレーティングシステムとCUDAドライバーのバージョンに基づいて適切なPyTorchインデックスを選択します
cpu: Use the CPU-only PyTorch indexcpu: CPU専用のPyTorchインデックスを使用します
cu130: Use the PyTorch index for CUDA 13.0cu130: CUDA 13.0用のPyTorchインデックスを使用します
cu129: Use the PyTorch index for CUDA 12.9cu129: CUDA 12.9のためのPyTorchインデックスを使用します
cu128: Use the PyTorch index for CUDA 12.8cu128: CUDA 12.8のためのPyTorchインデックスを使用します
cu126: Use the PyTorch index for CUDA 12.6cu126: CUDA 12.6のためのPyTorchインデックスを使用します
cu125: Use the PyTorch index for CUDA 12.5cu125: CUDA 12.5のためのPyTorchインデックスを使用します
cu124: Use the PyTorch index for CUDA 12.4cu124: CUDA 12.4のためのPyTorchインデックスを使用します
cu123: Use the PyTorch index for CUDA 12.3cu123: CUDA 12.3のためのPyTorchインデックスを使用します
cu122: Use the PyTorch index for CUDA 12.2cu122: CUDA 12.2のためのPyTorchインデックスを使用します
cu121: Use the PyTorch index for CUDA 12.1cu121: CUDA 12.1のためのPyTorchインデックスを使用します
cu120: Use the PyTorch index for CUDA 12.0cu120: CUDA 12.0のためのPyTorchインデックスを使用します
cu118: Use the PyTorch index for CUDA 11.8cu118: CUDA 11.8のためのPyTorchインデックスを使用します
cu117: Use the PyTorch index for CUDA 11.7cu117: CUDA 11.7のためのPyTorchインデックスを使用します
cu116: Use the PyTorch index for CUDA 11.6cu116: CUDA 11.6のためのPyTorchインデックスを使用します
cu115: Use the PyTorch index for CUDA 11.5cu115: CUDA 11.5のためのPyTorchインデックスを使用します
cu114: Use the PyTorch index for CUDA 11.4cu114: CUDA 11.4のためのPyTorchインデックスを使用します
cu113: Use the PyTorch index for CUDA 11.3cu113: CUDA 11.3のためのPyTorchインデックスを使用します
cu112: Use the PyTorch index for CUDA 11.2cu112: CUDA 11.2のためのPyTorchインデックスを使用します
cu111: Use the PyTorch index for CUDA 11.1cu111: CUDA 11.1のためのPyTorchインデックスを使用します
cu110: Use the PyTorch index for CUDA 11.0cu110: CUDA 11.0のためのPyTorchインデックスを使用します
cu102: Use the PyTorch index for CUDA 10.2cu102: CUDA 10.2のためのPyTorchインデックスを使用します
cu101: Use the PyTorch index for CUDA 10.1cu101: CUDA 10.1のためのPyTorchインデックスを使用します
cu100: Use the PyTorch index for CUDA 10.0cu100: CUDA 10.0 用の PyTorch インデックスを使用します
cu92: Use the PyTorch index for CUDA 9.2cu92: CUDA 9.2 用の PyTorch インデックスを使用します
cu91: Use the PyTorch index for CUDA 9.1cu91: CUDA 9.1 用の PyTorch インデックスを使用します
cu90: Use the PyTorch index for CUDA 9.0cu90: CUDA 9.0 用の PyTorch インデックスを使用します
cu80: Use the PyTorch index for CUDA 8.0cu80: CUDA 8.0 用の PyTorch インデックスを使用します
rocm6.3: Use the PyTorch index for ROCm 6.3rocm6.3: ROCm 6.3 用の PyTorch インデックスを使用します
rocm6.2.4: Use the PyTorch index for ROCm 6.2.4rocm6.2.4: ROCm 6.2.4 用の PyTorch インデックスを使用します
rocm6.2: Use the PyTorch index for ROCm 6.2rocm6.2: ROCm 6.2 用の PyTorch インデックスを使用します
rocm6.1: Use the PyTorch index for ROCm 6.1rocm6.1: ROCm 6.1 用の PyTorch インデックスを使用します
rocm6.0: Use the PyTorch index for ROCm 6.0rocm6.0: ROCm 6.0 用の PyTorch インデックスを使用します
rocm5.7: Use the PyTorch index for ROCm 5.7rocm5.7: ROCm 5.7 のための PyTorch インデックスを使用してください
rocm5.6: Use the PyTorch index for ROCm 5.6rocm5.6: ROCm 5.6 のための PyTorch インデックスを使用してください
rocm5.5: Use the PyTorch index for ROCm 5.5rocm5.5: ROCm 5.5 のための PyTorch インデックスを使用してください
rocm5.4.2: Use the PyTorch index for ROCm 5.4.2rocm5.4.2: ROCm 5.4.2 のための PyTorch インデックスを使用してください
rocm5.4: Use the PyTorch index for ROCm 5.4rocm5.4: ROCm 5.4 のための PyTorch インデックスを使用してください
rocm5.3: Use the PyTorch index for ROCm 5.3rocm5.3: ROCm 5.3 のための PyTorch インデックスを使用してください
rocm5.2: Use the PyTorch index for ROCm 5.2rocm5.2: ROCm 5.2 のための PyTorch インデックスを使用してください
rocm5.1.1: Use the PyTorch index for ROCm 5.1.1rocm5.1.1: ROCm 5.1.1 のための PyTorch インデックスを使用してください
rocm4.2: Use the PyTorch index for ROCm 4.2rocm4.2: ROCm 4.2 のための PyTorch インデックスを使用してください
rocm4.1: Use the PyTorch index for ROCm 4.1rocm4.1: ROCm 4.1 のための PyTorch インデックスを使用してください
rocm4.0.1: Use the PyTorch index for ROCm 4.0.1rocm4.0.1: ROCm 4.0.1のためのPyTorchインデックスを使用します
xpu: Use the PyTorch index for Intel XPUxpu: Intel XPUのためのPyTorchインデックスを使用します

--upgrade, -U--upgrade, -U

Allow package upgrades, ignoring pinned versions in any existing output file. Implies --refreshパッケージのアップグレードを許可し、既存の出力ファイルに固定されたバージョンを無視します。--refreshを含みます

--upgrade-package, -P upgrade-package--upgrade-package, -P upgrade-package

Allow upgrades for a specific package, ignoring pinned versions in any existing output file. Implies --refresh-package特定のパッケージのアップグレードを許可し、既存の出力ファイルに固定されたバージョンを無視します。--refresh-packageを含みます

--user--user

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)細かいログ設定は、RUST_LOG環境変数を使用して構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv pip uninstalluv pip uninstall

Uninstall packages from an environment環境からパッケージをアンインストールします

Usage使用法

uv pip uninstall [OPTIONS] <PACKAGE|--requirements <REQUIREMENTS>>

Arguments引数

PACKAGEPACKAGE: Uninstall all listed packagesリストされたすべてのパッケージをアンインストールします

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホストポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告: このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--break-system-packages--break-system-packages

Allow uv to modify an EXTERNALLY-MANAGED Python installation.uvがEXTERNALLY-MANAGEDなPythonインストールを変更できるようにします。

WARNING: --break-system-packages is intended for use in continuous integration (CI) environments, when installing into Python installations that are managed by an external package manager, like apt. It should be used with caution, as such Python installations explicitly recommend against modifications by other package managers (like uv or pip).警告: --break-system-packagesは、aptのような外部パッケージマネージャによって管理されているPythonインストールにインストールする際の継続的インテグレーション（CI）環境での使用を目的としています。他のパッケージマネージャ（uvやpipなど）による変更を明示的に推奨しないため、注意して使用する必要があります。

May also be set with the UV_BREAK_SYSTEM_PACKAGES environment variable.UV_BREAK_SYSTEM_PACKAGES環境変数でも設定できます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uv、Windowsでは%LOCALAPPDATA%\uv\cacheがデフォルトです。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数を使用して設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力の色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvはターミナルに書き込む際に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: ターミナルまたはサポートのあるTTYに出力される場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.uv.tomlファイルのパスを設定に使用します。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.pyproject.tomlファイルにuvの設定を含めることはできますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数で設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数で設定することもできます。

--dry-run--dry-run

Perform a dry run, i.e., don't actually uninstall anything but print the resulting planドライランを実行します。つまり、実際には何もアンインストールせず、結果の計画を表示します。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します

--keyring-provider keyring-provider--keyring-provider keyring-provider

Attempt to use keyring for authentication for remote requirements files.リモート要件ファイルの認証にkeyringを使用しようとします。

At present, only --keyring-provider subprocess is supported, which configures uv to use the keyring CLI to handle authentication.現在、--keyring-provider subprocessのみがサポートされており、これはuvが認証を処理するためにkeyring CLIを使用するように構成します。

Defaults to disabled.デフォルトはdisabledです。

May also be set with the UV_KEYRING_PROVIDER environment variable.UV_KEYRING_PROVIDER環境変数で設定することもできます。

Possible values:可能な値：

disabled: Do not use keyring for credential lookupdisabled: 認証情報の検索にkeyringを使用しない
subprocess: Use the keyring command for credential lookupsubprocess: 認証情報の検索にkeyringコマンドを使用する

--managed-python--managed-python

Require use of uv-managed Python versions.uvが管理するPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンの使用を優先します。ただし、uvが管理するPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、特にシステムの証明書ストアに含まれる企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したいことがあります。

May also be set with the UV_NATIVE_TLS environment variable.UV_NATIVE_TLS環境変数でも設定できます。

--no-break-system-packages--no-break-system-packages

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りまたは書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.UV_NO_CACHE 環境変数でも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml, uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.UV_NO_CONFIG 環境変数でも設定できます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.環境変数 UV_NO_MANAGED_PYTHON で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.環境変数 UV_NO_PROGRESS で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.また、UV_OFFLINE 環境変数で設定することもできます。

--prefix prefix--prefix プレフィックス

Uninstall packages from the specified --prefix directory指定された --prefix ディレクトリからパッケージをアンインストールします。

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見され、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用される場合、効果がありません。

May also be set with the UV_PROJECT environment variable.また、UV_PROJECT 環境変数で設定することもできます。

--python, -p python--python, -p python

The Python interpreter from which packages should be uninstalled.パッケージをアンインストールするPythonインタプリタ。

By default, uninstallation requires a virtual environment. A path to an alternative Python can be provided, but it is only recommended in continuous integration (CI) environments and should be used with caution, as it can modify the system Python installation.デフォルトでは、アンインストールには仮想環境が必要です。代替のPythonへのパスを指定することもできますが、これは継続的インテグレーション（CI）環境でのみ推奨され、システムのPythonインストールを変更する可能性があるため注意して使用する必要があります。

See uv python for details on Python discovery and supported request formats.uv pythonを参照して、Pythonの発見とサポートされているリクエスト形式の詳細を確認してください。

May also be set with the UV_PYTHON environment variable.UV_PYTHON環境変数でも設定できます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば-qq、uvはstdoutに出力を一切書き込まないサイレントモードを有効にします。

--requirements, --requirement, -r requirements--requirements, --requirement, -r requirements

Uninstall the packages listed in the given files.指定されたファイルにリストされたパッケージをアンインストールします。

The following formats are supported: requirements.txt, .py files with inline metadata, pylock.toml, pyproject.toml, setup.py, and setup.cfg.サポートされているフォーマットは次のとおりです: requirements.txt、.py ファイルのインラインメタデータ、pylock.toml、pyproject.toml、setup.py、および setup.cfg。

--system--system

Use the system Python to uninstall packages.システムのPythonを使用してパッケージをアンインストールします。

By default, uv uninstalls from the virtual environment in the current working directory or any parent directory. The --system option instructs uv to instead use the first Python found in the system PATH.デフォルトでは、uvは現在の作業ディレクトリまたは任意の親ディレクトリの仮想環境からアンインストールします。--systemオプションは、uvにシステムのPATHで見つかった最初のPythonを使用するよう指示します。

WARNING: --system is intended for use in continuous integration (CI) environments and should be used with caution, as it can modify the system Python installation.警告: --systemは継続的インテグレーション（CI）環境での使用を意図しており、システムのPythonインストールを変更する可能性があるため、注意して使用する必要があります。

May also be set with the UV_SYSTEM_PYTHON environment variable.また、UV_SYSTEM_PYTHON環境変数で設定することもできます。

--target target--target target

Uninstall packages from the specified --target directory指定された--targetディレクトリからパッケージをアンインストールします。

--verbose, -v--verbose、-v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)細かいログ設定は、RUST_LOG 環境変数を使用して構成できます。(https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv pip freezeuv pip freeze

List, in requirements format, packages installed in an environment環境にインストールされたパッケージを要件形式でリストします

Usage使用法

uv pip freeze [OPTIONS]

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例: localhost）、ホスト-ポートペア（例: localhost:8080）、またはURL（例: https://localhost）のいずれかを受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告: このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-host は、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、検証されたソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.また、UV_INSECURE_HOST 環境変数で設定することもできます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.デフォルトでは、macOSおよびLinuxでは $XDG_CACHE_HOME/uv または $HOME/.cache/uv、Windowsでは %LOCALAPPDATA%\uv\cache になります。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dir を実行します。

May also be set with the UV_CACHE_DIR environment variable.また、UV_CACHE_DIR 環境変数で設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末への書き込み時に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力が端末またはサポートされているTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用するuv.tomlファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数を使用して設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数でも設定できます。

--exclude-editable--exclude-editable

Exclude any editable packages from output出力から編集可能なパッケージを除外します。

--help, -h--help、-h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--managed-python--managed-python

Require use of uv-managed Python versions.uv管理のPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンの使用を優先します。ただし、uv管理のPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、特にシステムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したいことがあります。

May also be set with the UV_NATIVE_TLS environment variable.UV_NATIVE_TLS環境変数でも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.UV_NO_CACHE環境変数でも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).pyproject.tomlやuv.tomlなどの設定ファイルを発見するのを避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.また、UV_NO_CONFIG 環境変数で設定することもできます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上で適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.また、UV_NO_MANAGED_PYTHON 環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.また、UV_NO_PROGRESS 環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数でも設定できます。

--path paths--path paths

Restrict to the specified installation path for listing packages (can be used multiple times)パッケージのリスト表示のために指定されたインストールパスに制限します（複数回使用可能）。

--project project--project project

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更できます。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数を使用して設定することもできます。

--python, -p python--python、-p python

The Python interpreter for which packages should be listed.パッケージをリストするための Python インタープリター。

By default, uv lists packages in a virtual environment but will show packages in a system Python environment if no virtual environment is found.デフォルトでは、uv は仮想環境内のパッケージをリストしますが、仮想環境が見つからない場合はシステムの Python 環境内のパッケージを表示します。

See uv python for details on Python discovery and supported request formats.Python の発見とサポートされているリクエスト形式の詳細については、uv python を参照してください。

May also be set with the UV_PYTHON environment variable.UV_PYTHON 環境変数を使用して設定することもできます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すと、例えば -qq のように、uvは標準出力に何も出力しないサイレントモードが有効になります。

--strict--strict

Validate the Python environment, to detect packages with missing dependencies and other issuesPython環境を検証し、依存関係が欠けているパッケージやその他の問題を検出します。

--system--system

List packages in the system Python environment.システムPython環境のパッケージをリストします。

Disables discovery of virtual environments.仮想環境の発見を無効にします。

See uv python for details on Python discovery.uv pythonを参照して、Pythonの発見に関する詳細を確認してください。

May also be set with the UV_SYSTEM_PYTHON environment variable.UV_SYSTEM_PYTHON環境変数でも設定できます。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)環境変数 RUST_LOG を使用して、詳細なロギングを構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv pip listuv pip list

List, in tabular format, packages installed in an environment環境にインストールされているパッケージを表形式で一覧表示します。

Usage使用法

uv pip list [OPTIONS]

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正な接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホストポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.WARNING: このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvに、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されています。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数でも設定できます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末への書き込み時に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力がサポートされている端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用するuv.tomlファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数を使用して設定することもできます。

--default-index default-index--default-index default-index

The URL of the default package index (by default: https://pypi.org/simple).デフォルトのパッケージインデックスのURL（デフォルト: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリのいずれかを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --index flag.このフラグで指定されたインデックスは、--indexフラグを介して指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_DEFAULT_INDEX environment variable.UV_DEFAULT_INDEX環境変数で設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.プロジェクトのルートディレクトリのみを変更するには、--projectを参照してください。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数で設定することもできます。

--editable, -e--editable, -e

Only include editable projects編集可能なプロジェクトのみを含める

--exclude exclude--exclude exclude

Exclude the specified package(s) from the output指定されたパッケージを出力から除外します

--exclude-editable--exclude-editable

Exclude any editable packages from output出力からすべての編集可能なパッケージを除外します

--exclude-newer exclude-newer--exclude-newer exclude-newer

Limit candidate packages to those that were uploaded prior to the given date.候補パッケージを指定された日付以前にアップロードされたものに制限します。

Accepts both RFC 3339 timestamps (e.g., 2006-12-02T02:07:43Z) and local dates in the same format (e.g., 2006-12-02) in your system's configured time zone.RFC 3339 タイムスタンプ（例：2006-12-02T02:07:43Z）と、システムの設定されたタイムゾーンでの同じ形式のローカル日付（例：2006-12-02）の両方を受け入れます。

May also be set with the UV_EXCLUDE_NEWER environment variable.UV_EXCLUDE_NEWER 環境変数で設定することもできます。

--extra-index-url extra-index-url--extra-index-url extra-index-url

(Deprecated: use --index instead) Extra URLs of package indexes to use, in addition to --index-url.(非推奨: 代わりに --index を使用してください) --index-url に加えて使用するパッケージインデックスの追加URL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --index-url (which defaults to PyPI). When multiple --extra-index-url flags are provided, earlier values take priority.このフラグを介して提供されるすべてのインデックスは、--index-url（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の --extra-index-url フラグが提供される場合、先に指定された値が優先されます。

May also be set with the UV_EXTRA_INDEX_URL environment variable.UV_EXTRA_INDEX_URL 環境変数を使用して設定することもできます。

--find-links, -f find-links--find-links, -f find-links

Locations to search for candidate distributions, in addition to those found in the registry indexes.レジストリインデックスで見つかったものに加えて、候補の配布物を検索する場所。

If a path, the target must be a directory that contains packages as wheel files (.whl) or source distributions (e.g., .tar.gz or .zip) at the top level.パスの場合、ターゲットはトップレベルにホイールファイル（.whl）またはソース配布（例: .tar.gz または .zip）を含むディレクトリでなければなりません。

If a URL, the page must contain a flat list of links to package files adhering to the formats described above.URLの場合、ページは上記の形式に従ったパッケージファイルへのリンクのフラットリストを含む必要があります。

May also be set with the UV_FIND_LINKS environment variable.UV_FIND_LINKS 環境変数を使用して設定することもできます。

--format format--format format

Select the output format出力形式を選択してください

[default: columns][デフォルト: columns]

Possible values:可能な値:

columns: Display the list of packages in a human-readable tablecolumns: パッケージのリストを人間が読みやすいテーブル形式で表示します
freeze: Display the list of packages in a pip freeze-like format, with one package per line alongside its versionfreeze: パッケージのリストをpip freezeに似た形式で表示し、各パッケージのバージョンを1行に表示します
json: Display the list of packages in a machine-readable JSON formatjson: パッケージのリストを機械可読なJSON形式で表示します

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します

--index index--index index

The URLs to use when resolving dependencies, in addition to the default index.デフォルトのインデックスに加えて、依存関係を解決する際に使用するURLです。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリのいずれかを受け入れます。

All indexes provided via this flag take priority over the index specified by --default-index (which defaults to PyPI). When multiple --index flags are provided, earlier values take priority.このフラグを介して提供されるすべてのインデックスは、--default-index（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の--indexフラグが提供される場合、先に指定された値が優先されます。

Index names are not supported as values. Relative paths must be disambiguated from index names with ./ or ../ on Unix or .\\, ..\\, ./ or ../ on Windows.インデックス名は値としてサポートされていません。相対パスは、Unixでは./または../、Windowsでは.\\、..\\、./または../を使用してインデックス名と区別する必要があります。

May also be set with the UV_INDEX environment variable.UV_INDEX環境変数を使用して設定することもできます。

--index-strategy index-strategy--index-strategy index-strategy

The strategy to use when resolving against multiple index URLs.複数のインデックスURLに対して解決する際に使用する戦略。

By default, uv will stop at the first index on which a given package is available, and limit resolutions to those present on that first index (first-index). This prevents "dependency confusion" attacks, whereby an attacker can upload a malicious package under the same name to an alternate index.デフォルトでは、uvは指定されたパッケージが利用可能な最初のインデックスで停止し、その最初のインデックスに存在するものに解決を制限します（first-index）。これにより、攻撃者が同じ名前の悪意のあるパッケージを別のインデックスにアップロードすることによる「依存関係の混乱」攻撃を防ぎます。

May also be set with the UV_INDEX_STRATEGY environment variable.UV_INDEX_STRATEGY環境変数を使用して設定することもできます。

Possible values:可能な値：

first-index: Only use results from the first index that returns a match for a given package namefirst-index: 指定されたパッケージ名に対して一致を返す最初のインデックスからの結果のみを使用します
unsafe-first-match: Search for every package name across all indexes, exhausting the versions from the first index before moving on to the nextunsafe-first-match: すべてのインデックスでパッケージ名を検索し、次のインデックスに移る前に最初のインデックスからバージョンを使い切ります。
unsafe-best-match: Search for every package name across all indexes, preferring the "best" version found. If a package version is in multiple indexes, only look at the entry for the first indexunsafe-best-match: すべてのインデックスでパッケージ名を検索し、見つかった「最良」のバージョンを優先します。パッケージのバージョンが複数のインデックスにある場合、最初のインデックスのエントリのみを確認します。

--index-url, -i index-url--index-url, -i index-url

(Deprecated: use --default-index instead) The URL of the Python package index (by default: https://pypi.org/simple).(非推奨: 代わりに --default-index を使用してください) PythonパッケージインデックスのURL（デフォルト: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --extra-index-url flag.このフラグで指定されたインデックスは、--extra-index-urlフラグを介して指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_INDEX_URL environment variable.UV_INDEX_URL 環境変数で設定することもできます。

--keyring-provider keyring-provider--keyring-provider keyring-provider

Attempt to use keyring for authentication for index URLs.keyringを使用してインデックスURLの認証を試みます。

At present, only --keyring-provider subprocess is supported, which configures uv to use the keyring CLI to handle authentication.現在のところ、--keyring-provider subprocess のみがサポートされており、uvが認証を処理するためにkeyring CLIを使用するように構成されます。

Defaults to disabled.デフォルトはdisabledです。

May also be set with the UV_KEYRING_PROVIDER environment variable.UV_KEYRING_PROVIDER環境変数で設定することもできます。

Possible values:可能な値：

disabled: Do not use keyring for credential lookupdisabled: 認証情報の検索にキーレングを使用しない
subprocess: Use the keyring command for credential lookupsubprocess: 認証情報の検索にkeyringコマンドを使用する

--managed-python--managed-python

Require use of uv-managed Python versions.uvが管理するPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンの使用を優先します。ただし、uvが管理するPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数で設定することもできます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、特にシステムの証明書ストアに含まれる企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したいことがあります。

May also be set with the UV_NATIVE_TLS environment variable.UV_NATIVE_TLS環境変数で設定することもできます。

--no-cache, --no-cache-dir, -n--no-cache、--no-cache-dir、-n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の期間中は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.UV_NO_CACHE環境変数で設定することもできます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml、uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.UV_NO_CONFIG 環境変数で設定することもできます。

--no-index--no-index

Ignore the registry index (e.g., PyPI), instead relying on direct URL dependencies and those provided via --find-linksレジストリインデックス（例：PyPI）を無視し、代わりに直接URL依存関係および--find-linksを介して提供されるものに依存します。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON 環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなど。

May also be set with the UV_NO_PROGRESS environment variable.また、UV_NO_PROGRESS 環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.また、UV_OFFLINE 環境変数で設定することもできます。

--outdated--outdated

List outdated packages.古いパッケージのリストを表示します。

The latest version of each package will be shown alongside the installed version. Up-to-date packages will be omitted from the output.各パッケージの最新バージョンがインストールされているバージョンとともに表示されます。最新のパッケージは出力から省略されます。

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数で設定することもできます。

--python, -p python--python, -p python

The Python interpreter for which packages should be listed.パッケージをリストするためのPythonインタプリタ。

By default, uv lists packages in a virtual environment but will show packages in a system Python environment if no virtual environment is found.デフォルトでは、uvは仮想環境内のパッケージをリストしますが、仮想環境が見つからない場合はシステムのPython環境内のパッケージを表示します。

See uv python for details on Python discovery and supported request formats.uv pythonの詳細については、Pythonの発見とサポートされているリクエスト形式を参照してください。

May also be set with the UV_PYTHON environment variable.UV_PYTHON環境変数でも設定できます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば-qq、uvはstdoutに出力を行わないサイレントモードを有効にします。

--strict--strict

Validate the Python environment, to detect packages with missing dependencies and other issuesPython環境を検証し、依存関係が欠けているパッケージやその他の問題を検出します。

--system--system

List packages in the system Python environment.システムPython環境のパッケージをリストします。

Disables discovery of virtual environments.仮想環境の発見を無効にします。

See uv python for details on Python discovery.詳細についてはuv pythonを参照してください。

May also be set with the UV_SYSTEM_PYTHON environment variable.UV_SYSTEM_PYTHON環境変数を使用して設定することもできます。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)RUST_LOG環境変数を使用して細かいログ設定を行うことができます。(https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv pip showuv pip show

Show information about one or more installed packagesインストールされたパッケージの情報を表示します

Usage使用法

uv pip show [OPTIONS] [PACKAGE]...

Arguments引数

PACKAGEPACKAGE: The package(s) to display表示するパッケージ

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）を受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.デフォルトは $XDG_CACHE_HOME/uv または $HOME/.cache/uv（macOSおよびLinuxの場合）、および %LOCALAPPDATA%\uv\cache（Windowsの場合）です。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dir を実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR 環境変数を使用して設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末への書き込み時に自動的に色のサポートを検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力がサポートされている端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.uv.toml ファイルのパスを設定に使用します。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.pyproject.toml ファイルに uv 設定を含めることはできますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE 環境変数でも設定できます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--project を参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY 環境変数でも設定できます。

--files, -f--files, -f

Show the full list of installed files for each package各パッケージのインストールされたファイルの完全なリストを表示します

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します

--managed-python--managed-python

Require use of uv-managed Python versions.uv-managed Python バージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理しているPythonバージョンの使用を優先します。ただし、uv-managed Pythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON 環境変数で設定することもできます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、いくつかのケースでは、プラットフォームのネイティブ証明書ストアを使用したい場合があります。特に、システムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合です。

May also be set with the UV_NATIVE_TLS environment variable.また、UV_NATIVE_TLS 環境変数で設定することもできます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.また、UV_NO_CACHE 環境変数で設定することもできます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml, uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.また、UV_NO_CONFIG 環境変数で設定することもできます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数でも設定できます。

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に歩いていくことで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して解決されます。

See --directory to change the working directory entirely.作業ディレクトリを完全に変更するには --directory を参照してください。

This setting has no effect when used in the uv pip interface.この設定は uv pip インターフェースで使用されると効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数でも設定できます。

--python, -p python--python, -p python

The Python interpreter to find the package in.パッケージを見つけるためのPythonインタプリタ。

By default, uv looks for packages in a virtual environment but will look for packages in a system Python environment if no virtual environment is found.デフォルトでは、uvは仮想環境内のパッケージを探しますが、仮想環境が見つからない場合はシステムのPython環境内のパッケージを探します。

See uv python for details on Python discovery and supported request formats.uv pythonを参照して、Pythonの発見とサポートされているリクエスト形式の詳細を確認してください。

May also be set with the UV_PYTHON environment variable.UV_PYTHON環境変数を使用して設定することもできます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば-qqのように、uvがstdoutに出力しないサイレントモードを有効にします。

--strict--strict

Validate the Python environment, to detect packages with missing dependencies and other issuesPython環境を検証し、依存関係が欠けているパッケージやその他の問題を検出します。

--system--system

Show a package in the system Python environment.システムのPython環境にあるパッケージを表示します。

Disables discovery of virtual environments.仮想環境の発見を無効にします。

See uv python for details on Python discovery.Pythonの発見に関する詳細はuv pythonを参照してください。

May also be set with the UV_SYSTEM_PYTHON environment variable.UV_SYSTEM_PYTHON環境変数を使用して設定することもできます。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)RUST_LOG環境変数を使用して、細かいログ設定を行うことができます。(https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv pip treeuv pip tree

Display the dependency tree for an environment環境の依存関係ツリーを表示します。

Usage使用法

uv pip tree [OPTIONS]

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST 環境変数でも設定できます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.デフォルトでは $XDG_CACHE_HOME/uv または $HOME/.cache/uv（macOSおよびLinux）、および %LOCALAPPDATA%\uv\cache（Windows）に設定されます。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR 環境変数を使用して設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末に書き込む際に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力が端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.uv.toml ファイルのパスを設定に使用します。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE 環境変数で設定することもできます。

--default-index default-index--default-index default-index

The URL of the default package index (by default: https://pypi.org/simple).デフォルトのパッケージインデックスのURL（デフォルト: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --index flag.このフラグで指定されたインデックスは、--indexフラグで指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_DEFAULT_INDEX environment variable.UV_DEFAULT_INDEX 環境変数で設定することもできます。

--depth, -d depth--depth, -d depth

Maximum display depth of the dependency tree依存関係ツリーの最大表示深度

[default: 255][デフォルト: 255]

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数を使用して設定することもできます。

--exclude-newer exclude-newer--exclude-newer exclude-newer

Limit candidate packages to those that were uploaded prior to the given date.候補パッケージを指定された日付以前にアップロードされたものに制限します。

Accepts both RFC 3339 timestamps (e.g., 2006-12-02T02:07:43Z) and local dates in the same format (e.g., 2006-12-02) in your system's configured time zone.RFC 3339 タイムスタンプ（例: 2006-12-02T02:07:43Z）と、システムの設定されたタイムゾーンでの同じ形式のローカル日付（例: 2006-12-02）の両方を受け入れます。

May also be set with the UV_EXCLUDE_NEWER environment variable.環境変数 UV_EXCLUDE_NEWER でも設定できます。

--extra-index-url extra-index-url--extra-index-url extra-index-url

(Deprecated: use --index instead) Extra URLs of package indexes to use, in addition to --index-url.(非推奨: 代わりに --index を使用してください) --index-url に加えて使用するパッケージインデックスの追加URL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --index-url (which defaults to PyPI). When multiple --extra-index-url flags are provided, earlier values take priority.このフラグを介して提供されるすべてのインデックスは、--index-url（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の --extra-index-url フラグが提供される場合、先に指定された値が優先されます。

May also be set with the UV_EXTRA_INDEX_URL environment variable.環境変数 UV_EXTRA_INDEX_URL でも設定できます。

--find-links, -f find-links--find-links, -f find-links

Locations to search for candidate distributions, in addition to those found in the registry indexes.レジストリインデックスで見つかったものに加えて、候補の配布物を検索する場所。

If a path, the target must be a directory that contains packages as wheel files (.whl) or source distributions (e.g., .tar.gz or .zip) at the top level.パスの場合、ターゲットはトップレベルにホイールファイル（.whl）またはソース配布（例: .tar.gz または .zip）を含むディレクトリでなければなりません。

If a URL, the page must contain a flat list of links to package files adhering to the formats described above.URLの場合、ページは上記の形式に従ったパッケージファイルへのリンクのフラットリストを含む必要があります。

May also be set with the UV_FIND_LINKS environment variable.また、UV_FIND_LINKS 環境変数で設定することもできます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します

--index index--index index

The URLs to use when resolving dependencies, in addition to the default index.デフォルトのインデックスに加えて、依存関係を解決するために使用するURLです。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式で配置されたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --default-index (which defaults to PyPI). When multiple --index flags are provided, earlier values take priority.このフラグを介して提供されたすべてのインデックスは、--default-index（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の--indexフラグが提供される場合、先に指定された値が優先されます。

Index names are not supported as values. Relative paths must be disambiguated from index names with ./ or ../ on Unix or .\\, ..\\, ./ or ../ on Windows.インデックス名は値としてサポートされていません。相対パスは、Unixでは./または../、Windowsでは.\\、..\\、./または../を使用してインデックス名と区別する必要があります。

May also be set with the UV_INDEX environment variable.また、UV_INDEX 環境変数で設定することもできます。

--index-strategy index-strategy--index-strategy index-strategy

The strategy to use when resolving against multiple index URLs.複数のインデックスURLに対して解決する際に使用する戦略。

By default, uv will stop at the first index on which a given package is available, and limit resolutions to those present on that first index (first-index). This prevents "dependency confusion" attacks, whereby an attacker can upload a malicious package under the same name to an alternate index.デフォルトでは、uvは指定されたパッケージが利用可能な最初のインデックスで停止し、その最初のインデックス（first-index）に存在するものに解決を制限します。これにより、攻撃者が別のインデックスに同じ名前の悪意のあるパッケージをアップロードすることによる「依存関係の混乱」攻撃を防ぎます。

May also be set with the UV_INDEX_STRATEGY environment variable.UV_INDEX_STRATEGY環境変数で設定することもできます。

Possible values:可能な値：

first-index: Only use results from the first index that returns a match for a given package namefirst-index: 指定されたパッケージ名に対して一致する最初のインデックスからの結果のみを使用します。
unsafe-first-match: Search for every package name across all indexes, exhausting the versions from the first index before moving on to the nextunsafe-first-match: すべてのインデックスで各パッケージ名を検索し、次のインデックスに移動する前に最初のインデックスからのバージョンを使い果たします。
unsafe-best-match: Search for every package name across all indexes, preferring the "best" version found. If a package version is in multiple indexes, only look at the entry for the first indexunsafe-best-match: すべてのインデックスで各パッケージ名を検索し、見つかった「最良」のバージョンを優先します。パッケージバージョンが複数のインデックスに存在する場合、最初のインデックスのエントリのみを確認します。

--index-url, -i index-url--index-url, -i index-url

(Deprecated: use --default-index instead) The URL of the Python package index (by default: https://pypi.org/simple).(非推奨: 代わりに--default-indexを使用してください) PythonパッケージインデックスのURL（デフォルト: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリまたは同じ形式でレイアウトされたローカルディレクトリのいずれかを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --extra-index-url flag.このフラグによって指定されたインデックスは、--extra-index-url フラグを介して指定された他のすべてのインデックスよりも低い優先度が与えられます。

May also be set with the UV_INDEX_URL environment variable.UV_INDEX_URL 環境変数を使用して設定することもできます。

--invert, --reverse--invert, --reverse

Show the reverse dependencies for the given package. This flag will invert the tree and display the packages that depend on the given package指定されたパッケージの逆依存関係を表示します。このフラグはツリーを反転させ、指定されたパッケージに依存するパッケージを表示します。

--keyring-provider keyring-provider--keyring-provider keyring-provider

Attempt to use keyring for authentication for index URLs.keyring を使用してインデックス URL の認証を試みます。

At present, only --keyring-provider subprocess is supported, which configures uv to use the keyring CLI to handle authentication.現在、--keyring-provider subprocess のみがサポートされており、uv が認証を処理するために keyring CLI を使用するように構成します。

Defaults to disabled.デフォルトは disabled です。

May also be set with the UV_KEYRING_PROVIDER environment variable.UV_KEYRING_PROVIDER 環境変数を使用して設定することもできます。

Possible values:可能な値:

disabled: Do not use keyring for credential lookupdisabled: 認証情報の検索にkeyringを使用しない
subprocess: Use the keyring command for credential lookupsubprocess: 認証情報の検索にkeyringコマンドを使用する

--managed-python--managed-python

Require use of uv-managed Python versions.uvが管理するPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンの使用を優先します。ただし、uvが管理するPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートセットであり、これをuvに含めることでポータビリティとパフォーマンス（特にmacOSで）が向上します。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、特にシステムの証明書ストアに含まれる企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したい場合があります。

May also be set with the UV_NATIVE_TLS environment variable.環境変数 UV_NATIVE_TLS でも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.環境変数 UV_NO_CACHE でも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル (pyproject.toml, uv.toml) の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.環境変数 UV_NO_CONFIG でも設定できます。

--no-dedupe--no-dedupe

Do not de-duplicate repeated dependencies. Usually, when a package has already displayed its dependencies, further occurrences will not re-display its dependencies, and will include a (*) to indicate it has already been shown. This flag will cause those duplicates to be repeated繰り返しの依存関係を重複させないでください。通常、パッケージがすでにその依存関係を表示している場合、さらに発生するものはその依存関係を再表示せず、すでに表示されたことを示すために (*) を含みます。このフラグは、それらの重複を繰り返す原因となります。

--no-index--no-index

Ignore the registry index (e.g., PyPI), instead relying on direct URL dependencies and those provided via --find-linksレジストリインデックス（例：PyPI）を無視し、直接URL依存関係および--find-linksを介して提供されるものに依存します。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.その代わりに、uvはシステム上で適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON環境変数でも設定できます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなど。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS環境変数でも設定できます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数でも設定できます。

--outdated--outdated

Show the latest available version of each package in the treeツリー内の各パッケージの最新の利用可能バージョンを表示します。

--package package--package package

Display only the specified packages指定されたパッケージのみを表示します。

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数を使用して設定することもできます。

--prune prune--prune プルーニング

Prune the given package from the display of the dependency tree依存関係ツリーの表示から指定されたパッケージをプルーニングします。

--python, -p python--python、-p Python

The Python interpreter for which packages should be listed.どのパッケージのためのPythonインタプリタをリストするべきか。

By default, uv lists packages in a virtual environment but will show packages in a system Python environment if no virtual environment is found.デフォルトでは、uvは仮想環境内のパッケージをリストしますが、仮想環境が見つからない場合はシステムのPython環境内のパッケージを表示します。

See uv python for details on Python discovery and supported request formats.uv pythonを参照して、Pythonの発見とサポートされているリクエスト形式の詳細を確認してください。

May also be set with the UV_PYTHON environment variable.UV_PYTHON環境変数を使用して設定することもできます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば-qq、uvはstdoutに出力を行わないサイレントモードを有効にします。

--show-sizes--show-sizes

Show compressed wheel sizes for packages in the treeツリー内のパッケージの圧縮ホイールサイズを表示します。

--show-version-specifiers--show-version-specifiers

Show the version constraint(s) imposed on each package各パッケージに課せられたバージョン制約を表示します

--strict--strict

Validate the Python environment, to detect packages with missing dependencies and other issuesPython環境を検証し、依存関係が欠けているパッケージやその他の問題を検出します

--system--system

List packages in the system Python environment.システムPython環境のパッケージをリストします。

Disables discovery of virtual environments.仮想環境の発見を無効にします。

See uv python for details on Python discovery.uv pythonを参照して、Pythonの発見に関する詳細を確認してください。

May also be set with the UV_SYSTEM_PYTHON environment variable.UV_SYSTEM_PYTHON環境変数を使用して設定することもできます。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)細かいログ設定は、RUST_LOG 環境変数を使用して構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv pip checkuv pip check

Verify installed packages have compatible dependenciesインストールされたパッケージが互換性のある依存関係を持っていることを確認します

Usage使用法

uv pip check [OPTIONS]

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正な接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例: localhost）、ホスト-ポートペア（例: localhost:8080）、またはURL（例: https://localhost）のいずれかを受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告: このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-host は、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.環境変数 UV_INSECURE_HOST でも設定できます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは $XDG_CACHE_HOME/uv または $HOME/.cache/uv にデフォルト設定され、Windowsでは %LOCALAPPDATA%\uv\cache にデフォルト設定されます。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dir を実行します。

May also be set with the UV_CACHE_DIR environment variable.環境変数 UV_CACHE_DIR でも設定できます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvはターミナルへの書き込み時に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力が端末またはTTYに送信される場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.uv.tomlファイルのパスを設定に使用します。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数を使用して設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数でも設定できます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--managed-python--managed-python

Require use of uv-managed Python versions.uv管理のPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンの使用を優先します。ただし、uv管理のPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、プラットフォームのネイティブ証明書ストアを使用したいことがあります。特に、システムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合です。

May also be set with the UV_NATIVE_TLS environment variable.また、UV_NATIVE_TLS環境変数で設定することもできます。

--no-cache, --no-cache-dir, -n--no-cache、--no-cache-dir、-n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の期間中は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.また、UV_NO_CACHE環境変数で設定することもできます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml、uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.また、UV_NO_CONFIG環境変数で設定することもできます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv-managed Python バージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.その代わりに、uv はシステム上の適切な Python バージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON 環境変数でも設定できます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS 環境変数でも設定できます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Python の自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数を使用して設定することもできます。

--project project--project project

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に歩いて発見され、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は uv pip インターフェースで使用されると効果がありません。

May also be set with the UV_PROJECT environment variable.また、UV_PROJECT 環境変数で設定することもできます。

--python, -p python--python, -p python

The Python interpreter for which packages should be checked.パッケージをチェックするための Python インタプリタ。

By default, uv checks packages in a virtual environment but will check packages in a system Python environment if no virtual environment is found.デフォルトでは、uv は仮想環境内のパッケージをチェックしますが、仮想環境が見つからない場合はシステムの Python 環境内のパッケージをチェックします。

See uv python for details on Python discovery and supported request formats.Python の発見とサポートされているリクエスト形式の詳細については、uv python を参照してください。

May also be set with the UV_PYTHON environment variable.また、UV_PYTHON 環境変数で設定することもできます。

--python-platform python-platform--python-platform python-platform

The platform for which packages should be checked.パッケージをチェックするためのプラットフォーム。

By default, the installed packages are checked against the platform of the current interpreter.デフォルトでは、インストールされたパッケージは現在のインタプリタのプラットフォームに対してチェックされます。

Represented as a "target triple", a string that describes the target platform in terms of its CPU, vendor, and operating system name, like x86_64-unknown-linux-gnu or aarch64-apple-darwin."ターゲットトリプル" として表現され、x86_64-unknown-linux-gnu や aarch64-apple-darwin のように、CPU、ベンダー、およびオペレーティングシステム名に関してターゲットプラットフォームを説明する文字列です。

When targeting macOS (Darwin), the default minimum version is 13.0. Use MACOSX_DEPLOYMENT_TARGET to specify a different minimum version, e.g., 14.0.macOS (Darwin) をターゲットにする場合、デフォルトの最小バージョンは 13.0 です。異なる最小バージョンを指定するには MACOSX_DEPLOYMENT_TARGET を使用します。例: 14.0。

When targeting iOS, the default minimum version is 13.0. Use IPHONEOS_DEPLOYMENT_TARGET to specify a different minimum version, e.g., 14.0.iOS をターゲットにする場合、デフォルトの最小バージョンは 13.0 です。異なる最小バージョンを指定するには IPHONEOS_DEPLOYMENT_TARGET を使用します。例: 14.0。

When targeting Android, the default minimum Android API level is 24. Use ANDROID_API_LEVEL to specify a different minimum version, e.g., 26.Android をターゲットにする場合、デフォルトの最小 Android API レベルは 24 です。異なる最小バージョンを指定するには ANDROID_API_LEVEL を使用します。例: 26。

Possible values:可能な値:

windows: An alias for x86_64-pc-windows-msvc, the default target for Windowswindows: x86_64-pc-windows-msvc のエイリアスで、Windows のデフォルトターゲットです。
linux: An alias for x86_64-unknown-linux-gnu, the default target for Linuxlinux: x86_64-unknown-linux-gnu のエイリアスで、Linux のデフォルトターゲットです。
macos: An alias for aarch64-apple-darwin, the default target for macOSmacos: aarch64-apple-darwin のエイリアスで、macOS のデフォルトターゲットです。
x86_64-pc-windows-msvc: A 64-bit x86 Windows targetx86_64-pc-windows-msvc: 64ビット x86 Windows ターゲットです。
aarch64-pc-windows-msvc: An ARM64 Windows targetaarch64-pc-windows-msvc: ARM64 Windows ターゲットです。
i686-pc-windows-msvc: A 32-bit x86 Windows targeti686-pc-windows-msvc: 32ビット x86 Windows ターゲットです。
x86_64-unknown-linux-gnu: An x86 Linux target. Equivalent to x86_64-manylinux_2_28x86_64-unknown-linux-gnu: x86 Linux ターゲット。x86_64-manylinux_2_28 と同等です。
aarch64-apple-darwin: An ARM-based macOS target, as seen on Apple Silicon devicesaarch64-apple-darwin: Apple Silicon デバイスで見られる ARM ベースの macOS ターゲット。
x86_64-apple-darwin: An x86 macOS targetx86_64-apple-darwin: x86 macOS ターゲット。
aarch64-unknown-linux-gnu: An ARM64 Linux target. Equivalent to aarch64-manylinux_2_28aarch64-unknown-linux-gnu: ARM64 Linux ターゲット。aarch64-manylinux_2_28 と同等です。
aarch64-unknown-linux-musl: An ARM64 Linux targetaarch64-unknown-linux-musl: ARM64 Linux ターゲット。
x86_64-unknown-linux-musl: An x86_64 Linux targetx86_64-unknown-linux-musl: x86_64 Linux ターゲット。
riscv64-unknown-linux: A RISCV64 Linux targetriscv64-unknown-linux: RISCV64 Linux ターゲット。
x86_64-manylinux2014: An x86_64 target for the manylinux2014 platform. Equivalent to x86_64-manylinux_2_17x86_64-manylinux2014: manylinux2014 プラットフォーム用の x86_64 ターゲット。x86_64-manylinux_2_17 と同等です。
x86_64-manylinux_2_17: An x86_64 target for the manylinux_2_17 platformx86_64-manylinux_2_17: manylinux_2_17 プラットフォーム用の x86_64 ターゲット。
x86_64-manylinux_2_28: An x86_64 target for the manylinux_2_28 platformx86_64-manylinux_2_28: manylinux_2_28 プラットフォーム用の x86_64 ターゲット。
x86_64-manylinux_2_31: An x86_64 target for the manylinux_2_31 platformx86_64-manylinux_2_31: x86_64 ターゲットの manylinux_2_31 プラットフォーム
x86_64-manylinux_2_32: An x86_64 target for the manylinux_2_32 platformx86_64-manylinux_2_32: x86_64 ターゲットの manylinux_2_32 プラットフォーム
x86_64-manylinux_2_33: An x86_64 target for the manylinux_2_33 platformx86_64-manylinux_2_33: x86_64 ターゲットの manylinux_2_33 プラットフォーム
x86_64-manylinux_2_34: An x86_64 target for the manylinux_2_34 platformx86_64-manylinux_2_34: x86_64 ターゲットの manylinux_2_34 プラットフォーム
x86_64-manylinux_2_35: An x86_64 target for the manylinux_2_35 platformx86_64-manylinux_2_35: x86_64 ターゲットの manylinux_2_35 プラットフォーム
x86_64-manylinux_2_36: An x86_64 target for the manylinux_2_36 platformx86_64-manylinux_2_36: x86_64 ターゲットの manylinux_2_36 プラットフォーム
x86_64-manylinux_2_37: An x86_64 target for the manylinux_2_37 platformx86_64-manylinux_2_37: x86_64 ターゲットの manylinux_2_37 プラットフォーム
x86_64-manylinux_2_38: An x86_64 target for the manylinux_2_38 platformx86_64-manylinux_2_38: x86_64 ターゲットの manylinux_2_38 プラットフォーム
x86_64-manylinux_2_39: An x86_64 target for the manylinux_2_39 platformx86_64-manylinux_2_39: x86_64 ターゲットの manylinux_2_39 プラットフォーム
x86_64-manylinux_2_40: An x86_64 target for the manylinux_2_40 platformx86_64-manylinux_2_40: x86_64 ターゲットの manylinux_2_40 プラットフォーム
aarch64-manylinux2014: An ARM64 target for the manylinux2014 platform. Equivalent to aarch64-manylinux_2_17aarch64-manylinux2014: manylinux2014プラットフォーム用のARM64ターゲット。aarch64-manylinux_2_17と同等です。
aarch64-manylinux_2_17: An ARM64 target for the manylinux_2_17 platformaarch64-manylinux_2_17: manylinux_2_17プラットフォーム用のARM64ターゲット。
aarch64-manylinux_2_28: An ARM64 target for the manylinux_2_28 platformaarch64-manylinux_2_28: manylinux_2_28プラットフォーム用のARM64ターゲット。
aarch64-manylinux_2_31: An ARM64 target for the manylinux_2_31 platformaarch64-manylinux_2_31: manylinux_2_31プラットフォーム用のARM64ターゲット。
aarch64-manylinux_2_32: An ARM64 target for the manylinux_2_32 platformaarch64-manylinux_2_32: manylinux_2_32プラットフォーム用のARM64ターゲット。
aarch64-manylinux_2_33: An ARM64 target for the manylinux_2_33 platformaarch64-manylinux_2_33: manylinux_2_33プラットフォーム用のARM64ターゲット。
aarch64-manylinux_2_34: An ARM64 target for the manylinux_2_34 platformaarch64-manylinux_2_34: manylinux_2_34プラットフォーム用のARM64ターゲット。
aarch64-manylinux_2_35: An ARM64 target for the manylinux_2_35 platformaarch64-manylinux_2_35: manylinux_2_35プラットフォーム用のARM64ターゲット。
aarch64-manylinux_2_36: An ARM64 target for the manylinux_2_36 platformaarch64-manylinux_2_36: manylinux_2_36プラットフォーム用のARM64ターゲット。
aarch64-manylinux_2_37: An ARM64 target for the manylinux_2_37 platformaarch64-manylinux_2_37: manylinux_2_37プラットフォーム用のARM64ターゲット。
aarch64-manylinux_2_38: An ARM64 target for the manylinux_2_38 platformaarch64-manylinux_2_38: manylinux_2_38プラットフォーム用のARM64ターゲット
aarch64-manylinux_2_39: An ARM64 target for the manylinux_2_39 platformaarch64-manylinux_2_39: manylinux_2_39プラットフォーム用のARM64ターゲット
aarch64-manylinux_2_40: An ARM64 target for the manylinux_2_40 platformaarch64-manylinux_2_40: manylinux_2_40プラットフォーム用のARM64ターゲット
aarch64-linux-android: An ARM64 Android targetaarch64-linux-android: ARM64 Androidターゲット
x86_64-linux-android: An x86_64 Android targetx86_64-linux-android: x86_64 Androidターゲット
wasm32-pyodide2024: A wasm32 target using the Pyodide 2024 platform. Meant for use with Python 3.12wasm32-pyodide2024: Pyodide 2024プラットフォームを使用したwasm32ターゲット。Python 3.12用に設計されています
arm64-apple-ios: An ARM64 target for iOS devicearm64-apple-ios: iOSデバイス用のARM64ターゲット
arm64-apple-ios-simulator: An ARM64 target for iOS simulatorarm64-apple-ios-simulator: iOSシミュレーター用のARM64ターゲット
x86_64-apple-ios-simulator: An x86_64 target for iOS simulatorx86_64-apple-ios-simulator: iOSシミュレーター用のターゲット

--python-version python-version--python-version python-version

The Python version against which packages should be checked.パッケージをチェックする際のPythonのバージョン。

By default, the installed packages are checked against the version of the current interpreter.デフォルトでは、インストールされたパッケージは現在のインタプリタのバージョンに対してチェックされます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uvがstdoutに出力を行わないサイレントモードが有効になります。

--system--system

Check packages in the system Python environment.システムのPython環境でパッケージをチェックします。

Disables discovery of virtual environments.仮想環境の発見を無効にします。

See uv python for details on Python discovery.uv python を参照して、Pythonの発見に関する詳細を確認してください。

May also be set with the UV_SYSTEM_PYTHON environment variable.UV_SYSTEM_PYTHON 環境変数を使用して設定することもできます。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)環境変数 RUST_LOG を使用して、詳細なロギングを構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv venvuv venv

Create a virtual environment.仮想環境を作成します。

By default, creates a virtual environment named .venv in the working directory. An alternative path may be provided positionally.デフォルトでは、作業ディレクトリに .venv という名前の仮想環境が作成されます。代替のパスを位置指定で提供することもできます。

If in a project, the default environment name can be changed with the UV_PROJECT_ENVIRONMENT environment variable; this only applies when run from the project root directory.プロジェクト内で実行している場合、デフォルトの環境名は環境変数 UV_PROJECT_ENVIRONMENT で変更できます。これはプロジェクトのルートディレクトリから実行されるときのみ適用されます。

If a virtual environment exists at the target path, it will be removed and a new, empty virtual environment will be created.ターゲットパスに仮想環境が存在する場合、それは削除され、新しい空の仮想環境が作成されます。

When using uv, the virtual environment does not need to be activated. uv will find a virtual environment (named .venv) in the working directory or any parent directories.uvを使用する場合、仮想環境をアクティブにする必要はありません。uvは作業ディレクトリまたは親ディレクトリにある仮想環境（.venvという名前）を見つけます。

Usage使用法

uv venv [OPTIONS] [PATH]

Arguments引数

PATHPATH

The path to the virtual environment to create.作成する仮想環境へのパス。

Default to .venv in the working directory.作業ディレクトリ内の.venvにデフォルト設定されています。

Relative paths are resolved relative to the working directory.相対パスは作業ディレクトリに対して解決されます。

Optionsオプション

--allow-existing--allow-existing

Preserve any existing files or directories at the target path.ターゲットパスに既存のファイルやディレクトリを保持します。

By default, uv venv will exit with an error if the given path is non-empty. The --allow-existing option will instead write to the given path, regardless of its contents, and without clearing it beforehand.デフォルトでは、uv venvは指定されたパスが空でない場合、エラーで終了します。--allow-existingオプションを使用すると、内容に関係なく指定されたパスに書き込み、事前にクリアすることなく実行されます。

WARNING: This option can lead to unexpected behavior if the existing virtual environment and the newly-created virtual environment are linked to different Python interpreters.警告: このオプションは、既存の仮想環境と新しく作成される仮想環境が異なるPythonインタプリタにリンクされている場合、予期しない動作を引き起こす可能性があります。

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回提供することができます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）を受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、検証されたソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvに、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されています。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行してください。

May also be set with the UV_CACHE_DIR environment variable.環境変数 UV_CACHE_DIR でも設定できます。

--clear, -c--clear, -c

Remove any existing files or directories at the target path.ターゲットパスに既存のファイルやディレクトリがあれば削除します。

By default, uv venv will exit with an error if the given path is non-empty. The --clear option will instead clear a non-empty path before creating a new virtual environment.デフォルトでは、uv venv は指定されたパスが空でない場合、エラーで終了します。--clear オプションを使用すると、新しい仮想環境を作成する前に非空のパスをクリアします。

May also be set with the UV_VENV_CLEAR environment variable.環境変数 UV_VENV_CLEAR でも設定できます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uv は端末に書き込む際に自動的に色のサポートを検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力が色のサポートを持つ端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 環境に関係なくカラフルな出力を有効にします
never: Disables colored outputnever: カラフルな出力を無効にします

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.uv.toml ファイルのパスを設定に使用します。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定は pyproject.toml ファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE 環境変数を使用して設定することもできます。

--default-index default-index--default-index default-index

The URL of the default package index (by default: https://pypi.org/simple).デフォルトのパッケージインデックスのURL（デフォルト: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式で配置されたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --index flag.このフラグで指定されたインデックスは、--index フラグで指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_DEFAULT_INDEX environment variable.環境変数 UV_DEFAULT_INDEX でも設定できます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--project を参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.環境変数 UV_WORKING_DIRECTORY でも設定できます。

--exclude-newer exclude-newer--exclude-newer exclude-newer

Limit candidate packages to those that were uploaded prior to the given date.候補パッケージを、指定された日付以前にアップロードされたものに制限します。

Accepts both RFC 3339 timestamps (e.g., 2006-12-02T02:07:43Z) and local dates in the same format (e.g., 2006-12-02) in your system's configured time zone.RFC 3339 タイムスタンプ（例：2006-12-02T02:07:43Z）と、システムの設定されたタイムゾーンでの同じ形式のローカル日付（例：2006-12-02）の両方を受け入れます。

May also be set with the UV_EXCLUDE_NEWER environment variable.環境変数 UV_EXCLUDE_NEWER でも設定できます。

--exclude-newer-package exclude-newer-package--exclude-newer-package exclude-newer-package

Limit candidate packages for a specific package to those that were uploaded prior to the given date.特定のパッケージの候補パッケージを、指定された日付以前にアップロードされたものに制限します。

Accepts package-date pairs in the format PACKAGE=DATE, where DATE is an RFC 3339 timestamp (e.g., 2006-12-02T02:07:43Z) or local date (e.g., 2006-12-02) in your system's configured time zone.PACKAGE=DATE形式のパッケージ-日付ペアを受け入れます。ここで、DATEはRFC 3339タイムスタンプ（例：2006-12-02T02:07:43Z）またはローカル日付（例：2006-12-02）で、システムの設定されたタイムゾーンに基づいています。

Can be provided multiple times for different packages.異なるパッケージのために複数回提供できます。

--extra-index-url extra-index-url--extra-index-url extra-index-url

(Deprecated: use --index instead) Extra URLs of package indexes to use, in addition to --index-url.(非推奨：代わりに--indexを使用してください) --index-urlに加えて使用するパッケージインデックスの追加URL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --index-url (which defaults to PyPI). When multiple --extra-index-url flags are provided, earlier values take priority.このフラグを介して提供されたすべてのインデックスは、--index-url（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の--extra-index-urlフラグが提供される場合、先に指定された値が優先されます。

May also be set with the UV_EXTRA_INDEX_URL environment variable.UV_EXTRA_INDEX_URL環境変数で設定することもできます。

--find-links, -f find-links--find-links, -f find-links

Locations to search for candidate distributions, in addition to those found in the registry indexes.レジストリインデックスに見つかったものに加えて、候補の配布物を検索する場所。

If a path, the target must be a directory that contains packages as wheel files (.whl) or source distributions (e.g., .tar.gz or .zip) at the top level.パスの場合、ターゲットはトップレベルにホイールファイル（.whl）またはソース配布（例：.tar.gzまたは.zip）を含むディレクトリでなければなりません。

If a URL, the page must contain a flat list of links to package files adhering to the formats described above.URLの場合、ページは上記の形式に従ったパッケージファイルへのリンクのフラットリストを含む必要があります。

May also be set with the UV_FIND_LINKS environment variable.UV_FIND_LINKS 環境変数で設定することもできます。

--help, -h--help、-h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--index index--index index

The URLs to use when resolving dependencies, in addition to the default index.デフォルトのインデックスに加えて、依存関係を解決する際に使用するURL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリまたは同じ形式でレイアウトされたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --default-index (which defaults to PyPI). When multiple --index flags are provided, earlier values take priority.このフラグを介して提供されたすべてのインデックスは、--default-index（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の--indexフラグが提供される場合、先に指定された値が優先されます。

Index names are not supported as values. Relative paths must be disambiguated from index names with ./ or ../ on Unix or .\\, ..\\, ./ or ../ on Windows.インデックス名は値としてサポートされていません。相対パスは、Unixでは./または../、Windowsでは.\\、..\\、./または../を使用してインデックス名と区別する必要があります。

May also be set with the UV_INDEX environment variable.UV_INDEX環境変数を使用して設定することもできます。

--index-strategy index-strategy--index-strategy index-strategy

The strategy to use when resolving against multiple index URLs.複数のインデックスURLに対して解決する際に使用する戦略。

By default, uv will stop at the first index on which a given package is available, and limit resolutions to those present on that first index (first-index). This prevents "dependency confusion" attacks, whereby an attacker can upload a malicious package under the same name to an alternate index.デフォルトでは、uvは指定されたパッケージが利用可能な最初のインデックスで停止し、その最初のインデックスに存在するものに解決を制限します（first-index）。これにより、攻撃者が別のインデックスに同じ名前の悪意のあるパッケージをアップロードすることによる「依存関係の混乱」攻撃を防ぎます。

May also be set with the UV_INDEX_STRATEGY environment variable.UV_INDEX_STRATEGY環境変数を使用して設定することもできます。

Possible values:可能な値：

first-index: Only use results from the first index that returns a match for a given package namefirst-index: 指定されたパッケージ名に一致する最初のインデックスからの結果のみを使用します。
unsafe-first-match: Search for every package name across all indexes, exhausting the versions from the first index before moving on to the nextunsafe-first-match: すべてのインデックスで各パッケージ名を検索し、次のインデックスに移動する前に最初のインデックスからのバージョンを使い果たします。
unsafe-best-match: Search for every package name across all indexes, preferring the "best" version found. If a package version is in multiple indexes, only look at the entry for the first indexunsafe-best-match: すべてのインデックスで各パッケージ名を検索し、見つかった「最良」のバージョンを優先します。パッケージバージョンが複数のインデックスに存在する場合、最初のインデックスのエントリのみを確認します。

--index-url, -i index-url--index-url, -i index-url

(Deprecated: use --default-index instead) The URL of the Python package index (by default: https://pypi.org/simple).(非推奨: 代わりに --default-index を使用してください) PythonパッケージインデックスのURL（デフォルト: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --extra-index-url flag.このフラグで指定されたインデックスは、--extra-index-urlフラグで指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_INDEX_URL environment variable.UV_INDEX_URL環境変数でも設定できます。

--keyring-provider keyring-provider--keyring-provider keyring-provider

Attempt to use keyring for authentication for index URLs.インデックスURLの認証にkeyringを使用しようとします。

At present, only --keyring-provider subprocess is supported, which configures uv to use the keyring CLI to handle authentication.現在のところ、--keyring-provider subprocessのみがサポートされており、これはuvが認証を処理するためにkeyring CLIを使用するように設定します。

Defaults to disabled.デフォルトはdisabledです。

May also be set with the UV_KEYRING_PROVIDER environment variable.UV_KEYRING_PROVIDER環境変数でも設定できます。

Possible values:可能な値：

disabled: Do not use keyring for credential lookupdisabled: キーリングを使用して資格情報を検索しない
subprocess: Use the keyring command for credential lookupsubprocess: 資格情報の検索にkeyringコマンドを使用する

--link-mode link-mode--link-mode link-mode

The method to use when installing packages from the global cache.グローバルキャッシュからパッケージをインストールする際に使用する方法。

This option is only used for installing seed packages.このオプションは、シードパッケージをインストールする際にのみ使用されます。

Defaults to clone (also known as Copy-on-Write) on macOS, and hardlink on Linux and Windows.macOSではclone（コピーオンライトとも呼ばれる）にデフォルト設定され、LinuxおよびWindowsではhardlinkにデフォルト設定されています。

WARNING: The use of symlink link mode is discouraged, as they create tight coupling between the cache and the target environment. For example, clearing the cache (uv cache clean) will break all installed packages by way of removing the underlying source files. Use symlinks with caution.警告：シンボリックリンクモードの使用は推奨されません。キャッシュとターゲット環境の間に強い結合を作成するためです。たとえば、キャッシュをクリアする（uv cache clean）と、基盤となるソースファイルが削除されるため、すべてのインストールされたパッケージが壊れます。シンボリックリンクは注意して使用してください。

May also be set with the UV_LINK_MODE environment variable.UV_LINK_MODE環境変数で設定することもできます。

Possible values:可能な値：

clone: Clone (i.e., copy-on-write) packages from the wheel into the site-packages directoryclone: ホイールからsite-packagesディレクトリにパッケージをクローン（すなわち、コピーオンライト）します。
copy: Copy packages from the wheel into the site-packages directorycopy: ホイールからsite-packagesディレクトリにパッケージをコピーします。
hardlink: Hard link packages from the wheel into the site-packages directoryhardlink: ホイールからsite-packagesディレクトリにパッケージをハードリンクします。
symlink: Symbolically link packages from the wheel into the site-packages directorysymlink: ホイールからsite-packagesディレクトリにパッケージをシンボリックリンクします。

--managed-python--managed-python

Require use of uv-managed Python versions.uvが管理するPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンの使用を優先します。ただし、uvが管理するPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートセットであり、これをuvに含めることでポータビリティとパフォーマンス（特にmacOSで）が向上します。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、プラットフォームのネイティブ証明書ストアを使用したいことがあります。特に、システムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合です。

May also be set with the UV_NATIVE_TLS environment variable.また、UV_NATIVE_TLS環境変数で設定することもできます。

--no-cache, --no-cache-dir, -n--no-cache、--no-cache-dir、-n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の期間中は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.また、UV_NO_CACHE環境変数で設定することもできます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).pyproject.tomlやuv.tomlなどの設定ファイルの発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.また、UV_NO_CONFIG環境変数で設定することもできます。

--no-index--no-index

Ignore the registry index (e.g., PyPI), instead relying on direct URL dependencies and those provided via --find-linksレジストリインデックス（例：PyPI）を無視し、代わりに直接URL依存関係および--find-linksを介して提供されるものに依存します。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON環境変数でも設定できます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなど。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS環境変数でも設定できます。

--no-project, --no-workspace--no-project, --no-workspace

Avoid discovering a project or workspace.プロジェクトまたはワークスペースの発見を避けます。

By default, uv searches for projects in the current directory or any parent directory to determine the default path of the virtual environment and check for Python version constraints, if any.デフォルトでは、uvは現在のディレクトリまたは親ディレクトリ内のプロジェクトを検索して、仮想環境のデフォルトパスを決定し、Pythonのバージョン制約がある場合はそれを確認します。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数を使用して設定することもできます。

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数を使用して設定することもできます。

--prompt prompt--prompt プロンプト

Provide an alternative prompt prefix for the virtual environment.仮想環境の代替プロンプトプレフィックスを提供します。

By default, the prompt is dependent on whether a path was provided to uv venv. If provided (e.g, uv venv project), the prompt is set to the directory name. If not provided (uv venv), the prompt is set to the current directory's name.デフォルトでは、プロンプトは uv venv にパスが提供されたかどうかに依存します。提供された場合（例: uv venv project）、プロンプトはディレクトリ名に設定されます。提供されなかった場合（uv venv）、プロンプトは現在のディレクトリの名前に設定されます。

If "." is provided, the current directory name will be used regardless of whether a path was provided to uv venv."." が提供された場合、現在のディレクトリ名が使用され、uv venv にパスが提供されたかどうかに関係なく使用されます。

--python, -p python--python, -p python

The Python interpreter to use for the virtual environment.仮想環境で使用するPythonインタプリタ。

During virtual environment creation, uv will not look for Python interpreters in virtual environments.仮想環境の作成中、uvは仮想環境内のPythonインタプリタを探しません。

See uv python for details on Python discovery and supported request formats.Pythonの発見とサポートされているリクエスト形式の詳細については、uv pythonを参照してください。

May also be set with the UV_PYTHON environment variable.UV_PYTHON環境変数を使用して設定することもできます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば-qqのように、uvがstdoutに出力を行わないサイレントモードを有効にします。

--refresh--refresh

Refresh all cached dataすべてのキャッシュデータを更新します

--refresh-package refresh-package--refresh-package refresh-package

Refresh cached data for a specific package特定のパッケージのキャッシュデータを更新します

--relocatable--relocatable

Make the virtual environment relocatable.仮想環境を移動可能にします。

A relocatable virtual environment can be moved around and redistributed without invalidating its associated entrypoint and activation scripts.移動可能な仮想環境は、関連するエントリポイントやアクティベーションスクリプトを無効にすることなく、移動や再配布が可能です。

Note that this can only be guaranteed for standard console_scripts and gui_scripts. Other scripts may be adjusted if they ship with a generic #!python[w] shebang, and binaries are left as-is.これは標準の console_scripts および gui_scripts に対してのみ保証されることに注意してください。他のスクリプトは、一般的な #!python[w] シェバンを持っている場合に調整される可能性があり、バイナリはそのまま残されます。

As a result of making the environment relocatable (by way of writing relative, rather than absolute paths), the entrypoints and scripts themselves will not be relocatable. In other words, copying those entrypoints and scripts to a location outside the environment will not work, as they reference paths relative to the environment itself.環境を移動可能にする結果として（相対パスを書くことによって）、エントリポイントやスクリプト自体は 移動可能ではありません。言い換えれば、これらのエントリポイントやスクリプトを環境の外にコピーしても機能せず、環境自体に対する相対パスを参照しています。

--seed--seed

Install seed packages (one or more of: pip, setuptools, and wheel) into the virtual environment.仮想環境にシードパッケージ（pip、setuptools、および wheel のいずれかまたはすべて）をインストールします。

Note that setuptools and wheel are not included in Python 3.12+ environments.setuptools と wheel は Python 3.12+ 環境には含まれていないことに注意してください。

May also be set with the UV_VENV_SEED environment variable.環境変数 UV_VENV_SEED で設定することもできます。

--system-site-packages--system-site-packages

Give the virtual environment access to the system site packages directory.仮想環境にシステムサイトパッケージディレクトリへのアクセスを与えます。

Unlike pip, when a virtual environment is created with --system-site-packages, uv will not take system site packages into account when running commands like uv pip list or uv pip install. The --system-site-packages flag will provide the virtual environment with access to the system site packages directory at runtime, but will not affect the behavior of uv commands.pipとは異なり、--system-site-packages で仮想環境が作成されると、uvは uv pip list や uv pip install のようなコマンドを実行する際にシステムサイトパッケージを考慮しません。--system-site-packages フラグは、実行時に仮想環境にシステムサイトパッケージディレクトリへのアクセスを提供しますが、uvコマンドの動作には影響しません。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)環境変数 RUST_LOG を使用して、細かいログ設定を行うことができます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv builduv build

Build Python packages into source distributions and wheels.Pythonパッケージをソース配布とホイールにビルドします。

uv build accepts a path to a directory or source distribution, which defaults to the current working directory.uv build は、ディレクトリまたはソース配布へのパスを受け付け、デフォルトでは現在の作業ディレクトリになります。

By default, if passed a directory, uv build will build a source distribution ("sdist") from the source directory, and a binary distribution ("wheel") from the source distribution.デフォルトでは、ディレクトリが渡された場合、uv buildはソースディレクトリからソース配布（"sdist"）を構築し、ソース配布からバイナリ配布（"wheel"）を構築します。

uv build --sdist can be used to build only the source distribution, uv build --wheel can be used to build only the binary distribution, and uv build --sdist --wheel can be used to build both distributions from source.uv build --sdistはソース配布のみを構築するために使用でき、uv build --wheelはバイナリ配布のみを構築するために使用でき、uv build --sdist --wheelはソースから両方の配布を構築するために使用できます。

If passed a source distribution, uv build --wheel will build a wheel from the source distribution.ソース配布が渡された場合、uv build --wheelはソース配布からホイールを構築します。

Usage使用法

uv build [OPTIONS] [SRC]

Arguments引数

SRCSRC

The directory from which distributions should be built, or a source distribution archive to build into a wheel.配布を構築するためのディレクトリ、またはホイールに構築するためのソース配布アーカイブ。

Defaults to the current working directory.現在の作業ディレクトリがデフォルトです。

Optionsオプション

--all-packages, --all--all-packages, --all

Builds all packages in the workspace.ワークスペース内のすべてのパッケージをビルドします。

The workspace will be discovered from the provided source directory, or the current directory if no source directory is provided.ワークスペースは、提供されたソースディレクトリから発見されます。ソースディレクトリが提供されていない場合は、現在のディレクトリが使用されます。

If the workspace member does not exist, uv will exit with an error.ワークスペースメンバーが存在しない場合、uvはエラーで終了します。

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host、--trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回提供することができます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホストポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数を使用して設定することもできます。

--build-constraints, --build-constraint, -b build-constraints--build-constraints、--build-constraint、-b build-constraints

Constrain build dependencies using the given requirements files when building distributions.配布物をビルドする際に、指定された要件ファイルを使用してビルド依存関係を制約します。

Constraints files are requirements.txt-like files that only control the version of a build dependency that's installed. However, including a package in a constraints file will not trigger the inclusion of that package on its own.制約ファイルは、インストールされるビルド依存関係のバージョンのみを制御するrequirements.txtのようなファイルです。ただし、制約ファイルにパッケージを含めても、そのパッケージが単独で含まれることはありません。

May also be set with the UV_BUILD_CONSTRAINT environment variable.UV_BUILD_CONSTRAINT環境変数を使用して設定することもできます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvにデフォルト設定され、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されます。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数を使用して設定することもできます。

--clear--clear

Clear the output directory before the build, removing stale artifactsビルドの前に出力ディレクトリをクリアし、古いアーティファクトを削除します。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末への書き込み時に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力がサポートされている端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用するuv.tomlファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.環境変数 UV_CONFIG_FILE でも設定できます。

--config-setting, --config-settings, -C config-setting--config-setting, --config-settings, -C config-setting

Settings to pass to the PEP 517 build backend, specified as KEY=VALUE pairsPEP 517 ビルドバックエンドに渡す設定で、KEY=VALUE ペアとして指定します。

--config-settings-package, --config-settings-package config-settings-package--config-settings-package, --config-settings-package config-settings-package

Settings to pass to the PEP 517 build backend for a specific package, specified as PACKAGE:KEY=VALUE pairs特定のパッケージのために PEP 517 ビルドバックエンドに渡す設定で、PACKAGE:KEY=VALUE ペアとして指定します。

--default-index default-index--default-index default-index

The URL of the default package index (by default: https://pypi.org/simple).デフォルトのパッケージインデックスの URL（デフォルト: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリ API）に準拠したリポジトリまたは、同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --index flag.このフラグで指定されたインデックスは、--index フラグで指定された他のすべてのインデックスよりも優先度が低くなります。

May also be set with the UV_DEFAULT_INDEX environment variable.環境変数 UV_DEFAULT_INDEX でも設定できます。

--directory directory--directory ディレクトリ

Change to the given directory prior to running the command.コマンドを実行する前に指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数で設定することもできます。

--exclude-newer exclude-newer--exclude-newer exclude-newer

Limit candidate packages to those that were uploaded prior to the given date.候補パッケージを指定された日付以前にアップロードされたものに制限します。

Accepts both RFC 3339 timestamps (e.g., 2006-12-02T02:07:43Z) and local dates in the same format (e.g., 2006-12-02) in your system's configured time zone.RFC 3339 タイムスタンプ（例：2006-12-02T02:07:43Z）と、システムの設定されたタイムゾーンでの同じ形式のローカル日付（例：2006-12-02）の両方を受け入れます。

May also be set with the UV_EXCLUDE_NEWER environment variable.UV_EXCLUDE_NEWER環境変数で設定することもできます。

--exclude-newer-package exclude-newer-package--exclude-newer-package exclude-newer-package

Limit candidate packages for a specific package to those that were uploaded prior to the given date.特定のパッケージに対する候補パッケージを、指定された日付以前にアップロードされたものに制限します。

Accepts package-date pairs in the format PACKAGE=DATE, where DATE is an RFC 3339 timestamp (e.g., 2006-12-02T02:07:43Z) or local date (e.g., 2006-12-02) in your system's configured time zone.PACKAGE=DATE形式のパッケージ-日付ペアを受け入れます。ここで、DATEはRFC 3339タイムスタンプ（例：2006-12-02T02:07:43Z）またはローカル日付（例：2006-12-02）で、システムの設定されたタイムゾーンに基づいています。

Can be provided multiple times for different packages.異なるパッケージのために複数回提供できます。

--extra-index-url extra-index-url--extra-index-url extra-index-url

(Deprecated: use --index instead) Extra URLs of package indexes to use, in addition to --index-url.(非推奨：代わりに--indexを使用してください) --index-urlに加えて使用するパッケージインデックスの追加URL。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --index-url (which defaults to PyPI). When multiple --extra-index-url flags are provided, earlier values take priority.このフラグを介して提供されたすべてのインデックスは、--index-url（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の--extra-index-urlフラグが提供される場合、早い値が優先されます。

May also be set with the UV_EXTRA_INDEX_URL environment variable.UV_EXTRA_INDEX_URL環境変数を使用して設定することもできます。

--find-links, -f find-links--find-links, -f find-links

Locations to search for candidate distributions, in addition to those found in the registry indexes.レジストリインデックスで見つかったものに加えて、候補配布を検索する場所。

If a path, the target must be a directory that contains packages as wheel files (.whl) or source distributions (e.g., .tar.gz or .zip) at the top level.パスの場合、ターゲットは最上位にホイールファイル（.whl）またはソース配布（例：.tar.gzまたは.zip）を含むディレクトリでなければなりません。

If a URL, the page must contain a flat list of links to package files adhering to the formats described above.URLの場合、ページには上記の形式に従ったパッケージファイルへのリンクのフラットリストが含まれている必要があります。

May also be set with the UV_FIND_LINKS environment variable.UV_FIND_LINKS 環境変数で設定することもできます。

--force-pep517--force-pep517

Always build through PEP 517, don't use the fast path for the uv build backend.常にPEP 517を通じてビルドし、uvビルドバックエンドのためのファストパスを使用しないでください。

By default, uv won't create a PEP 517 build environment for packages using the uv build backend, but use a fast path that calls into the build backend directly. This option forces always using PEP 517.デフォルトでは、uvはuvビルドバックエンドを使用するパッケージのためにPEP 517ビルド環境を作成しませんが、ビルドバックエンドに直接呼び出すファストパスを使用します。このオプションは常にPEP 517を使用することを強制します。

--fork-strategy fork-strategy--fork-strategy fork-strategy

The strategy to use when selecting multiple versions of a given package across Python versions and platforms.特定のパッケージの複数のバージョンをPythonのバージョンやプラットフォームにわたって選択する際に使用する戦略。

By default, uv will optimize for selecting the latest version of each package for each supported Python version (requires-python), while minimizing the number of selected versions across platforms.デフォルトでは、uvは各サポートされているPythonバージョン（requires-python）のために各パッケージの最新バージョンを選択することを最適化し、プラットフォーム間で選択されたバージョンの数を最小限に抑えます。

Under fewest, uv will minimize the number of selected versions for each package, preferring older versions that are compatible with a wider range of supported Python versions or platforms.fewestの下では、uvは各パッケージの選択されたバージョンの数を最小限に抑え、より広範囲のサポートされているPythonバージョンやプラットフォームと互換性のある古いバージョンを優先します。

May also be set with the UV_FORK_STRATEGY environment variable.また、UV_FORK_STRATEGY 環境変数で設定することもできます。

Possible values:可能な値：

fewest: Optimize for selecting the fewest number of versions for each package. Older versions may be preferred if they are compatible with a wider range of supported Python versions or platformsfewest: 各パッケージのバージョン数を最小限に選択するよう最適化します。古いバージョンは、より広範なサポートされているPythonバージョンやプラットフォームと互換性がある場合に優先されることがあります。
requires-python: Optimize for selecting latest supported version of each package, for each supported Python versionrequires-python: 各サポートされているPythonバージョンに対して、各パッケージの最新のサポートバージョンを選択するよう最適化します。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--index index--index index

The URLs to use when resolving dependencies, in addition to the default index.デフォルトのインデックスに加えて、依存関係を解決するために使用するURLです。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリまたは、同じ形式でレイアウトされたローカルディレクトリを受け入れます。

All indexes provided via this flag take priority over the index specified by --default-index (which defaults to PyPI). When multiple --index flags are provided, earlier values take priority.このフラグを介して提供されたすべてのインデックスは、--default-index（デフォルトはPyPI）で指定されたインデックスよりも優先されます。複数の--indexフラグが提供される場合、先に指定された値が優先されます。

Index names are not supported as values. Relative paths must be disambiguated from index names with ./ or ../ on Unix or .\\, ..\\, ./ or ../ on Windows.インデックス名は値としてサポートされていません。相対パスは、Unixでは./または../、Windowsでは.\\、..\\、./または../を使用してインデックス名から区別する必要があります。

May also be set with the UV_INDEX environment variable.UV_INDEX環境変数を使用して設定することもできます。

--index-strategy index-strategy--index-strategy index-strategy

The strategy to use when resolving against multiple index URLs.複数のインデックスURLに対して解決する際に使用する戦略。

By default, uv will stop at the first index on which a given package is available, and limit resolutions to those present on that first index (first-index). This prevents "dependency confusion" attacks, whereby an attacker can upload a malicious package under the same name to an alternate index.デフォルトでは、uvは指定されたパッケージが利用可能な最初のインデックスで停止し、その最初のインデックスに存在するものに解決を制限します（first-index）。これにより、攻撃者が同じ名前の悪意のあるパッケージを別のインデックスにアップロードすることによる「依存関係の混乱」攻撃を防ぎます。

May also be set with the UV_INDEX_STRATEGY environment variable.UV_INDEX_STRATEGY環境変数を使用して設定することもできます。

Possible values:可能な値：

first-index: Only use results from the first index that returns a match for a given package namefirst-index: 指定されたパッケージ名に対して一致を返す最初のインデックスからの結果のみを使用します。
unsafe-first-match: Search for every package name across all indexes, exhausting the versions from the first index before moving on to the nextunsafe-first-match: すべてのインデックスで各パッケージ名を検索し、次のインデックスに移動する前に最初のインデックスからのバージョンを使い果たします。
unsafe-best-match: Search for every package name across all indexes, preferring the "best" version found. If a package version is in multiple indexes, only look at the entry for the first indexunsafe-best-match: すべてのインデックスで各パッケージ名を検索し、見つかった「最良」のバージョンを優先します。パッケージバージョンが複数のインデックスに存在する場合、最初のインデックスのエントリのみを確認します。

--index-url, -i index-url--index-url, -i index-url

(Deprecated: use --default-index instead) The URL of the Python package index (by default: https://pypi.org/simple).(非推奨: 代わりに --default-index を使用してください) PythonパッケージインデックスのURL（デフォルト: https://pypi.org/simple）。

Accepts either a repository compliant with PEP 503 (the simple repository API), or a local directory laid out in the same format.PEP 503（シンプルリポジトリAPI）に準拠したリポジトリ、または同じ形式でレイアウトされたローカルディレクトリを受け入れます。

The index given by this flag is given lower priority than all other indexes specified via the --extra-index-url flag.このフラグで指定されたインデックスは、--extra-index-urlフラグを介して指定されたすべての他のインデックスよりも優先度が低くなります。

May also be set with the UV_INDEX_URL environment variable.UV_INDEX_URL 環境変数で設定することもできます。

--keyring-provider keyring-provider--keyring-provider keyring-provider

Attempt to use keyring for authentication for index URLs.インデックスURLの認証に keyring を使用しようとします。

At present, only --keyring-provider subprocess is supported, which configures uv to use the keyring CLI to handle authentication.現在のところ、--keyring-provider subprocess のみがサポートされており、これはuvが認証を処理するために keyring CLI を使用するように構成します。

Defaults to disabled.デフォルトは disabled です。

May also be set with the UV_KEYRING_PROVIDER environment variable.UV_KEYRING_PROVIDER 環境変数で設定することもできます。

Possible values:可能な値：

disabled: Do not use keyring for credential lookupdisabled: キーリングを使用して資格情報を検索しない
subprocess: Use the keyring command for credential lookupsubprocess: 資格情報を検索するために keyring コマンドを使用する

--link-mode link-mode--link-mode link-mode

The method to use when installing packages from the global cache.グローバルキャッシュからパッケージをインストールする際に使用する方法。

This option is only used when building source distributions.このオプションは、ソース配布をビルドする際にのみ使用されます。

Defaults to clone (also known as Copy-on-Write) on macOS, and hardlink on Linux and Windows.macOSではclone（コピーオンライトとも呼ばれる）に、LinuxおよびWindowsではhardlinkにデフォルト設定されています。

WARNING: The use of symlink link mode is discouraged, as they create tight coupling between the cache and the target environment. For example, clearing the cache (uv cache clean) will break all installed packages by way of removing the underlying source files. Use symlinks with caution.警告：シンボリックリンクモードの使用は推奨されません。キャッシュとターゲット環境の間に強い結合を作成するためです。たとえば、キャッシュをクリアすること（uv cache clean）は、基になるソースファイルを削除することによってすべてのインストールされたパッケージを壊します。シンボリックリンクは注意して使用してください。

May also be set with the UV_LINK_MODE environment variable.UV_LINK_MODE 環境変数で設定することもできます。

Possible values:可能な値：

clone: Clone (i.e., copy-on-write) packages from the wheel into the site-packages directoryclone: ホイールからsite-packagesディレクトリにパッケージをクローン（すなわち、コピーオンライト）します。
copy: Copy packages from the wheel into the site-packages directorycopy: ホイールからsite-packagesディレクトリにパッケージをコピーします。
hardlink: Hard link packages from the wheel into the site-packages directoryhardlink: ホイールからsite-packagesディレクトリにパッケージをハードリンクします。
symlink: Symbolically link packages from the wheel into the site-packages directorysymlink: ホイールからsite-packagesディレクトリにパッケージをシンボリックリンクします。

--managed-python--managed-python

Require use of uv-managed Python versions.uvが管理するPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンの使用を優先します。ただし、uvが管理するPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションはシステムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートセットであり、これをuvに含めることでポータビリティとパフォーマンス（特にmacOSで）が向上します。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、プラットフォームのネイティブ証明書ストアを使用したいことがあります。特に、システムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合です。

May also be set with the UV_NATIVE_TLS environment variable.また、UV_NATIVE_TLS環境変数で設定することもできます。

--no-binary--no-binary

Don't install pre-built wheels.事前にビルドされたホイールをインストールしないでください。

The given packages will be built and installed from source. The resolver will still use pre-built wheels to extract package metadata, if available.指定されたパッケージはソースからビルドされ、インストールされます。リゾルバは、利用可能な場合、パッケージメタデータを抽出するために事前にビルドされたホイールを使用します。

May also be set with the UV_NO_BINARY environment variable.また、UV_NO_BINARY環境変数で設定することもできます。

--no-binary-package no-binary-package--no-binary-package no-binary-package

Don't install pre-built wheels for a specific package特定のパッケージに対して事前にビルドされたホイールをインストールしないでください。

May also be set with the UV_NO_BINARY_PACKAGE environment variable.また、UV_NO_BINARY_PACKAGE環境変数で設定することもできます。

--no-build--no-build

Don't build source distributions.ソース配布物のビルドを行いません。

When enabled, resolving will not run arbitrary Python code. The cached wheels of already-built source distributions will be reused, but operations that require building distributions will exit with an error.有効にすると、解決時に任意のPythonコードは実行されません。既にビルドされたソース配布物のキャッシュされたホイールが再利用されますが、配布物のビルドを必要とする操作はエラーで終了します。

May also be set with the UV_NO_BUILD environment variable.UV_NO_BUILD 環境変数でも設定できます。

--no-build-isolation--no-build-isolation

Disable isolation when building source distributions.ソース配布物のビルド時に隔離を無効にします。

Assumes that build dependencies specified by PEP 518 are already installed.PEP 518で指定されたビルド依存関係がすでにインストールされていると仮定します。

May also be set with the UV_NO_BUILD_ISOLATION environment variable.UV_NO_BUILD_ISOLATION 環境変数でも設定できます。

--no-build-isolation-package no-build-isolation-package--no-build-isolation-package no-build-isolation-package

Disable isolation when building source distributions for a specific package.特定のパッケージのソース配布物をビルドする際に隔離を無効にします。

Assumes that the packages' build dependencies specified by PEP 518 are already installed.PEP 518で指定されたパッケージのビルド依存関係がすでにインストールされていることを前提とします。

--no-build-logs--no-build-logs

Hide logs from the build backendビルドバックエンドからのログを非表示にします

--no-build-package no-build-package--no-build-package no-build-package

Don't build source distributions for a specific package特定のパッケージのソース配布物をビルドしない

May also be set with the UV_NO_BUILD_PACKAGE environment variable.環境変数UV_NO_BUILD_PACKAGEでも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します

May also be set with the UV_NO_CACHE environment variable.環境変数UV_NO_CACHEでも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml、uv.toml）の発見を避ける。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.UV_NO_CONFIG 環境変数で設定することもできます。

--no-create-gitignore--no-create-gitignore

Do not create a .gitignore file in the output directory.出力ディレクトリに .gitignore ファイルを作成しない。

By default, uv creates a .gitignore file in the output directory to exclude build artifacts from version control. When this flag is used, the file will be omitted.デフォルトでは、uvは出力ディレクトリにビルドアーティファクトをバージョン管理から除外するための .gitignore ファイルを作成します。このフラグが使用されると、ファイルは省略されます。

--no-index--no-index

Ignore the registry index (e.g., PyPI), instead relying on direct URL dependencies and those provided via --find-linksレジストリインデックス（例：PyPI）を無視し、代わりに直接URL依存関係および --find-links を介して提供されるものに依存します。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--no-sources--no-sources

Ignore the tool.uv.sources table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any workspace, Git, URL, or local path sources依存関係を解決する際にtool.uv.sourcesテーブルを無視します。これは、ワークスペース、Git、URL、またはローカルパスソースを使用するのではなく、標準準拠の公開可能なパッケージメタデータに対してロックするために使用されます。

May also be set with the UV_NO_SOURCES environment variable.環境変数 UV_NO_SOURCES で設定することもできます。

--no-verify-hashes--no-verify-hashes

Disable validation of hashes in the requirements file.requirementsファイル内のハッシュの検証を無効にします。

By default, uv will verify any available hashes in the requirements file, but will not require that all requirements have an associated hash. To enforce hash validation, use --require-hashes.デフォルトでは、uvはrequirementsファイル内の利用可能なハッシュを検証しますが、すべてのrequirementsに関連付けられたハッシュが必要とはしません。ハッシュの検証を強制するには、--require-hashes を使用します。

May also be set with the UV_NO_VERIFY_HASHES environment variable.環境変数 UV_NO_VERIFY_HASHES で設定することもできます。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.環境変数 UV_OFFLINE で設定することもできます。

--out-dir, -o out-dir--out-dir, -o out-dir

The output directory to which distributions should be written.配布物が書き込まれる出力ディレクトリ。

Defaults to the dist subdirectory within the source directory, or the directory containing the source distribution archive.デフォルトでは、ソースディレクトリ内のdistサブディレクトリ、またはソース配布アーカイブを含むディレクトリになります。

--package package--package package

Build a specific package in the workspace.ワークスペース内の特定のパッケージをビルドします。

The workspace will be discovered from the provided source directory, or the current directory if no source directory is provided.ワークスペースは、提供されたソースディレクトリから発見されます。ソースディレクトリが提供されていない場合は、現在のディレクトリが使用されます。

If the workspace member does not exist, uv will exit with an error.ワークスペースメンバーが存在しない場合、uvはエラーで終了します。

--prerelease prerelease--prerelease prerelease

The strategy to use when considering pre-release versions.プレリリースバージョンを考慮する際に使用する戦略。

By default, uv will accept pre-releases for packages that only publish pre-releases, along with first-party requirements that contain an explicit pre-release marker in the declared specifiers (if-necessary-or-explicit).デフォルトでは、uvはのみプレリリースを公開するパッケージと、宣言された指定子に明示的なプレリリースマーカーを含むファーストパーティの要件に対してプレリリースを受け入れます（if-necessary-or-explicit）。

May also be set with the UV_PRERELEASE environment variable.UV_PRERELEASE環境変数で設定することもできます。

Possible values:可能な値：

disallow: Disallow all pre-release versionsdisallow: すべてのプレリリースバージョンを禁止する
allow: Allow all pre-release versionsallow: すべてのプレリリースバージョンを許可する
if-necessary: Allow pre-release versions if all versions of a package are pre-releaseif-necessary: すべてのバージョンがプレリリースである場合にプレリリースバージョンを許可する
explicit: Allow pre-release versions for first-party packages with explicit pre-release markers in their version requirementsexplicit: バージョン要件に明示的なプレリリースマーカーがあるファーストパーティパッケージに対してプレリリースバージョンを許可する
if-necessary-or-explicit: Allow pre-release versions if all versions of a package are pre-release, or if the package has an explicit pre-release marker in its version requirementsif-necessary-or-explicit: すべてのバージョンがプレリリースである場合、またはパッケージにバージョン要件に明示的なプレリリースマーカーがある場合にプレリリースバージョンを許可する

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に歩いていくことで発見され、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.作業ディレクトリを完全に変更するには、--directoryを参照してください。

This setting has no effect when used in the uv pip interface.この設定は、uv pipインターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT環境変数でも設定できます。

--python, -p python--python, -p python

The Python interpreter to use for the build environment.ビルド環境で使用するPythonインタプリタ。

By default, builds are executed in isolated virtual environments. The discovered interpreter will be used to create those environments, and will be symlinked or copied in depending on the platform.デフォルトでは、ビルドは孤立した仮想環境で実行されます。発見されたインタプリタは、これらの環境を作成するために使用され、プラットフォームに応じてシンボリックリンクまたはコピーされます。

See uv python to view supported request formats.サポートされているリクエストフォーマットを表示するには、uv pythonを参照してください。

May also be set with the UV_PYTHON environment variable.UV_PYTHON環境変数でも設定できます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uvは標準出力に何も出力しないサイレントモードを有効にします。

--refresh--refresh

Refresh all cached dataすべてのキャッシュデータを更新します

--refresh-package refresh-package--refresh-package refresh-package

Refresh cached data for a specific package特定のパッケージのキャッシュデータを更新します

--require-hashes--require-hashes

Require a matching hash for each requirement.各要件に対して一致するハッシュを要求します。

By default, uv will verify any available hashes in the requirements file, but will not require that all requirements have an associated hash.デフォルトでは、uvは要件ファイル内の利用可能なハッシュを検証しますが、すべての要件に関連付けられたハッシュが必要であるとは限りません。

When --require-hashes is enabled, all requirements must include a hash or set of hashes, and all requirements must either be pinned to exact versions (e.g., ==1.0.0), or be specified via direct URL.--require-hashes が有効な場合、すべての要件にはハッシュまたはハッシュのセットが含まれている必要があり、すべての要件は正確なバージョンに固定される必要があります（例： ==1.0.0）、または直接URLで指定される必要があります。

Hash-checking mode introduces a number of additional constraints:ハッシュチェックモードは、いくつかの追加の制約を導入します：

Git dependencies are not supported. - Editable installations are not supported. - Local dependencies are not supported, unless they point to a specific wheel (.whl) or source archive (.zip, .tar.gz), as opposed to a directory.Git依存関係はサポートされていません。 - 編集可能なインストールはサポートされていません。 - ローカル依存関係は、特定のホイール（.whl）またはソースアーカイブ（.zip, .tar.gz）を指す場合を除き、サポートされていません。

May also be set with the UV_REQUIRE_HASHES environment variable.UV_REQUIRE_HASHES 環境変数で設定することもできます。

--resolution resolution--resolution 解像度

The strategy to use when selecting between the different compatible versions for a given package requirement.特定のパッケージ要件に対して異なる互換バージョンを選択する際に使用する戦略。

By default, uv will use the latest compatible version of each package (highest).デフォルトでは、uvは各パッケージの最新の互換バージョン（highest）を使用します。

May also be set with the UV_RESOLUTION environment variable.UV_RESOLUTION 環境変数で設定することもできます。

Possible values:可能な値：

highest: Resolve the highest compatible version of each packagehighest: 各パッケージの最高の互換バージョンを解決します。
lowest: Resolve the lowest compatible version of each packagelowest: 各パッケージの最低の互換バージョンを解決します。
lowest-direct: Resolve the lowest compatible version of any direct dependencies, and the highest compatible version of any transitive dependencieslowest-direct: 直接依存関係の最低の互換バージョンを解決し、間接依存関係の最高の互換バージョンを解決します。

--sdist--sdist

Build a source distribution ("sdist") from the given directory指定されたディレクトリからソース配布（"sdist"）をビルドします

--upgrade, -U--upgrade, -U

Allow package upgrades, ignoring pinned versions in any existing output file. Implies --refreshパッケージのアップグレードを許可し、既存の出力ファイルに固定されたバージョンを無視します。--refreshを含意します

--upgrade-package, -P upgrade-package--upgrade-package, -P upgrade-package

Allow upgrades for a specific package, ignoring pinned versions in any existing output file. Implies --refresh-package特定のパッケージのアップグレードを許可し、既存の出力ファイルに固定されたバージョンを無視します。--refresh-packageを含意します

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)環境変数 RUST_LOG を使用して、詳細なロギングを構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

--wheel--wheel

Build a binary distribution ("wheel") from the given directory指定されたディレクトリからバイナリ配布（"wheel"）をビルドします

uv publishuv publish

Upload distributions to an index配布物をインデックスにアップロードします

Usage使用法

uv publish [OPTIONS] [FILES]...

Arguments引数

FILESFILES

Paths to the files to upload. Accepts glob expressions.アップロードするファイルへのパス。グロブ式を受け入れます。

Defaults to the dist directory. Selects only wheels and source distributions and their attestations, while ignoring other files.デフォルトはdistディレクトリです。ホイールとソース配布およびその証明書のみを選択し、他のファイルは無視します。

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正な接続を許可します。

Can be provided multiple times.複数回指定することができます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数で設定することもできます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvにデフォルト設定され、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されます。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数で設定することもできます。

--check-url check-url--check-url check-url

Check an index URL for existing files to skip duplicate uploads.重複アップロードをスキップするために、インデックスURLをチェックします。

This option allows retrying publishing that failed after only some, but not all files have been uploaded, and handles errors due to parallel uploads of the same file.このオプションは、すべてのファイルがアップロードされる前に失敗した公開を再試行することを可能にし、同じファイルの並列アップロードによるエラーを処理します。

Before uploading, the index is checked. If the exact same file already exists in the index, the file will not be uploaded. If an error occurred during the upload, the index is checked again, to handle cases where the identical file was uploaded twice in parallel.アップロード前にインデックスがチェックされます。インデックスに全く同じファイルが既に存在する場合、そのファイルはアップロードされません。アップロード中にエラーが発生した場合、同じファイルが並列で二重にアップロードされたケースを処理するために、インデックスが再度チェックされます。

The exact behavior will vary based on the index. When uploading to PyPI, uploading the same file succeeds even without --check-url, while most other indexes error. When uploading to pyx, the index URL can be inferred automatically from the publish URL.正確な動作はインデックスによって異なります。PyPIにアップロードする場合、--check-urlなしでも同じファイルのアップロードは成功しますが、他のほとんどのインデックスではエラーになります。pyxにアップロードする場合、インデックスURLは公開URLから自動的に推測できます。

The index must provide one of the supported hashes (SHA-256, SHA-384, or SHA-512).インデックスは、サポートされているハッシュのいずれか（SHA-256、SHA-384、またはSHA-512）を提供する必要があります。

May also be set with the UV_PUBLISH_CHECK_URL environment variable.また、UV_PUBLISH_CHECK_URL環境変数で設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvはターミナルに書き込む際に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力が端末またはTTYに送信される場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用するuv.tomlファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数で設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数でも設定できます。

--dry-run--dry-run

Perform a dry run without uploading files.ファイルをアップロードせずにドライランを実行します。

When enabled, the command will check for existing files if --check-url is provided, and will perform validation against the index if supported, but will not upload any files.有効にすると、--check-urlが提供されている場合、コマンドは既存のファイルを確認し、サポートされている場合はインデックスに対して検証を行いますが、ファイルはアップロードしません。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--index index--index index

The name of an index in the configuration to use for publishing.公開に使用する設定内のインデックスの名前。

The index must have a publish-url setting, for example:インデックスには、publish-url 設定が必要です。例えば：

[[tool.uv.index]]
name = "pypi"
url = "https://pypi.org/simple"
publish-url = "https://upload.pypi.org/legacy/"

The index url will be used to check for existing files to skip duplicate uploads.インデックス url は、既存のファイルをチェックして重複アップロードをスキップするために使用されます。

With these settings, the following two calls are equivalent:これらの設定を使用すると、次の2つの呼び出しは同等です：

uv publish --index pypi
uv publish --publish-url https://upload.pypi.org/legacy/ --check-url https://pypi.org/simple

May also be set with the UV_PUBLISH_INDEX environment variable.UV_PUBLISH_INDEX 環境変数でも設定できます。

--keyring-provider keyring-provider--keyring-provider keyring-provider

Attempt to use keyring for authentication for remote requirements files.リモート要件ファイルの認証に keyring を使用しようとします。

At present, only --keyring-provider subprocess is supported, which configures uv to use the keyring CLI to handle authentication.現在、--keyring-provider subprocess のみがサポートされており、これは uv が認証を処理するために keyring CLI を使用するように構成します。

Defaults to disabled.デフォルトは disabled です。

May also be set with the UV_KEYRING_PROVIDER environment variable.UV_KEYRING_PROVIDER 環境変数でも設定できます。

Possible values:可能な値：

disabled: Do not use keyring for credential lookupdisabled: 認証情報の検索にキーチェーンを使用しない
subprocess: Use the keyring command for credential lookupsubprocess: 認証情報の検索にkeyringコマンドを使用する

--managed-python--managed-python

Require use of uv-managed Python versions.uv管理のPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンの使用を優先します。ただし、uv管理のPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることで移植性とパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、特にシステムの証明書ストアに含まれる企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したいことがあります。

May also be set with the UV_NATIVE_TLS environment variable.環境変数 UV_NATIVE_TLS で設定することもできます。

--no-attestations--no-attestations

Do not upload attestations for the published files.公開されたファイルのためにアテステーションをアップロードしないでください。

By default, uv attempts to upload matching PEP 740 attestations with each distribution that is published.デフォルトでは、uvは公開される各ディストリビューションに対して一致するPEP 740アテステーションをアップロードしようとします。

May also be set with the UV_PUBLISH_NO_ATTESTATIONS environment variable.環境変数 UV_PUBLISH_NO_ATTESTATIONS で設定することもできます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.環境変数 UV_NO_CACHE で設定することもできます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).pyproject.toml、uv.tomlなどの設定ファイルを発見しないようにします。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.また、UV_NO_CONFIG 環境変数で設定することもできます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv-managed Python バージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.また、UV_NO_MANAGED_PYTHON 環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.また、UV_NO_PROGRESS 環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数でも設定できます。

--password, -p password--password, -p password

The password for the uploadアップロードのためのパスワード

May also be set with the UV_PUBLISH_PASSWORD environment variable.UV_PUBLISH_PASSWORD 環境変数でも設定できます。

--project project--project project

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に歩いていくことで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数で設定することもできます。

--publish-url publish-url--publish-url publish-url

The URL of the upload endpoint (not the index URL).アップロードエンドポイントのURL（インデックスURLではありません）。

Note that there are typically different URLs for index access (e.g., https:://.../simple) and index upload.インデックスアクセス用のURL（例： https:://.../simple）とインデックスアップロード用のURLは通常異なることに注意してください。

Defaults to PyPI's publish URL (https://upload.pypi.org/legacy/).デフォルトはPyPIの公開URL (https://upload.pypi.org/legacy/) です。

May also be set with the UV_PUBLISH_URL environment variable.環境変数 UV_PUBLISH_URL で設定することもできます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uvがstdoutに出力を行わないサイレントモードを有効にします。

--token, -t token--token, -t token

The token for the upload.アップロード用のトークンです。

Using a token is equivalent to passing __token__ as --username and the token as --password password.トークンを使用することは、--username に __token__ を渡し、トークンを --password として渡すことと同等です。

May also be set with the UV_PUBLISH_TOKEN environment variable.環境変数 UV_PUBLISH_TOKEN で設定することもできます。

--trusted-publishing trusted-publishing--trusted-publishing trusted-publishing

Configure trusted publishing.信頼できる公開を設定します。

By default, uv checks for trusted publishing when running in a supported environment, but ignores it if it isn't configured.デフォルトでは、uvはサポートされている環境で実行される際に信頼された公開をチェックしますが、設定されていない場合は無視します。

uv's supported environments for trusted publishing include GitHub Actions and GitLab CI/CD.uvの信頼された公開のサポートされている環境には、GitHub ActionsとGitLab CI/CDが含まれます。

Possible values:可能な値:

automatic: Attempt trusted publishing when we're in a supported environment, continue if that failsautomatic: サポートされている環境にいる場合は信頼された公開を試み、失敗した場合は続行します。
alwaysalways
nevernever

--username, -u username--username, -u username

The username for the uploadアップロードのためのユーザー名

May also be set with the UV_PUBLISH_USERNAME environment variable.また、UV_PUBLISH_USERNAME環境変数を使用して設定することもできます。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)環境変数 RUST_LOG を使用して、細かいログ設定を行うことができます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv cacheuv キャッシュ

Manage uv's cacheuv のキャッシュを管理します

Usage使用法

uv cache [OPTIONS] <COMMAND>

Commandsコマンド

uv cache cleanuv cache clean: Clear the cache, removing all entries or those linked to specific packagesキャッシュをクリアし、すべてのエントリまたは特定のパッケージに関連付けられたエントリを削除します
uv cache pruneuv cache prune: Prune all unreachable objects from the cacheキャッシュから到達不可能なすべてのオブジェクトを削除します
uv cache diruv cache dir: Show the cache directoryキャッシュディレクトリを表示
uv cache sizeuv cache size: Show the cache sizeキャッシュサイズを表示

uv cache cleanuv cache clean

Clear the cache, removing all entries or those linked to specific packagesキャッシュをクリアし、すべてのエントリまたは特定のパッケージに関連するエントリを削除します

Usage使用法

uv cache clean [OPTIONS] [PACKAGE]...

Arguments引数

PACKAGEPACKAGE: The packages to remove from the cacheキャッシュから削除するパッケージ

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例: localhost）、ホスト-ポートペア（例: localhost:8080）、またはURL（例: https://localhost）を受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告: このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、検証済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvにデフォルト設定され、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されます。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数を使用して設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末への書き込み時に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力がサポートされている端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.uv.tomlファイルのパスを設定に使用します。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.pyproject.tomlファイルにuvの設定を含めることはできますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数で設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数で設定することもできます。

--force--force

Force removal of the cache, ignoring in-use checks.使用中のチェックを無視してキャッシュを強制的に削除します。

By default, uv cache clean will block until no process is reading the cache. When --force is used, uv cache clean will proceed without taking a lock.デフォルトでは、uv cache cleanはキャッシュを読み取っているプロセスがなくなるまでブロックします。--forceを使用すると、uv cache cleanはロックを取らずに進行します。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します

--managed-python--managed-python

Require use of uv-managed Python versions.uv-managed Pythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理しているPythonバージョンを使用することを好みます。ただし、uv-managed Pythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数で設定することもできます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、いくつかのケースでは、プラットフォームのネイティブ証明書ストアを使用したい場合があります。特に、システムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合です。

May also be set with the UV_NATIVE_TLS environment variable.UV_NATIVE_TLS 環境変数を使用して設定することもできます。

--no-cache, --no-cache-dir, -n--no-cache、--no-cache-dir、-n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.UV_NO_CACHE 環境変数を使用して設定することもできます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml、uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.UV_NO_CONFIG 環境変数を使用して設定することもできます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.その代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数を使用して設定することもできます。

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に歩くことで発見され、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.作業ディレクトリを完全に変更するには --directory を参照してください。

This setting has no effect when used in the uv pip interface.この設定は uv pip インターフェースで使用されると効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数を使用して設定することもできます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すと、例えば -qq のように、uvは標準出力に何も出力しないサイレントモードが有効になります。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)細かいログ記録は RUST_LOG 環境変数を使用して設定できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv cache pruneuv cache prune

Prune all unreachable objects from the cacheキャッシュから到達不可能なすべてのオブジェクトを削除します。

Usage使用法

uv cache prune [OPTIONS]

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの安全でない接続を許可します。

Can be provided multiple times.複数回提供できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）を受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvに、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されています。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行してください。

May also be set with the UV_CACHE_DIR environment variable.環境変数 UV_CACHE_DIR でも設定できます。

--ci--ci

Optimize the cache for persistence in a continuous integration environment, like GitHub Actions.GitHub Actions のような継続的インテグレーション環境での持続性のためにキャッシュを最適化します。

By default, uv caches both the wheels that it builds from source and the pre-built wheels that it downloads directly, to enable high-performance package installation. In some scenarios, though, persisting pre-built wheels may be undesirable. For example, in GitHub Actions, it's faster to omit pre-built wheels from the cache and instead have re-download them on each run. However, it typically is faster to cache wheels that are built from source, since the wheel building process can be expensive, especially for extension modules.デフォルトでは、uv はソースからビルドしたホイールと、直接ダウンロードした事前ビルドのホイールの両方をキャッシュし、高性能なパッケージインストールを可能にします。ただし、いくつかのシナリオでは、事前ビルドのホイールを保持することが望ましくない場合があります。たとえば、GitHub Actions では、キャッシュから事前ビルドのホイールを省略し、各実行時に再ダウンロードする方が速くなります。しかし、ソースからビルドされたホイールをキャッシュする方が通常は速いです。なぜなら、ホイールのビルドプロセスは高コストになる可能性があるためで、特に拡張モジュールの場合はそうです。

In --ci mode, uv will prune any pre-built wheels from the cache, but retain any wheels that were built from source.--ci モードでは、uv はキャッシュから事前ビルドのホイールを削除しますが、ソースからビルドされたホイールは保持します。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uv はターミナルに書き込む際に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力が色のサポートを持つターミナルまたは TTY に向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 環境に関係なくカラフルな出力を有効にします
never: Disables colored outputnever: カラフルな出力を無効にします

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.uv.toml ファイルのパスを設定に使用します。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定は pyproject.toml ファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE 環境変数で設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--project を参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.環境変数 UV_WORKING_DIRECTORY でも設定できます。

--force--force

Force removal of the cache, ignoring in-use checks.キャッシュの強制削除、使用中のチェックを無視します。

By default, uv cache prune will block until no process is reading the cache. When --force is used, uv cache prune will proceed without taking a lock.デフォルトでは、uv cache prune はキャッシュを読み取っているプロセスがないまでブロックします。--force を使用すると、uv cache prune はロックを取らずに進行します。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--managed-python--managed-python

Require use of uv-managed Python versions.uv-managed Python バージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uv は管理している Python バージョンの使用を優先します。ただし、uv-managed Python がインストールされていない場合は、システムの Python バージョンを使用します。このオプションはシステムの Python バージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.環境変数 UV_MANAGED_PYTHON でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートセットであり、これをuvに含めることでポータビリティとパフォーマンス（特にmacOSで）が向上します。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、特にシステムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したいことがあります。

May also be set with the UV_NATIVE_TLS environment variable.UV_NATIVE_TLS環境変数でも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.UV_NO_CACHE環境変数でも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml, uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.また、UV_NO_CONFIG 環境変数で設定することもできます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.その代わりに、uvはシステム上で適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.また、UV_NO_MANAGED_PYTHON 環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.また、UV_NO_PROGRESS 環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数を使用して設定することもできます。

--project project--project project

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に向かって歩くことで発見され、プロジェクトの仮想環境（.venv）も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.作業ディレクトリを完全に変更するには、--directoryを参照してください。

This setting has no effect when used in the uv pip interface.この設定は、uv pipインターフェースで使用されると効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT環境変数を使用して設定することもできます。

--quiet, -q--quiet、-q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すと、例えば-qq、uvはstdoutに出力を行わないサイレントモードが有効になります。

--verbose, -v--verbose、-v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)RUST_LOG環境変数を使用して、細かいログ設定を行うことができます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv cache diruvキャッシュディレクトリ

Show the cache directory.キャッシュディレクトリを表示します。

By default, the cache is stored in $XDG_CACHE_HOME/uv or $HOME/.cache/uv on Unix and %LOCALAPPDATA%\uv\cache on Windows.デフォルトでは、キャッシュは $XDG_CACHE_HOME/uv または $HOME/.cache/uv にUnixで、%LOCALAPPDATA%\uv\cache にWindowsで保存されます。

When --no-cache is used, the cache is stored in a temporary directory and discarded when the process exits.--no-cache が使用されると、キャッシュは一時ディレクトリに保存され、プロセスが終了すると破棄されます。

An alternative cache directory may be specified via the cache-dir setting, the --cache-dir option, or the $UV_CACHE_DIR environment variable.代替のキャッシュディレクトリは、cache-dir 設定、--cache-dir オプション、または $UV_CACHE_DIR 環境変数を介して指定できます。

Note that it is important for performance for the cache directory to be located on the same file system as the Python environment uv is operating on.キャッシュディレクトリは、uvが動作しているPython環境と同じファイルシステム上にあることがパフォーマンスにとって重要です。

Usage使用法

uv cache dir [OPTIONS]

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host、--trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回提供することができます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数で設定することもできます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvに、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されています。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数で設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvはターミナルへの書き込み時に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: ターミナルまたはサポートのあるTTYに出力される場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用するuv.tomlファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数を使用して設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更してください。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数でも設定できます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--managed-python--managed-python

Require use of uv-managed Python versions.uv-managed Pythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理しているPythonバージョンの使用を優先します。ただし、uv-managed Pythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON環境変数でも設定できます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートセットであり、これをuvに含めることでポータビリティとパフォーマンス（特にmacOSで）が向上します。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、特にシステムの証明書ストアに含まれる企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したいことがあります。

May also be set with the UV_NATIVE_TLS environment variable.UV_NATIVE_TLS環境変数でも設定できます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の期間中は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.UV_NO_CACHE環境変数でも設定できます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).pyproject.tomlやuv.tomlなどの設定ファイルを発見するのを避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.UV_NO_CONFIG 環境変数で設定することもできます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.その代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON 環境変数で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS 環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数を使用して設定することもできます。

--project project--project project

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に辿ることで発見され、プロジェクトの仮想環境（.venv）も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.作業ディレクトリを完全に変更するには、--directoryを参照してください。

This setting has no effect when used in the uv pip interface.この設定は、uv pipインターフェースで使用されると効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT環境変数を使用して設定することもできます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すと、例えば-qqのように、uvはstdoutに出力を行わないサイレントモードが有効になります。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)RUST_LOG環境変数を使用して、詳細なロギングを構成できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv cache sizeuvキャッシュサイズ

Show the cache size.キャッシュサイズを表示します。

Displays the total size of the cache directory. This includes all downloaded and built wheels, source distributions, and other cached data. By default, outputs the size in raw bytes; use --human for human-readable output.キャッシュディレクトリの合計サイズを表示します。これには、すべてのダウンロード済みおよびビルド済みのホイール、ソース配布、およびその他のキャッシュデータが含まれます。デフォルトでは、生のバイトでサイズを出力します。人間が読みやすい出力には、--humanを使用してください。

Usage使用法

uv cache size [OPTIONS]

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正な接続を許可します。

Can be provided multiple times.複数回提供できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、検証されたソースを持つ安全なネットワーク内でのみ使用してください。これはSSL検証をバイパスし、MITM攻撃にさらされる可能性があります。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.デフォルトでは、$XDG_CACHE_HOME/uv または $HOME/.cache/uv（macOSおよびLinuxの場合）、および %LOCALAPPDATA%\uv\cache（Windowsの場合）です。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR 環境変数を使用して設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvはターミナルに書き込む際に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力がサポートされているターミナルまたはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 環境に関係なくカラー出力を有効にします
never: Disables colored outputnever: カラー出力を無効にします

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用するuv.tomlファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.pyproject.tomlファイルにuv設定を含めることはできますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数で設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.また、UV_WORKING_DIRECTORY 環境変数で設定することもできます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します

--human, --human-readable, -H--human, --human-readable, -H

Display the cache size in human-readable format (e.g., 1.2 GiB instead of raw bytes)キャッシュサイズを人間が読みやすい形式で表示します（例：1.2 GiB のように生のバイトではなく）

--managed-python--managed-python

Require use of uv-managed Python versions.uvが管理するPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンの使用を優先します。ただし、uvが管理するPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.また、UV_MANAGED_PYTHON 環境変数で設定することもできます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンス（特にmacOSで）が向上します。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、特にシステムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したいことがあります。

May also be set with the UV_NATIVE_TLS environment variable.また、UV_NATIVE_TLS環境変数で設定することもできます。

--no-cache, --no-cache-dir, -n--no-cache、--no-cache-dir、-n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の期間中は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.また、UV_NO_CACHE環境変数で設定することもできます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml、uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.環境変数 UV_NO_CONFIG で設定することもできます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.環境変数 UV_NO_MANAGED_PYTHON で設定することもできます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.環境変数 UV_NO_PROGRESS で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数を使用して設定することもできます。

--project project--project project

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見され、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数でも設定できます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uv が stdout に出力しないサイレントモードを有効にします。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)RUST_LOG 環境変数を使用して、細かいログ設定を行うことができます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv selfuv self

Manage the uv executableuv 実行可能ファイルを管理します

Usage使用法

uv self [OPTIONS] <COMMAND>

Commandsコマンド

uv self updateuv self update: Update uvuvを更新する
uv self versionuv self version: Display uv's versionuvのバージョンを表示する

uv self updateuv self update

Update uvuvを更新する

Usage使用法

uv self update [OPTIONS] [TARGET_VERSION]

Arguments引数

TARGET_VERSIONTARGET_VERSION: Update to the specified version. If not provided, uv will update to the latest version指定されたバージョンに更新します。指定されていない場合、uvは最新バージョンに更新します。

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正な接続を許可します。

Can be provided multiple times.複数回提供できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホストポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数で設定することもできます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvに、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されています。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数を使用して設定することもできます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末に書き込む際に色のサポートを自動的に検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力がサポートされている端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用するuv.tomlファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.pyproject.tomlファイルにuvの設定を含めることはできますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数で設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数で設定することもできます。

--dry-run--dry-run

Run without performing the update更新を実行せずに実行する

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示する

--managed-python--managed-python

Require use of uv-managed Python versions.uv-managed Python バージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理しているPythonバージョンの使用を優先します。ただし、uv-managed Pythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.UV_MANAGED_PYTHON 環境変数で設定することもできます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされたwebpki-rootsクレートから証明書を読み込みます。webpki-rootsはMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、場合によっては、プラットフォームのネイティブ証明書ストアを使用したいことがあります。特に、システムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合です。

May also be set with the UV_NATIVE_TLS environment variable.また、UV_NATIVE_TLS環境変数で設定することもできます。

--no-cache, --no-cache-dir, -n--no-cache、--no-cache-dir、-n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.また、UV_NO_CACHE環境変数で設定することもできます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml、uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.また、UV_NO_CONFIG環境変数で設定することもできます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv-managed Python バージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.その代わりに、uv はシステム上の適切な Python バージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON 環境変数でも設定できます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS 環境変数でも設定できます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Python の自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数を使用して設定することもできます。

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に辿ることで発見され、プロジェクトの仮想環境（.venv）も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.また、UV_PROJECT 環境変数で設定することもできます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uvがstdoutに出力しないサイレントモードを有効にします。

--token token--token token

A GitHub token for authentication. A token is not required but can be used to reduce the chance of encountering rate limits認証用のGitHubトークン。トークンは必須ではありませんが、レート制限に遭遇する可能性を減らすために使用できます。

May also be set with the UV_GITHUB_TOKEN environment variable.また、UV_GITHUB_TOKEN 環境変数で設定することもできます。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)RUST_LOG 環境変数を使用して、細かいログ設定を行うことができます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv self versionuvの自己バージョン

Display uv's versionuvのバージョンを表示

Usage使用法

uv self version [OPTIONS]

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、検証済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--cache-dir cache-dir--cache-dir キャッシュディレクトリ

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.デフォルトでは $XDG_CACHE_HOME/uv または $HOME/.cache/uv（macOSおよびLinux）、および %LOCALAPPDATA%\uv\cache（Windows）に設定されています。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を表示するには、uv cache dirを実行します。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR 環境変数を使用して設定することもできます。

--color color-choice--color 色の選択

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvはターミナルへの書き込み時に自動的に色のサポートを検出します。

Possible values:可能な値：

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力が色のサポートを持つターミナルまたはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 環境に関係なくカラフルな出力を有効にします
never: Disables colored outputnever: カラフルな出力を無効にします

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.uv.toml ファイルのパスを設定に使用します。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE 環境変数で設定することもできます。

--directory directory--directory directory

Change to the given directory prior to running the command.コマンドを実行する前に指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.環境変数 UV_WORKING_DIRECTORY で設定することもできます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します

--managed-python--managed-python

Require use of uv-managed Python versions.uv-managed Python バージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理しているPythonバージョンを使用することを好みます。ただし、uv-managed Pythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.環境変数 UV_MANAGED_PYTHON で設定することもできます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされた webpki-roots クレートから証明書を読み込みます。webpki-roots はMozillaからの信頼できるルートのセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、いくつかのケースでは、プラットフォームのネイティブ証明書ストアを使用したい場合があります。特に、システムの証明書ストアに含まれている企業の信頼ルート（例：必須プロキシ）に依存している場合です。

May also be set with the UV_NATIVE_TLS environment variable.また、UV_NATIVE_TLS 環境変数で設定することもできます。

--no-cache, --no-cache-dir, -n--no-cache、--no-cache-dir、-n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の間は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.また、UV_NO_CACHE 環境変数で設定することもできます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml、uv.toml）の発見を避けます。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.また、UV_NO_CONFIG 環境変数で設定することもできます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uvによる管理されたPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON 環境変数でも設定できます。

--no-progress--no-progress

Hide all progress outputs.すべての進行状況出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーなどです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS 環境変数でも設定できます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数を使用して設定することもできます。

--output-format output-format--output-format 出力形式

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に歩くことで発見され、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.また、UV_PROJECT 環境変数で設定することもできます。

--quiet, -q--quiet, -q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uv が stdout に出力を行わないサイレントモードを有効にします。

--short--short

Only print the versionバージョンのみを表示します。

--verbose, -v--verbose, -v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)RUST_LOG 環境変数を使用して、細かいログ設定を行うことができます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv generate-shell-completionuv generate-shell-completion

Generate shell completionシェル補完を生成する

Usage使用法

uv generate-shell-completion [OPTIONS] <SHELL>

Arguments引数

SHELLSHELL: The shell to generate the completion script for補完スクリプトを生成するためのシェル

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回指定できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）を受け取ることを期待しています。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告: このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--directory directory--directory ディレクトリ

Change to the given directory prior to running the command.コマンドを実行する前に、指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数でも設定できます。

--managed-python--managed-python

Require use of uv-managed Python versions.uv管理のPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理するPythonバージョンの使用を優先します。ただし、uv管理のPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.環境変数 UV_MANAGED_PYTHON で設定することもできます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv-managed Python バージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.その代わりに、uv はシステム上の適切な Python バージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.環境変数 UV_NO_MANAGED_PYTHON で設定することもできます。

--project project--project project

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に辿ることで発見され、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.作業ディレクトリを完全に変更するには --directory を参照してください。

This setting has no effect when used in the uv pip interface.この設定は、uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数でも設定できます。

uv helpuv help

Display documentation for a commandコマンドのドキュメントを表示します

Usage使用法

uv help [OPTIONS] [COMMAND]...

Arguments引数

COMMANDCOMMAND

Optionsオプション

--allow-insecure-host, --trusted-host allow-insecure-host--allow-insecure-host, --trusted-host allow-insecure-host

Allow insecure connections to a host.ホストへの不正接続を許可します。

Can be provided multiple times.複数回提供できます。

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).ホスト名（例：localhost）、ホスト-ポートペア（例：localhost:8080）、またはURL（例：https://localhost）のいずれかを受け取ることを期待します。

WARNING: Hosts included in this list will not be verified against the system's certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.警告：このリストに含まれるホストは、システムの証明書ストアに対して検証されません。--allow-insecure-hostは、SSL検証をバイパスし、MITM攻撃にさらされる可能性があるため、確認済みのソースを持つ安全なネットワークでのみ使用してください。

May also be set with the UV_INSECURE_HOST environment variable.UV_INSECURE_HOST環境変数でも設定できます。

--cache-dir cache-dir--cache-dir cache-dir

Path to the cache directory.キャッシュディレクトリへのパス。

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on macOS and Linux, and %LOCALAPPDATA%\uv\cache on Windows.macOSおよびLinuxでは$XDG_CACHE_HOME/uvまたは$HOME/.cache/uvに、Windowsでは%LOCALAPPDATA%\uv\cacheにデフォルト設定されています。

To view the location of the cache directory, run uv cache dir.キャッシュディレクトリの場所を確認するには、uv cache dirを実行してください。

May also be set with the UV_CACHE_DIR environment variable.UV_CACHE_DIR環境変数でも設定できます。

--color color-choice--color color-choice

Control the use of color in output.出力における色の使用を制御します。

By default, uv will automatically detect support for colors when writing to a terminal.デフォルトでは、uvは端末への書き込み時に色のサポートを自動的に検出します。

Possible values:可能な値:

auto: Enables colored output only when the output is going to a terminal or TTY with supportauto: 出力がサポートされている端末またはTTYに向けられている場合のみ、カラー出力を有効にします。
always: Enables colored output regardless of the detected environmentalways: 検出された環境に関係なく、カラー出力を常に有効にします。
never: Disables colored outputnever: カラー出力を無効にします。

--config-file config-file--config-file config-file

The path to a uv.toml file to use for configuration.設定に使用するuv.tomlファイルへのパス。

While uv configuration can be included in a pyproject.toml file, it is not allowed in this context.uvの設定はpyproject.tomlファイルに含めることができますが、このコンテキストでは許可されていません。

May also be set with the UV_CONFIG_FILE environment variable.UV_CONFIG_FILE環境変数を使用して設定することもできます。

--directory directory--directory ディレクトリ

Change to the given directory prior to running the command.コマンドを実行する前に指定されたディレクトリに変更します。

Relative paths are resolved with the given directory as the base.相対パスは、指定されたディレクトリを基準に解決されます。

See --project to only change the project root directory.--projectを参照して、プロジェクトのルートディレクトリのみを変更します。

May also be set with the UV_WORKING_DIRECTORY environment variable.UV_WORKING_DIRECTORY環境変数でも設定できます。

--help, -h--help, -h

Display the concise help for this commandこのコマンドの簡潔なヘルプを表示します。

--managed-python--managed-python

Require use of uv-managed Python versions.uv管理のPythonバージョンの使用を要求します。

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.デフォルトでは、uvは管理しているPythonバージョンの使用を優先します。ただし、uv管理のPythonがインストールされていない場合は、システムのPythonバージョンを使用します。このオプションは、システムのPythonバージョンの使用を無効にします。

May also be set with the UV_MANAGED_PYTHON environment variable.環境変数 UV_MANAGED_PYTHON で設定することもできます。

--native-tls--native-tls

Whether to load TLS certificates from the platform's native certificate store.プラットフォームのネイティブ証明書ストアからTLS証明書を読み込むかどうか。

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).デフォルトでは、uvはバンドルされた webpki-roots クレートから証明書を読み込みます。 webpki-roots はMozillaからの信頼できるルートセットであり、これをuvに含めることでポータビリティとパフォーマンスが向上します（特にmacOSで）。

However, in some cases, you may want to use the platform's native certificate store, especially if you're relying on a corporate trust root (e.g., for a mandatory proxy) that's included in your system's certificate store.ただし、特にシステムの証明書ストアに含まれる企業の信頼ルート（例：必須プロキシ）に依存している場合は、プラットフォームのネイティブ証明書ストアを使用したい場合があります。

May also be set with the UV_NATIVE_TLS environment variable.環境変数 UV_NATIVE_TLS で設定することもできます。

--no-cache, --no-cache-dir, -n--no-cache, --no-cache-dir, -n

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operationキャッシュからの読み取りや書き込みを避け、操作の期間中は一時ディレクトリを使用します。

May also be set with the UV_NO_CACHE environment variable.環境変数 UV_NO_CACHE で設定することもできます。

--no-config--no-config

Avoid discovering configuration files (pyproject.toml, uv.toml).設定ファイル（pyproject.toml、uv.toml）の発見を避ける。

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.通常、設定ファイルは現在のディレクトリ、親ディレクトリ、またはユーザー設定ディレクトリで発見されます。

May also be set with the UV_NO_CONFIG environment variable.UV_NO_CONFIG 環境変数で設定することもできます。

--no-managed-python--no-managed-python

Disable use of uv-managed Python versions.uv管理のPythonバージョンの使用を無効にします。

Instead, uv will search for a suitable Python version on the system.代わりに、uvはシステム上の適切なPythonバージョンを検索します。

May also be set with the UV_NO_MANAGED_PYTHON environment variable.UV_NO_MANAGED_PYTHON 環境変数で設定することもできます。

--no-pager--no-pager

Disable pager when printing helpヘルプを印刷する際にページャーを無効にします。

--no-progress--no-progress

Hide all progress outputs.すべての進捗出力を非表示にします。

For example, spinners or progress bars.例えば、スピナーやプログレスバーです。

May also be set with the UV_NO_PROGRESS environment variable.UV_NO_PROGRESS 環境変数で設定することもできます。

--no-python-downloads--no-python-downloads

Disable automatic downloads of Python.Pythonの自動ダウンロードを無効にします。

--offline--offline

Disable network access.ネットワークアクセスを無効にします。

When disabled, uv will only use locally cached data and locally available files.無効にすると、uvはローカルにキャッシュされたデータとローカルで利用可能なファイルのみを使用します。

May also be set with the UV_OFFLINE environment variable.UV_OFFLINE 環境変数で設定することもできます。

--project project--project プロジェクト

Run the command within the given project directory.指定されたプロジェクトディレクトリ内でコマンドを実行します。

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project's virtual environment (.venv).すべての pyproject.toml、uv.toml、および .python-version ファイルは、プロジェクトルートからディレクトリツリーを上に移動することで発見されます。また、プロジェクトの仮想環境 (.venv) も同様です。

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.他のコマンドライン引数（相対パスなど）は、現在の作業ディレクトリに対して相対的に解決されます。

See --directory to change the working directory entirely.--directory を参照して、作業ディレクトリを完全に変更します。

This setting has no effect when used in the uv pip interface.この設定は uv pip インターフェースで使用されるときには効果がありません。

May also be set with the UV_PROJECT environment variable.UV_PROJECT 環境変数を使用して設定することもできます。

--quiet, -q--quiet、-q

Use quiet output.静かな出力を使用します。

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.このオプションを繰り返すことで、例えば -qq のように、uv が stdout に出力しないサイレントモードを有効にします。

--verbose, -v--verbose、-v

Use verbose output.詳細な出力を使用します。

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)RUST_LOG 環境変数を使用して、細かいログ記録を設定できます。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)