rv, fast Ruby version and gem management

Today, rv can install Ruby versions in a second or two, removing the compile step and fixing OpenSSL errors forever.

Soon, you'll be able to manage your entire project and all of its gems, faster and more easily than ever before.

New in 0.4: Try rv clean-install to install your locked gems.

Install Ruby in under 2 seconds

For details, see INSTALL_BENCHMARK.md.

Testimonials

"what the heckie that just installed a ruby version for me in .22 seconds???" — c. ruiyi smallbird

"Holy wow that thing _flies_." — Andrea Fomera

Requirements

• Operating Systems: macOS 14+, Linux glibc 2.35+
• Architectures: x86, arm64
• Ruby Versions: Ruby 3.2, 3.3, 3.4, and 4.0.
• Shells: zsh, bash, fish, nushell. See SHELL INTEGRATION for more.

Install

# Homebrew or Linuxbrew
brew install rv

Or, visit releases for an installer shell script.

Quickstart

rv ruby install 4.0.0 # install Ruby version
rv ruby run 4.0.0 # run Ruby version

rv shell [zsh|bash|fish|nu] # set up automatic version switching
rv ruby pin 4.0.0 # set Ruby version
rv ruby pin # show Ruby version

rv clean-install # install Ruby and gems from Gemfile.lock

See SHELL INTEGRATION for more about .ruby-version and automatic version switching.

From Spinel Cooperative

Spinel.coop can bring your team an obsession with developer productivity and decades of experience from the core teams of Rails, Hotwire, Bundler, and rbenv. Book a free call with us to get started today.

Future Plans

All-in-one tooling for Ruby developers.

• Install & manage all Ruby versions.
• Manage gems, applications, CLI tools, and scripts, effortlessly.
• Handle everything Ruby provided by rvm, rbenv, chruby, asdf, mise, ruby-build, ruby-install, bundler, and rubygems, all at once.
• Install Ruby and all your gems in seconds, without having to compile anything ever again.
• Install ruby-head versions for easier development for Ruby core contributors.
• mise plugin, so you get fast no-fuss Ruby installs too.

Future features

• Run any gem command instantly, like rvx rails new.
• Run any script, installing all needed gems, like rv run script.rb.
• Install gem CLIs with any needed rubies with rv tool install.
• Install precompiled Ruby versions in seconds with rv ruby install.
• Manage project gems with rv install, rv add, and rv remove.
• Create gems with rv gem, and publish them with rv publish.

See PLANS.md for more on our future plans.

Contributing

Install dependencies on macOS or Ubuntu with bin/setup. Make changes, and then run the development binary with bin/rv, or install the development binary to your system with bin/install.

When you're done, make sure to run the tests with bin/test, and the linter with bin/lint. Then, send us a pull request! We love pull requests.

FAQ

Does rv have a website?

Yes! You're looking at it. You can reach this page with the URL rv.dev.

Why are you doing this?

@indirect, long-time project lead for Bundler and RubyGems, wrote a blog post about his motivation to create rv.

How do you pronounce rv?

"arr vee", the names of the two letters, spelled out.

Acknowledgements

rv is heavily inspired by uv, as you might guess from the name.

It also takes inspiration, features, and approaches from Bundler, Frum, Homebrew, npm, Cargo, and Orogene.

We'd also like to thank everyone who has ever worked on a package manager in the past for helping get all of us to where we are today.

Similar Projects

• Bundler manages project gems.
• Ruby Butler manages project tasks, Rubies, and gems.

License

rv is licensed under either Apache-2.0 or MIT, at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion by you, as defined in the Apache-2.0 license, shall be dually licensed as above, without any additional terms or conditions.