LibreLane is a powerful and versatile infrastructure library that enables the construction of digital implementation flows for application specific integrated circuits (ASICs) based on open-source and commercial electronic design automation (EDA) tools.
LibreLane is:
-
Simple to use – Configure your entire ASIC implementation flow using one file.
-
Free and open source – With a complementary set of open-source process design kits (PDKs), design and implement your chip without signing a single document. Freely modify both the infrastructure, underlying tools, and PDK to fit your needs – you're in control. Not a vendor.
-
Flexible and extensible – Create custom flows, both by simple modifications to the default flows in the configuration file, or by writing Python scripts or plugins to implement advanced functionality.
-
Hermetic – Rewind and explore alternative configurations without losing data; LibreLane captures explicit snapshots of the configuration and state of your design at every step.
-
Reproducible and traceable – LibreLane comes packaged with a verified environment of free EDA utilities with a simple goal in mind: same tools, same flow, same configuration; same result. Capture your modifications and engineering change orders (ECOs) as automated steps, and make your flow your documentation.
LibreLane includes two reference flows (Classic and Chip) that are built
entirely using open-source EDA tools.
You can find the documentation here to get started. You can discuss LibreLane in the FOSSi Chat Matrix Server.
from librelane.flows import Flow
Classic = Flow.factory.get("Classic")
flow = Classic(
{
"PDK": "sky130A",
"DESIGN_NAME": "spm",
"VERILOG_FILES": ["./src/spm.v"],
"CLOCK_PORT": "clk",
"CLOCK_PERIOD": 10,
},
design_dir=".",
)
flow.start()
Try it out
You can try LibreLane right in your browser, free-of-charge, using Google Colaboratory by following this link.
Installation
You'll need the following:
- Python 3.10 or higher with PIP, Venv and Tkinter
Nix (Recommended)
Works for macOS and Linux (x86-64 and aarch64). Recommended, as it is more integrated with your filesystem and overall has less upload and download deltas.
See Nix-based installation in the docs for more info.
Docker
Works for Windows, macOS and Linux (x86-64 and aarch64).
See Docker-based installation in the docs for more info.
Do note you'll need to add --dockerized right after librelane in most CLI
invocations.
Python-only Installation (Advanced, Not Recommended)
You'll need to bring your own compiled utilities, but otherwise, simply install LibreLane as follows:
python3 -m pip install --upgrade librelane
Python-only installations are presently unsupported and entirely at your own risk.
Usage
In the root folder of the repository, you may invoke:
python3 -m librelane --pdk-root <path/to/pdk> </path/to/config.json>
To start with, you can try:
python3 -m librelane --pdk-root $HOME/.ciel ./designs/spm/config.json
Publication
If you use LibreLane in your research, please cite the following paper.
- M. Shalan and T. Edwards, “Building OpenLANE: A 130nm OpenROAD-based Tapeout-Proven Flow: Invited Paper,” 2020 IEEE/ACM International Conference On Computer Aided Design (ICCAD), San Diego, CA, USA, 2020, pp. 1-6. Paper
@INPROCEEDINGS{9256623,
author={Shalan, Mohamed and Edwards, Tim},
booktitle={2020 IEEE/ACM International Conference On Computer Aided Design (ICCAD)},
title={Building OpenLANE: A 130nm OpenROAD-based Tapeout- Proven Flow : Invited Paper},
year={2020},
volume={},
number={},
pages={1-6},
doi={}}
Contributing
Thank you in advance for considering a contribution to LibreLane!
Please be sure to read our contributor's guide.
License and Legal Info
LibreLane and the LibreLane logo are trademarks of the FOSSi Foundation.
The LibreLane logo was created by Jon Walters.
LibreLane code and binaries are available under
The Apache License, version 2.0,
except Nix-language files ending with .nix, which are available under the
MIT License as published by the
Open Source Initiative.
LibreLane is based on OpenLane 2 by Efabless Corporation (assets owned by UmbraLogic Technologies LLC):
Copyright 2022-2025 UmbraLogic Technologies LLC
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
UmbraLogic Technologies LLC has agreed to relicense all OpenLane 2 Nix code as MIT, for which we are grateful.
2 maintainers
Metadata
2 maintainers
Release files for librelane 3.0.12
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| librelane-3.0.12.tar.gz | 308.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| librelane-3.0.12-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 734.4 kB
Release files / librelane-3.0.12.tar.gz
| Download URL | librelane-3.0.12.tar.gz |
|---|---|
| Size | 308.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b4cc1aef9ca442075bbc8ca6f89a6eb7666931054885a930e64c7bf5c824ef9e
|
|
BLAKE2b-256 checksum How to use checksums |
bf96e843e4fad7202b2262bf6f79567fa4f423f0a3a7fdaec4ee9ce784293e37
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 6, 2026.
Transparency logRelease files / librelane-3.0.12-py3-none-any.whl
| Download URL | librelane-3.0.12-py3-none-any.whl |
|---|---|
| Size | 426.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e5253fd7eca97afed90adcfa238ae1d9fd5694c5db9899a437343f1f065c4b13
|
|
BLAKE2b-256 checksum How to use checksums |
24f8949b4e7352a735adcb384ff131c49f9ec576c081061a1ecac46d7966ffa2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 6, 2026.
Transparency log
