RyeユーザーはuvへGO！Astral公式が推奨する次世代Pythonワークフロー移行術

Ryeが役目を終えた理由

Ryeは素晴らしいPythonプロジェクト管理ツールでした。 しかし、開発元のAstralは公式にuvへの移行を推奨しています。

なぜか？答えは明確です： uvがRyeの全機能を含み、さらに進化したから

RyeとuvのDNA

どちらもRust製で、同じAstralチームが開発しています。 実際、Ryeは初期からuvを内部で使用していました。

Ryeの功績

• Pythonバージョン管理の統合
• プロジェクトベースの仮想環境
• ワークスペース（monorepo）対応
• 依存関係の自動ロック

uvの進化

Ryeの全機能を継承しつつ：

• より高速な依存関係解決
• より広範なPython実装のサポート
• より活発な開発とコミュニティ
• より洗練されたCLI

移行の実際：プロジェクトごとの手順

単一プロジェクトの移行

現在のRyeプロジェクト構造：

my-project/
├── .python-version
├── pyproject.toml
├── requirements.lock
└── src/

移行手順：

# 1. uvのインストール
curl -LsSf https://astral.sh/uv/install.sh | sh

# 2. プロジェクトディレクトリへ移動
cd my-project

# 3. uvでの初期化（既存のpyproject.tomlを利用）
uv sync

# 4. Pythonバージョンの確認・インストール
uv python install $(cat .python-version)

# 5. スクリプトの実行（ryeと同じ）
uv run python main.py

これで完了です！

pyproject.tomlの互換性

Ryeで使っていたpyproject.tomlはほぼそのまま使えます。

[project]
name = "my-app"
version = "0.1.0"
requires-python = ">=3.11"
dependencies = [
    "fastapi>=0.104.0",
    "sqlalchemy>=2.0.0",
]

[tool.rye]  # ← これは無視される（問題なし）
managed = true

[tool.uv]  # ← uvの設定（オプション）
dev-dependencies = [
    "pytest>=7.4.0",
]

ワークスペース（monorepo）の移行

Ryeのワークスペースもuvがサポートしています。

# ルートのpyproject.toml
[tool.uv.workspace]
members = ["packages/*"]

# packages/api/pyproject.toml
[project]
name = "my-api"
dependencies = ["fastapi"]

# packages/cli/pyproject.toml
[project]
name = "my-cli"
dependencies = ["click", "my-api"]  # ワークスペース内の依存も可能

# ワークスペース全体の依存解決
uv sync

コマンド対応表

uvだけの新機能

1. Python実装の選択

# CPython以外も使える
uv python install pypy@3.10
uv python pin pypy@3.10

2. グローバルツールのインストール

# pipxの代わりにもなる
uv tool install ruff
uv tool install black

3. スクリプトの単体実行

# script.py
# /// script
# dependencies = [
#   "requests",
#   "rich",
# ]
# ///

import requests
from rich import print

response = requests.get("https://api.github.com")
print(response.json())

# 依存関係を自動インストールして実行
uv run script.py

CI/CDの更新

GitHub Actionsでの変更例：

# Before (Rye)
- name: Install Rye
  uses: eifinger/setup-rye@v1

- name: Sync dependencies
  run: rye sync

- name: Run tests
  run: rye run pytest

# After (uv)
- name: Install uv
  uses: astral-sh/setup-uv@v1

- name: Set up Python
  run: uv python install

- name: Install dependencies
  run: uv sync

- name: Run tests
  run: uv run pytest

移行のメリット

1. 将来性: Ryeは開発終了、uvは活発に進化中
2. パフォーマンス: さらに高速化された依存解決
3. 機能拡張: 新機能が続々追加
4. コミュニティ: より大きなユーザーベース

まとめ

RyeからuvへのGO推奨は、後継ツールへのスムーズな進化です。 同じチームが開発しているため、移行は驚くほど簡単です。

Ryeユーザーなら、uvの習得コストはほぼゼロ。 むしろ、より洗練されたワークフローが手に入ります。

「もうRyeで十分」と思っているかもしれませんが、uvを試せば考えが変わるはずです。