Ryeとは？開発終了後も使えるか2026年10月に検証、Windowsでの導入・削除とuv移行の注意点

Rye（ライ）は、Pythonのインストールから仮想環境、依存関係の管理までを1つのコマンドで扱うツールです。英単語のryeは「ライ麦」を指しますが、この記事で扱うのはPythonのツールのほうです。Ryeは2025年2月26日の0.44.0を最後に更新が止まり、2025年8月には公式READMEに開発終了の告知が入りました。後継は同じ開発陣のuvです。

では、2026年のいまRyeは動くのか。2026年10月28日にmacOS（x86_64）へRye 0.44.0を導入し、プロジェクトの作成からuvへの移行、アンインストールまでを試しました。その結果と公式ドキュメントをもとに、Windowsでの導入手順、uvへ移すときに詰まる箇所、消し方を順に説明します。

まとめ

Ryeは今も導入でき、rye sync・rye lint・rye testも動きます。ただし中身は2025年2月で固まっています。自動で取得されるPythonは3.13.2が上限で、3.14は「unknown version」で取得できません。内部で使うuvも0.6.3のままです（uv本体は2026年10月27日に0.13.6が出ています）。公式は「セキュリティ更新も含めて今後の更新予定はない」としており、新しく採用する理由はありません。

既存のRyeプロジェクトをuvへ移す際は、次の3箇所を確認してください。該当する設定や依存関係がある場合に、解決失敗や機能の取りこぼしが起こります。

• rye initが書くrequires-python = ">= 3.8"のままだと、uv syncが依存解決に失敗することがある
• [tool.rye]のdev-dependenciesは、uvが警告を出さずに無視する（pytestなどが入らない）
• [tool.rye.scripts]のタスクはuv runで呼べない（uvにタスクランナーはまだ無い）

Windowsではrye-x86_64-windows.exeを実行し、%USERPROFILE%\.rye\shimsをPathの先頭に置けば使えます。削除はrye self uninstall --yesの後に、残った.ryeフォルダとPathの行を手で消します。

Ryeの現状：開発終了と2026年10月の動作確認

開発終了の告知と最終版0.44.0

RyeのGitHubリポジトリはアーカイブ（読み取り専用）され、最終リリースは0.44.0（2025年2月26日）です。READMEの冒頭には「Ryeは今後も入手可能なままだが、セキュリティ更新を含め、これ以上の更新は予定していない（no further updates are planned, including security updates）」とあります。この告知は2025年8月18日のコミット「Retire Rye and add a uv migration guide」で追加されたもので、同時にuvへの移行ガイドも公開されました。

Ryeは、Flaskの作者Armin Ronacher氏が2023年に公開したツールで、のちにAstralへ移管されました。AstralはRust製のパッケージインストーラ・リゾルバとしてuvを公開し、Ryeを引き継ぎながらuvを後継のプロジェクト管理ツールへ拡張しました。Ryeも後期には依存解決にuvを使っていました。インストールガイドは「2025年2月の時点でRyeは開発されていない。新しく使う人はuvを入れてほしい」と案内しています。なおAstralは2026年3月にOpenAIによる買収を発表しています。uvやRuffの開発がその後どうなったかはOpenAIのAstral買収とは？uv・Ruff・tyはどうなったか【2026年10月時点】で確認しています。

2026年10月に導入して確かめた動作

macOS（x86_64）で、GitHubリリースのrye-x86_64-macos.gzをsha256で照合してから、RYE_HOMEを作業用フォルダに向けて導入しました。結果は次のとおりです。

動作だけを見れば、Ryeは今も使えます。配布元のrye.astral.sh/getもGitHubのリリースも、2026年10月28日時点で取得できました。依存ライブラリは、Pythonの対応範囲や依存指定を満たす版が解決されます。既存のロックがある場合は、更新を指定しない限り必要な変更だけが行われ、常に最新版になるわけではありません。

Rye 0.44.0によるCPython自動取得の上限

問題はPython本体です。Ryeは取得できるPythonの一覧（python_downloads.inc）をビルド時にバイナリへ埋め込んでいます。0.44.0の一覧はCPython 3.13.2までで、3.13系はその後も修正版が出ていますが、Ryeでは選べません。3.14はそもそも一覧にないため、rye fetch 3.14は次のように止まります。

