# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# pip でインストール
pip install uv

# pipx でインストール
pipx install uv

uv self update

# 新規作成（フォルダが作成される)
uv init <プロジェクト名>

# 今いるディレクトリをプロジェクト化する場合
uv init .

uv add <パッケージ名> ...

# 例 ）.venv(仮想環境) が自動で作られ、指定パッケージがインストールされます。
uv add requests

# 編集可能な依存関係を追加
uv add --editable ./path/to/my-package

# 開発用依存関係を追加
uv add --optional pandas pandas[excel]

# 依存関係を削除
uv remove <パッケージ名>

# macOS/Linux
source .venv/bin/activate

# Windows(PowerShell/CMD)
.\.venv\Scripts\activate

uv run <コマンド> [引数...]

# 仮想環境内で ruff check が実行されます。
uv run ruff check

uvx <ツールのコマンド> ...

# その場でダウンロード→実行、終わったら後片付け。
uvx pycowsay "Hello, uv!"

uv tool install <ツール名>

# インストール後は、普通に ruff --version などでコマンドを呼び出せます。
uv tool install ruff

uv python install <バージョン> ...

# 複数バージョンをまとめて一気にインストール
uv python install 3.10 3.11

uv venv [--python <バージョン>]

# 指定したバージョンで仮想環境 .venv を作成
uv venv --python 3.12.0

uv run --python <バージョン> -- python --version

# PyPyなども対応可
uv run --python pypy@3.8 -- python --version

uv python pin <バージョン>

# .python-version が作られ、同ディレクトリ以下で自動適用されます。
uv python pin 3.11

uv add --script <スクリプト.py> <パッケージ名> ...

# example.py の先頭付近に依存情報が記載され、実行時に自動でインストールされます。
uv add --script example.py requests

uv run <スクリプト.py>

# スクリプト単位で仮想環境が用意され、依存を入れてから実行します。
uv run example.py

uv pip compile <.inファイル> --universal --output-file <.txtファイル>

# マルチプラットフォームで再現性が高い (universal) 依存ファイルを出力
uv pip compile docs/requirements.in --universal --output-file docs/requirements.txt

uv pip sync <requirements.txt>

# lockされた依存をまとめてインストール
uv pip sync docs/requirements.txt

# .venv を作成
uv venv

# .venv を作成
uv venv

# 有効化(Linux/Mac)
source .venv/bin/activate

# 有効化(Windows)
.\.venv\Scripts\activate