rv - GitLite

KO | EN

gitlite — search

#react #llm #golang #machine-learning #rust #linux #nodejs #windows #awesome #vue #awesome-list #pytorch #mcp #open-source

rv

(★ 1,786)

💎💨 Extremely fast Ruby version and gem manager

File Explorer

Download Latest Version (.zip)

- insta.yaml
- nextest.toml
- - release.yml
  - test.yml
  - zizmor.yml
- dependabot.yaml
- FUNDING.yml
- zizmor.yml
- - diaspora
  - discourse
  - fastlane
  - gitlab
  - homebrew
  - huginn
  - llhttp-ffi
  - lobsters
  - local-gemspec
  - mastodon
  - shared.sh
- build
- install
- lint
- rv
- rvd
- rvx
- setup
- smoke-test
- test
- test-cov
- test-integration
- - Cargo.toml
- - Cargo.toml
  - README.md
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
  - README.md
- - Cargo.toml
  - README.md
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - Cargo.toml
- - rv-ruby-install.svg
- GITHUB_TOKEN_AUTH.md
- INSTALL_BENCHMARK.md
- PLANS.md
- SETTINGS.md
- SHELL_INTEGRATION.md
- uv-notes.md
- - parse_gem_spec_yaml.rs
- .gitignore
- Cargo.toml
- api.json
- build.ps1
- install.ps1
- lint.ps1
- rv.ps1
- setup.ps1
- test-integration.ps1
- test.ps1
.gitattributes
.gitignore
AI_POLICY.md
bacon.toml
Cargo.lock
Cargo.toml
CHANGELOG.md
CODE_OF_CONDUCT.md
deny.toml
dist-workspace.toml
LICENSE-APACHE
LICENSE-MIT
README.md
rust-toolchain.toml
SECURITY.md

# Installation Guide

1. Get the code

git clone https://github.com/spinel-coop/rv

Downloads the entire project code from GitHub to your computer.

cd rv

Moves into the project folder you just downloaded.

2. Official Install Script

Easy Recommended

Prerequisites

Homebrew A package manager for macOS/Linux.

brew install rv

Installs the pre-built package via Homebrew — no source build required.

curl -LsSf https://rv.dev/install | sh

Downloads and runs the official install script in one line — this handles the full setup automatically.

✅ After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.

Pulled directly from this repo's README.

3. Rust

Medium

Prerequisites

Git Needed to download the project code from GitHub.
Rust (rustup) Installing via rustup also installs cargo.

cargo build --release

Compiles the Rust project.

cargo run

Builds and then immediately runs the program.

✅ If cargo build finishes without errors, it worked. The executable is created under target/.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# `rv`, a very fast Ruby gem and project manager

Auto-installed and managed Ruby versions and gems.

- Run any command or script that needs ruby with `rv run NAME`.
- Run any gem command immediately, like `rvx rails new myapp`.
- Install project gems with `rv clean-install`.
- Install gem CLIs in isolated environments with `rv tool install NAME`.

## Install

On macOS or Linux, install `rv` with Homebrew:

```bash
brew install rv
```

Alternatively, use the standalone installer script:

```bash
curl -LsSf https://rv.dev/install | sh
```

On Windows, open PowerShell as Administrator and run:

```powershell
powershell -ExecutionPolicy Bypass -c "irm https://rv.dev/install.ps1 | iex"
```

**Note: On Windows PowerShell, use `rvw` instead of `rv` because `rv` is an alias for the built-in `Remove-Variable`.**