$ rye fetch 3.14
error: error while fetching Python installation

Caused by:
    unknown version 3.14

python.orgの配布ページでは、2026年10月25日に3.15.2・3.14.10・3.13.18が公開されています。Rye 0.44.0の自動取得機能だけでは、3.13の新しい修正版や3.14以降へ更新できません。手元のPythonをrye toolchain registerで登録すれば使えなくはありませんが、その時点で「Pythonの取得まで任せられる」というRyeの利点は無くなります。Pythonの版を切り替える仕組み自体を比べたいなら、pyenvでPythonのバージョンを切り替える手順｜shimの仕組みとビルド失敗の対処も参考になります。

WindowsにRyeをインストールする手順

exeの選び方とSmartScreenの警告

WindowsではcurlのワンライナーではなくGitHubリリースのexeを実行します。64ビットならrye-x86_64-windows.exe、32ビットならrye-x86-windows.exeです。起動するとRyeは%USERPROFILE%\.ryeへ自分を導入し、Pythonの版やPathへの登録を対話形式で尋ねます。

次の例はコマンドプロンプト（cmd.exe）で実行します。

:: ダウンロードしたフォルダで実行
rye-x86_64-windows.exe
:: 新しいターミナルを開いて確認
rye --version

Ryeのexeには署名がありません。SmartScreenで「WindowsによってPCが保護されました」と出たら、公式の案内どおり「詳細情報」から「実行」を選びます。ウイルス対策ソフトが「Bearfoos」というトロイの木馬として検出する例もあり、公式は誤検知と説明しています（GitHub issue #468）。社内PCで検出が出た場合は、情報システム部門に確認し、移行先のuvを含めて社内で利用を認められた導入方法を選んでください。

ARM版Windows（Snapdragon搭載のCopilot+ PCなど）には注意が要ります。0.44.0のリリースにARM64用のexeは無く、Ryeが取得するWindows向けPythonもx86とx86_64だけです。エミュレーションで動かすことになり、ARM64ネイティブのwheelは使えません。uvはaarch64-pc-windows-msvc向けのビルドを配布しているので、ARM版Windowsで新しく環境を作るならuvを選んでください。

shimsフォルダのPath登録と優先順位

インストーラは通常Pathを自動登録しますが、ryeが「見つかりません」となる場合は手動で追加します。登録するのは%USERPROFILE%\.rye\shimsで、Ryeの本体と、Ryeが管理するPythonへのshim（python・python3）が入っています。

1. Windowsキー＋Rでsysdm.cplを実行する
2. 「詳細設定」タブの「環境変数」を開く
3. ユーザー環境変数のPathを開き、「新規」で%USERPROFILE%\.rye\shimsを追加する
4. 「上へ」で一覧の先頭へ移動し、「OK」で閉じる
5. 新しいターミナルを開き直す（必要ならサインインし直す）

先頭へ動かすのは、Windowsにはpythonと打つとMicrosoft Storeを開くアプリ実行エイリアスがあり、既存のPythonもPathに並んでいるからです。shimsが後ろにあると別のPythonが先に拾われます。ただし、ユーザーPathの先頭に置いても、システムPathに登録されたPythonよりは後に検索されます。新しいコマンドプロンプトでwhere pythonを実行して優先順位を確認してください。shimsが先に見つかる環境では、既存のPythonを前提にしたソフトの挙動が変わる場合があります。

Windowsの開発者モード有効化と内部Pythonの指定

Rye公式は、インストール前に開発者モードを有効にするよう強く勧めています。Windows 11 24H2までは「設定」→「システム」→「開発者向け」、25H2以降は「システム」→「詳細設定」の「開発者向け」にあり（Microsoftの開発者モードの説明）、見つからなければ設定の検索で「開発者モード」と入力します。一般ユーザーでもシンボリックリンクを作れるようになり、Ryeの動作が安定するためです。手元のPythonをRye自身の実行用に使わせたいときは、cmd.exeから環境変数RYE_TOOLCHAINを設定してインストーラを起動します。

