YosysHQ /yosys

Yosys Open SYnthesis Suite

★ 4,892⑂ 1,206👁 124⑃ 3,938● 2,254▤ 72
C++ISCCreated 2013-01-05yosyshq.net/yosys/
Download: Yosys 0.71Yosys-0.71 ↓0.712026-11-12
+3
Daily
4,892
stars
1,206
forks
124
watchers
3,938
prs
2,254
issues
72
releases

README

yosys – Yosys Open SYnthesis Suite
===================================

This is a framework for RTL synthesis tools. It currently has
extensive Verilog-2005 support and provides a basic set of
synthesis algorithms for various application domains.

Yosys is using sv-elab and slang libraries to provide comprehensive SystemVerilog support.
It supports an (informally defined) synthesizable subset of SystemVerilog in version IEEE 1800-2017 or IEEE 1800-2023.

Yosys can be adapted to perform any synthesis job by combining
the existing passes (algorithms) using synthesis scripts and
adding additional passes as needed by extending the yosys C++
code base.

Yosys is free software licensed under the ISC license (a GPL
compatible license that is similar in terms to the MIT license
or the 2-clause BSD license).

Third-party software distributed alongside this software
is licensed under compatible licenses.
Please refer to abc and libs subdirectories for their license terms.


Web Site and Other Resources
============================

More information and documentation can be found on the Yosys web site:
- https://yosyshq.net/yosys/

If you have any Yosys-related questions, please post them on the Discourse group:
- https://yosyshq.discourse.group

Documentation from this repository is automatically built and available on Read
the Docs:
- https://yosyshq.readthedocs.io/projects/yosys

Users interested in formal verification might want to use the formal
verification front-end for Yosys, SBY:
- https://yosyshq.readthedocs.io/projects/sby/
- https://github.com/YosysHQ/sby

The Yosys blog has news and articles from users:
- https://blog.yosyshq.com


Installation
============

Yosys is part of the Tabby CAD Suite and the OSS CAD Suite! The easiest way to use yosys is to install the binary software suite, which contains all required dependencies and related tools.

 Contact YosysHQ for a Tabby CAD Suite Evaluation License and download link
 OR go to https://github.com/YosysHQ/oss-cad-suite-build/releases to download the free OSS CAD Suite
 Follow the Install Instructions on GitHub

Make sure to get a Tabby CAD Suite Evaluation License if you need features such as industry-grade SystemVerilog and VHDL parsers!

For more information about the difference between Tabby CAD Suite and the OSS CAD Suite, please visit https://www.yosyshq.com/tabby-cad-datasheet

Many Linux distributions also provide Yosys binaries, some more up to date than others. Check with your package manager!


Building from Source
====================

 TL;DR

The following libraries are required, this command will install them on Ubuntu Linux 22.04 LTS based systems:

  $ sudo apt-get install gawk git make python3 lld bison clang flex \
		libffi-dev libfl-dev libreadline-dev pkg-config tcl-dev zlib1g-dev \
		graphviz xdot

This sequence of commands will build Yosys from source using the default preset:

	$ git clone --recurse-submodules https://github.com/YosysHQ/yosys.git
	$ cd yosys
	$ cmake --pr

Top issues

Discussions

Latest release

Yosys 0.71 v0.71 2026-11-12
Yosys 0.70 .. Yosys 0.71
--------------------------
  Commands and options
    - Added "-readable" and "-small" to "dump" and "write_rtlil" passes
      for convenience with the new string implementation.
    - Added "shuffle" pass to deterministically reorder design objects.
    - Added "-target" and "-family" to "verific" and "read_slang" passes
      as experimental feature to specify FPGA synthesis target.
    - Added "-nodec_attr" and "-dec_param" to "write_verilog" pass for
      compatibility with other tools.

  Various
    - Strings have been reimplemented with prefix dedu

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON