Download riddlc

The RIDDL compiler — parse, validate, and process your .riddl files from the command line. Open source and always free.

Install with Homebrew (recommended)

brew install ossuminc/tap/riddlc

macOS and Linux. Homebrew picks the right build for your machine and upgrades come through brew upgrade.

Or download directly

macOS

Apple Silicon · native · no JVM

Download .zip

Linux

x86_64 · native · no JVM

Download .zip

JVM (any OS)

Cross-platform · requires JDK 25

Download .zip

On Windows, an Intel Mac, or any other architecture? Use the JVM package — it runs anywhere with JDK 25 installed. Unzip and run bin/riddlc (bin\riddlc.bat on Windows).

System Requirements

Native builds: macOS 12+ on Apple Silicon (arm64), or Linux x86_64 — no JVM needed
JVM package: any OS with a JDK 25 (Temurin) on your PATH

Build from Source

Want the bleeding edge or to hack on the compiler? Build it yourself with sbt.

git clone https://github.com/ossuminc/riddl.git

cd riddl

sbt riddlc/stage

# binary at riddlc/target/universal/stage/bin/riddlc

Learn How to Use riddlc

Command reference, options, and examples in the documentation. Run riddlc help anytime for the full option list.

Read the riddlc Docs All Releases