set RYE_TOOLCHAIN=%USERPROFILE%\AppData\Local\Programs\Python\Python312\python.exe
rye-x86_64-windows.exe

Windowsのツールを増やさずにLinuxと同じ手順で済ませたいなら、WSLのUbuntuでcurl -sSf https://rye.astral.sh/get | bashを使う方法もあります。WSL側の準備はWSLで開発環境を構築する手順｜.wslconfig調整とDocker連携・肥大化の対処にまとめています。

既存のRyeプロジェクトを保守する最小コマンド

引き継いだRyeプロジェクトを動かすだけなら、覚えるコマンドは多くありません。Ryeはpyproject.tomlベースのプロジェクトが前提で、setup.pyだけのプロジェクトには対応していません。

rye sync              # .venv と requirements*.lock を作る・更新する
rye add "requests>=2.32"
rye add --dev pytest  # [tool.rye] の dev-dependencies に入る
rye run hello         # [tool.rye.scripts] のタスクを実行
rye lint              # Ruff で検査（rye check も同じ）
rye fmt               # Ruff で整形
rye test              # pytest
rye build             # dist/ に sdist と wheel を作る

rye syncが作る仮想環境.venvにはpipが入っていません（実測でも.venv/binにpipはありませんでした）。依存は必ずrye addから足します。ロックファイルはrequirements.lockとrequirements-dev.lockの2本で、pipでそのまま読める書式です。先頭のコメントにuniversal: falseとあるとおり、既定では手元のPythonと環境に合わせた解決結果だけを記録しています。この点が、次のuv移行で効いてきます。

Ryeからuvへ移行する手順

uvの基本操作はuvとは？Pythonの環境構築・パッケージ管理・バージョン管理の使い方を徹底解説で扱っているので、ここではRyeから移すときの差分に絞ります。rye initで作ったプロジェクトにrye add requestsとrye add --dev pytestを行い、.venvを消してuv 0.11.31でuv syncを実行して確かめました。

requires-pythonと依存パッケージの対応範囲の不一致

最初のuv syncは失敗しました。rye initはpyproject.tomlにrequires-python = ">= 3.8"と書き、rye add requestsはその時点の最新版を下限にしたrequests>=2.34.2を書き込みます。uvは宣言された範囲のすべてのPythonで成り立つように解決するため、Python 3.10以上を要求するrequests 2.34.2を「3.8と3.9では入らない」と判断します。

× No solution found when resolving dependencies for split (markers:
│ python_full_version >= '3.8' and python_full_version < '3.10'):
╰─▶ Because the requested Python version (>=3.8) does not satisfy
    Python>=3.10 and requests==2.34.2 depends on Python>=3.10, ...

Ryeで問題が出なかったのは、手元の3.13.2だけを対象に解決していたからです。運用しているPythonの版に合わせてrequires-python = ">= 3.10"のように上げると、uv syncは通りました。移行前に、pyproject.tomlのrequires-pythonと依存パッケージの対応範囲を確認してください。古いPythonへの対応を維持する必要がある場合は、下限を上げるのではなく、依存パッケージの版指定を見直します。

Ryeの開発依存設定からdependency-groupsへの移行

requires-pythonを直した後のuv syncは成功しましたが、pytestが入っていませんでした。[tool.rye]のdev-dependenciesはuvにとって知らない名前空間なので、警告も出さずに読み飛ばされます。成功表示だけを見て移行完了とすると、CIで初めてModuleNotFoundError: No module named 'pytest'に気づくことになります。標準の[dependency-groups]へ移すと入りました。

# 移行前（Rye）
[tool.rye]
managed = true
dev-dependencies = ["pytest>=9.2.0"]

# 移行後（uv）
[dependency-groups]
dev = ["pytest>=9.2.0"]

そのほかの設定も、多くは[tool.rye]を[tool.uv]へ書き換えるだけですが、公式の移行ガイドが挙げる次の項目は名前か意味が変わります。

tool.uv.pip配下の設定は、uv pip専用です。表のuniversalとgenerate-hashesを書き換えても、uv syncやuv lockの動作は変わりません。

