Downloads

Install RyuSim on your system.

Quick Install

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.

Platform Support

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.

System Requirements

Install Dependencies

Install the required tools before running the RyuSim installer:

Ubuntu / Debian

sudo apt install clang cmake python3 python3-pip

Fedora

sudo dnf install clang cmake python3 python3-pip

Rocky Linux / RHEL 9

sudo dnf install epel-release && sudo /usr/bin/crb enable && sudo dnf install clang cmake python3 python3-pip

Rocky Linux / RHEL 10+

sudo dnf install clang cmake python3 python3-pip

Install cocotb (RyuSim fork)

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.

Manual Download

Browse all available release builds directly:

Browse Releases →

Tarball naming convention:

ryusim-{VERSION}-linux-{ARCH}-glibc{X.Y}.tar.gz