Install RyuSim on your system.
The fastest way to install RyuSim:
curl -fsSL https://ryusim.seiraiyu.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:
sudo apt install clang 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 →Tarball naming convention:
ryusim-{VERSION}-linux-{ARCH}-glibc{X.Y}.tar.gz