最後の行は移行ガイドの記述そのままでは動きません。ガイドは対応先を[[tool.uv.indexes]]と書いていますが、uvの設定名は単数形の[[tool.uv.index]]です。複数形で書くとuvは「Failed to parse pyproject.toml during settings discovery」とunknown field indexesの警告を出しますが、処理は止めずにuv syncまで成功させます。書いたインデックスは使われないので、成功表示だけで判断せず警告を確認してください。既定のインデックスはname = "default"の代わりにdefault = true、find-linksはformat = "flat"で指定します。Ryeでできたインデックスurl内の環境変数の展開はuvに無いため（uv#5734）、認証情報は環境変数やkeyring、URLごと差し替えるならUV_INDEXを使います。

[tool.rye.scripts]の非互換とタスクの移行先

rye run helloで動いていたタスクは、uv run helloでは実行ファイルが見つからずに失敗します。uvにはタスクランナーが無く、機能要望のuv#5903は2026年10月28日時点でもオープンのままです。[project.scripts]に書くエントリポイントは標準仕様なのでuvでも動きますが、こちらは別物です。

移す先は、タスクが数本ならREADMEにuv run pytestなどのコマンドを書き出す、定型の手順が多いならMakefileやシェルスクリプト、CIで回すものはワークフロー定義、と分けるのが現実的です。移行の手間を見積もる際は、タスク数に加え、連鎖実行、環境変数、OS依存のコマンド、CIからの呼び出しを確認してください。

Ryeとuvのコマンド・ロックファイル対応

以下の対応表でRuffを実行するには、先にuv add --dev ruffで開発依存へ追加してください。Ryeが内部で使うRuffは、uvへの移行だけではプロジェクトへ導入されません。

Poetryやpipenvからの移行に使われるmigrate-to-uv（0.12.0）は、Ryeに対応していません。Ryeのプロジェクトで実行するとCould not determine which package manager is used from the ones that are supported.と出て止まり、対応先として表示されるのはpip・pip-tools・pipenv・poetryの4つです。移行は上の書き換えを手で行います。

uv init --scriptはrye init --scriptとは別の機能で、依存を先頭のコメントに書く単一ファイルのスクリプトを作ります。ロックファイルはuv独自のuv.lockに変わるので、移行後にuv export --no-hashes --no-dev --no-emit-projectで書き出し、元のrequirements.lockと版を突き合わせておくと安心です。今回の検証ではパッケージ5つの版がすべて一致しました。Dockerイメージでrequirements.lockをpipに読ませていた場合も、公式ガイドはその形を残さず、ビルドでuv sync、実行でuv runを使うよう勧めています。

Ryeをアンインストールする手順と残るファイル

Rye本体は専用のサブコマンドで消します。rye removeは依存パッケージを外すコマンドなので、取り違えないでください。

rye self uninstall --yes

実行すると「Don’t forget to remove the sourcing of …/env from your shell config.」と表示されて終わります。検証では、.ryeフォルダに空のenvと、設定が保存されたconfig.tomlの2ファイルが残りました。公式ドキュメントは空のenvが残るとだけ書いていますが、設定ファイルも残ります。完全に消すには次の後片付けをします。

• Windows：%USERPROFILE%\.ryeを削除し、ユーザー環境変数Pathから%USERPROFILE%\.rye\shimsの行を消す
• macOS・Linux：~/.ryeを削除し、.profileや.zprofileなどにあるsource "$HOME/.rye/env"の行を消す
• fish・nushell：fish_user_pathsやenv.nuに足した~/.rye/shimsを外す

Pathの行を残すと、存在しないフォルダが検索対象に残り、pythonの解決先がわかりにくくなります。

削除の順番にも注意が要ります。Ryeが作った.venvのpythonは、.rye/py/[email protected]のようなRye管理下のPythonを指しています。検証でも、rye self uninstallの後に.venv/bin/pythonを実行すると「no such file or directory」になりました。公式のインストールガイドも、アンインストール後はRyeで作った仮想環境が機能しなくなると書いています。同じ端末のRyeプロジェクトをすべてuvへ移し、既存の.venvを削除してからuv sync --managed-pythonでuv管理のPythonを使って作り直し、テストが通ることを確かめてから、最後にRye本体を消してください。検証でも、Ryeの.venvを残したままuv syncすると、.venv/bin/pythonはRye管理下のPythonを指したままでした。