For other installation options or to download specific versions manually, visit the [releases page](https://github.com/spinel-coop/rv/releases).

## Usage

```bash
rv run [ruby|irb|myscript.rb] # run any command or script with Ruby available
rvx rails new . # run any gem CLI directly
rv tool install rerun # install CLI tools into dedicated environments
rv clean-install # install project Ruby and gems from Gemfile.lock
rv ruby pin 4.0.0 # set a project Ruby version
rv shell [zsh|bash|fish|nu|powershell] # set up automatic version switching
```

On Windows PowerShell, use `rvw` instead of `rv`:

```powershell
rvw run ruby             # run any command or script with Ruby available
rvw clean-install        # install project Ruby and gems from Gemfile.lock
rvw shell powershell     # set up automatic version switching
```

See [SHELL INTEGRATION](docs/SHELL_INTEGRATION.md) for more about `.ruby-version` and automatic version switching.

## Install Ruby in under 2 seconds

![rv installs ruby 3.4.7 in 1.8 seconds](https://raw.githubusercontent.com/spinel-coop/rv/main/docs/img/rv-ruby-install.svg)

For details, see [INSTALL_BENCHMARK.md](docs/INSTALL_BENCHMARK.md).

## Configuration

`rv` supports configuration via a `rv.kdl` file at the project or user level, and via environment variables prefixed with `RV_`.

See [SETTINGS.md](docs/SETTINGS.md) for all settings, allowed values, and configuration precedence.

## Testimonials

"what the heckie that just installed a ruby version for me in .22 seconds???"
 &mdash; [c. ruiyi smallbird](https://bsky.app/profile/veryroundbird.house/post/3lxdwtsbwp22o)

"Holy wow that thing \_flies\_."
 &mdash; [Andrea Fomera](https://bsky.app/profile/afomera.dev/post/3m4wjfvqrhk2h)

## Requirements

- **Operating Systems**: macOS 14+, Linux glibc 2.35+, Windows 10+
- **Architectures**: x86, arm64
- **Ruby Versions**: Ruby 3.2, 3.3, 3.4, and 4.0.
- **Shells**: zsh, bash, fish, nushell, PowerShell. See [SHELL INTEGRATION](docs/SHELL_INTEGRATION.md) for more.

## From Spinel Cooperative

[Spinel.coop](https://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](https://savvycal.com/spinel/client) to get started today.

## Community

Join us in the `rv` category on the [Ruby Users Forum](https://www.rubyforum.org/tag/rv/71), the `#rv` channel in the the [Bundler Slack](https://join.slack.com/t/bundler/shared_invite/zt-3kza12u0j-Fw3rwvPi6zqe6EC3RCDGMA), and the [Spinel Discord](https://discord.gg/u34TcumAk8).

Subscribe to [the Spinel Cooperative newsletter](https://buttondown.com/spinel) or [the Spinel blog](https://spinel.coop/blog) RSS feed to get updates about `rv` version releases.

## Plans

All-in-one tooling for Ruby developers.

- Install & manage all Ruby versions.
- Manage gems, applications, CLI tools, and scripts, effortlessly.
- Handle everything Ruby, as 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-dev` versions to ease working with Ruby development builds.

### Future features

- Run any script, installing all needed gems, like `rv run script.rb`.
- Manage project gems with `rv sync`, `rv add`, and `rv remove`.
- Create gems with `rv gem new`, and publish them with `rv gem publish`.

See [PLANS.md](docs/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`.

On Windows, equivalent PowerShell scripts are available in `bin\powershell\`.

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](https://rv.dev).

**Why are you doing this?**

[@indirect](https://github.com/indirect), long-time project lead for [Bundler](https://bundler.io) and [RubyGems](https://rubygems.org), wrote [a blog post about his motivation to create `rv`](https://andre.arko.net/2025/08/25/rv-a-new-kind-of-ruby-management-tool/).

**How do you pronounce rv?**

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

## Acknowledgements

`rv` is heavily inspired by [`uv`](https://github.com/astral-sh/uv), as you might guess from the name.

It also takes inspiration, features, and approaches from [Bundler](https://bundler.io), [Frum](https://github.com/TaKO8Ki/frum), [Homebrew](https://brew.sh), [npm](https://npmjs.com), [Cargo](https://github.com/rust-lang/cargo), and [Orogene](https://github.com/orogene/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

- [Ruby Butler](https://github.com/RubyElders/ruby-butler) manages project tasks, Rubies, and gems.

## License

`rv` is licensed under either [Apache-2.0](/LICENSE-APACHE) or [MIT](/LICENSE-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.