Skip to content

Rye: An Experimental Package Management Solution for Python

Rye is Armin's personal one-stop-shop for all his Python needs. It installs and manages Python installations, helps working with pyproject.toml files, installs and uninstalls dependencies, creates and updates virtualenvs behind the scenes. It supports monorepos and global tool installations.

Rye is an experimental endeavour to build a new type of packaging experience to Python inspired by rustup and cargo from Rust. It's not yet production ready but feedback and suggestions are greatly appreciated.

Star Discuss Sponsor

Installation Instructions

To install run you can curl a command which will install the right binary for your operating system and CPU architecture and install it:

curl -sSf https://rye-up.com/get | bash

Alternatively if you don't trust this approach, you can download the latest release binary. On first run it will install itself.

gunzip rye-x86_64-linux.gz
chmod +x ./rye-x86_64-linux
./rye-x86_64-linux

To install run you can curl a command which will install the right binary for your operating system and CPU architecture and install it:

curl -sSf https://rye-up.com/get | bash

Alternatively if you don't trust this approach, you can download the latest release binary. On first run it will install itself.

gunzip rye-aarch64-macos.gz
chmod +x ./rye-aarch64-macos
./rye-aarch64-macos

To install Rye on windows download the latest release and run the binary. Upon first run it will install itself. Please note that it's strongly recommended to have "Developer Mode" activated when using Rye and before starting the installation. Learn more.

Note

Rye does not yet use signed binaries which means that you will need to allow the execution of the downloaded executable. If there is no obvious way to do so, click on "More info" on the error message that shows up and then on "Run anyway".

You need to have Rust and Cargo installed. If you don't have, you can use rustup to get them onto your machine.

Afterwards you can install Rye via cargo:

cargo install --git https://github.com/mitsuhiko/rye rye

For the next steps or ways to customize the installation, head over to the detailed installation guide.