Download riddlg

Local-first RIDDL generation. Turn a RIDDL model into documentation and API specifications, or generate RIDDL from a brief — entirely on your own machine, no cloud backend.

Install with Homebrew (recommended)

brew install ossuminc/tap/riddlg

The easiest option on macOS (Apple Silicon) and Linux — Homebrew handles the install and keeps it current with brew upgrade.

Or download directly

Debian / Ubuntu (.deb)

sudo apt install ./riddlg_0.3.0_amd64.deb

Fedora / RHEL (.rpm)

sudo dnf install ./riddlg-0.3.0-1.x86_64.rpm

System Requirements

macOS 12+ on Apple Silicon (arm64)
Linux x86_64 (Ubuntu 20.04+, Fedora 36+, or equivalent)
A local GGUF model is required for AI RIDDL generation (bring your own; the default is qwen2.5-coder-32b)

What riddlg Does

Documentation (Free)

AsciiDoc and MkDocs sites with Mermaid diagrams, straight from your model.

API Specs (Free)

OpenAPI, gRPC, and Smithy specifications generated from your contexts.

AI RIDDL (Free)

Generate validated RIDDL from a natural-language brief using a local AI model.

Code Generation (Pro)

Runnable Quarkus source with AI-filled, compile-verified handler bodies. Requires Pro.

Learn How to Use riddlg

Full command reference, configuration, and examples in the documentation.

Read the riddlg Docs