Fastest multi-tool setup

Use OSS CAD Suite when you want one download for a working stack.

The official Yosys docs recommend OSS CAD Suite as the easiest way to use Yosys. In practice it is also the fastest cross-platform path into a wider open-source RTL toolchain because it bundles several related tools.

Best for: quick stack setup Linux, macOS, Windows Last verified: April 4, 2026
What it solves

One environment for several tools

Use OSS CAD Suite when you want a packaged environment instead of installing each open-source EDA tool one by one.

  • Good for new learners who want fast progress
  • Good for workshop, CI, and agent setup
  • Good when you want Yosys and Verilator on the same machine quickly
Supported archives

The official docs list nightly builds for `linux-x64`, `linux-arm64`, `darwin-x64`, `darwin-arm64`, and `windows-x64`.

Linux

Download, extract, activate

export PATH="<extracted_location>/oss-cad-suite/bin:$PATH"
source <extracted_location>/oss-cad-suite/environment

For fish shell, the official docs also provide `environment.fish` and `fish_add_path` examples.

macOS

Remove quarantine, then activate

xattr -d com.apple.quarantine oss-cad-suite-darwin-arm64-yyymmdd.tgz
source <extracted_location>/oss-cad-suite/environment

The official docs say you can also run `./activate` once inside the extracted directory.

Windows

Use the environment scripts

<extracted_location>\oss-cad-suite\environment.bat
. <extracted_location>\oss-cad-suite\environment.ps1
<extracted_location>\oss-cad-suite\start.bat

The official docs recommend extracting to a path without spaces on Windows.

Verify
yosys -V verilator --version

Success looks like both tools answering from the same activated environment.

Good first move
gtkwave --version

If GTKWave is present in your suite build, this is a quick way to confirm your waveform viewer is also ready.

Why this is the recommended start

Instead of stitching together many package managers, you download one archive, activate one environment, and then begin with the lab or the Yosys and Verilator guides immediately.

Common pitfalls
  • On Windows, avoid extraction paths with spaces.
  • On macOS, remove quarantine or run the activation helper once.
  • If you only prepend `bin` to `PATH`, note the package has extra helpers for its bundled Python too.
Copyright and license

This guide points back to the official OSS CAD Suite project for the real archive downloads and activation scripts. It summarizes the setup and keeps the attribution with upstream.