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.

laylight sends anonymous usage statistics (command, option names, file kinds and sizes, run time, version, system; never file names, contents or identifiers, and nothing in CI). Turn them off with laylight telemetry disable or LAYLIGHT_TELEMETRY=0; see Telemetry.