新規に採用しない理由と、既存プロジェクトの移行の優先度

2026年に新しいプロジェクトへRyeを入れる理由はありません。「枯れたツールだから安定している」という考え方は、セキュリティ更新もしないと宣言されたツールには当てはまりません。前の章で見たとおり、Python 3.14以降を自動取得できない、内部のuvが0.6.3のまま、という形で古さはすでに表に出ています。新しく選ぶならuvが第一候補で、condaのパッケージも扱いたい場合はPixiとは？Python・conda対応のパッケージ管理ツールの使い方とuv・condaとの違い、Poetryと比べたい場合はPoetryとは？Python依存管理の仕組みと2.5系の使い方・uvとの選び方が判断材料になります。

既存のプロジェクトは、次のどれかに当たるなら移行を前倒しします。

• Python 3.14以降、または3.13の新しい修正版へ上げる予定がある
• CIやDockerのビルドで、毎回Ryeのインストーラをネットワークから取得している
• ARM版Windowsの開発者がいる、または新しいメンバーが継続的に加わる

逆に、機能追加が止まっているプロジェクトでも、Pythonと依存関係の脆弱性対応、配布物の再取得可否、稼働期限を確認して移行時期を決めます。版を固定していることだけでは、移行を先送りする根拠になりません。避けたいのは、全プロジェクトを一度に移して、dev-dependenciesの消失や[tool.rye.scripts]の取りこぼしにまとめて気づく形です。[tool.rye.scripts]を多く使っているものから1本ずつ移し、CIが通るのを確かめてから次へ進めてください。社内の業務システムでPython環境の刷新から任せたい場合は、フルスクラッチのシステム開発として相談も受けています。エディタ側でuvを使う設定はPyCharmの最新バージョンは2026.2｜2025.3〜2026.2の新機能・uv設定・無料版の範囲で確認できます。

よくある質問

Ryeの読み方と意味は？

「ライ」と読みます。英語ではライ麦のことで、公式ロゴにも麦の穂が描かれています。作者のArmin Ronacher氏は、Ryeの役割をuvへ引き継ぐ方針を2024年8月のブログ記事「Harvest Season」（収穫期）で説明しており、名前と掛けたタイトルになっています。

Ryeは2026年でもまだ使えますか？

使えます。2026年10月28日の検証でも、導入からrye sync・rye lint・rye testまで動きました。ただし取得できるPythonは3.13.2まで、内部のuvは0.6.3のままで、セキュリティ修正も出ません。動くことと使い続けてよいことは分けて考えてください。

RyeでPython 3.14は使えますか？

自動取得はできません。rye fetch 3.14は「unknown version 3.14」で失敗します。別途入れたPythonをrye toolchain registerで登録する方法はありますが、Pythonの管理まで含めて新しい版を使うならuvへ移る方が手間がかかりません。

Windowsでryeコマンドが「見つかりません」と出るのはなぜ？

まずPathの登録と、インストールが完了しているかを確認してください。%USERPROFILE%\.rye\shimsがユーザー環境変数Pathにあるかを確認し、無ければ追加して先頭へ移動してください。追加前に開いていたターミナルには反映されないため、開き直す必要があります。

RyeとuvはどちらもAstral製ですが、併用できますか？

同じプロジェクトを両方で操作するのは避けてください。Ryeはrequirements.lock、uvはuv.lockを正として別々に解決するため、2つのロックファイルの版がずれていきます。[tool.rye]の設定もuvは読みません。移行したプロジェクトのロックファイルと設定はuvの形にそろえてください。Rye本体の削除は、同じ端末でRyeを使うほかのプロジェクトも移行してから行います。

関連記事

• uvとは？Pythonの環境構築・パッケージ管理・バージョン管理の使い方を徹底解説
• OpenAIのAstral買収とは？uv・Ruff・tyはどうなったか【2026年10月時点】
• Poetryとは？Python依存管理の仕組みと2.5系の使い方・uvとの選び方
• pyenvでPythonのバージョンを切り替える手順｜shimの仕組みとビルド失敗の対処
• Pixiとは？Python・conda対応のパッケージ管理ツールの使い方とuv・condaとの違い