laylight-cli

The laylight command line for Laylight, a language for photonic and integrated-circuit layouts. It checks, formats and compiles Laylight files to GDSII, writes netlists, publishes cells as blackboxes and turns GDSII back into Laylight source.

pip install laylight-cli        # or: uv tool install laylight-cli, pipx install laylight-cli

The Laylight Python library depends on this package, so pip install laylight installs the command too.

laylight check  ring.lyl              # syntax, types, units and evaluation
laylight build  ring.lyl -o ring.gds  # compile to GDSII
laylight ir     ring.lyl              # print the Laylight IR
laylight netlist ring.lyl             # connectivity as JSON; `lvs` compares it
laylight fmt    ring.lyl              # format in place
laylight decompile chip.gds -o chip.lyl
laylight blackbox ring.lyl -o ring.lyir  # publish outline and ports; `unbox` restores the cell
laylight build chip.gds -o filled.gds --dummy si   # add dummy fill to a layer

The wheels hold a native executable for Linux x86-64 and ARM64 (glibc 2.17 or later), macOS on Apple silicon and Windows x86-64; it does not depend on the Python version. On other systems the package installs a laylight command that only reports the missing build. See the Installation Guide for other ways to install, and the Changelog for what each release changed.