Install RyuSim on your system.
The fastest way to install RyuSim:
curl -fsSL https://ryusim.com/install.sh | bash
The installer auto-detects your architecture and glibc version, then downloads the most compatible build.
RyuSim is built and tested on the following Linux distributions:
| Distribution | Version | glibc |
|---|---|---|
| Ubuntu | 24.04 LTS | 2.39 |
| Ubuntu | 22.04 LTS | 2.35 |
| Debian | 13 (Trixie) | 2.40 |
| Debian | 12 (Bookworm) | 2.36 |
| Fedora | 42 | 2.41 |
| Fedora | 40 | 2.39 |
| Rocky Linux | 10 | 2.39 |
| Rocky Linux | 9 | 2.34 |
Other Linux distributions with glibc 2.34+ should also work. The installer auto-detects compatibility.
Windows users: RyuSim runs under WSL2 (Windows Subsystem for Linux). Install Ubuntu 24.04 in WSL2, then use the installer above.
Install the required tools before running the RyuSim installer:
The distro clang package is older than the required Clang 18, so install it from apt.llvm.org:
wget -qO- https://apt.llvm.org/llvm.sh | sudo bash -s -- 18 && sudo apt install cmake python3 python3-pip
sudo dnf install clang cmake python3 python3-pip
sudo dnf install epel-release && sudo /usr/bin/crb enable && sudo dnf install clang cmake python3 python3-pip
sudo dnf install clang cmake python3 python3-pip
RyuSim uses cocotb for Python-based testbenches. Until RyuSim support is merged upstream, install cocotb from the Seiraiyu fork:
pip install git+https://github.com/Seiraiyu/cocotb.git@feat/ryusim-simulator-support
This fork adds the RyuSim simulator runner and Makefile.ryusim to cocotb's
build infrastructure. Once upstream cocotb includes RyuSim support, you can switch to the
official release with pip install cocotb.
Browse all available release builds directly:
Browse Releases →v2 is the current release line. 1.x is no longer
developed — v1.7.66 is its most recent release.
1.x downloads stay available indefinitely — no removal date. Every 1.x artifact remains hosted and pinnable:
curl -fsSL https://ryusim.com/install.sh | bash -s -- --version 1.7.66
v2 keeps v1's interfaces — the same CLI, the same VPI/cocotb flow — so most projects upgrade by installing it. What deliberately changed is listed in Migrating to v2.
Tarball naming convention:
ryusim-{VERSION}-linux-{ARCH}-glibc{X.Y}.tar.gz