Nix-based Development Environment¶

For the GDS backend flow, we use Nix as our environment manager and development tool. Nix provides a reproducible, isolated environment for development and usage, ensuring that all dependencies are correctly managed. This is especially useful for complex EDA toolchains that have many dependencies and require specific versions of libraries and tools to function correctly.

Setting Up the Nix Environment¶

You can install the Nix environment by running the following command:

FABulous install-nix

Or follow this guide to install it manually.

The FABulous install-nix command will download and run the Nix installation scripts with installation cache set up to speed up the process. Note that during the installation you will be prompted to provide sudo access. If this is not possible, you can try installing Nix as a standalone executable by following this guide.

Already have Nix setup¶

If you already have Nix installed, you will need to add the binary cache yourself and enable the experimental feature, flake. For more details check the following guide.

Entering the Nix Environment¶

The recommended way to enter the Nix development environment is:

FABulous nix-env

This command will:

Locate the flake.nix at the installed package data
Deactivate any active virtual environment or conda environment that could conflict
Set up the Nix development shell with all EDA tools (Yosys, NextPNR, OpenROAD, GHDL, etc.)
Verify that the tools are correctly sourced from the Nix store
Drop you into your preferred shell (auto-detected from $SHELL)

On first start this will take a bit of time as Nix downloads and builds the required packages. Subsequent starts will be much faster thanks to the Nix binary cache.

Options¶

You can customize the behavior with the following options:

# Use a specific shell (bash, fish, or zsh)
FABulous nix-env --shell bash
FABulous nix-env --shell fish

# Skip the EDA tool verification check
FABulous nix-env --no-check

# Point to a specific directory containing flake.nix
FABulous nix-env --flake-dir /path/to/fabulous

Tool verification¶

By default, FABulous nix-env silently smoke test that software are available and sourced from the Nix store (/nix/store/...). If any tool is missing or not from the Nix store, the command will print an error and exit. You can skip this check with --no-check.

Shell compatibility¶

FABulous nix-env handles a known issue where fish shell re-orders PATH entries on startup, which can cause system-installed tools to shadow Nix tools. The command automatically re-prepends Nix paths after fish’s configuration files have loaded.

Manual Nix Shell Activation¶

You can also activate the development shell manually using nix develop:

# with a bash shell
nix develop

# if you use zsh or fish
nix develop .#zsh
nix develop .#fish

Note that when using nix develop directly, you may need to manually deactivate any active virtual environments first, and the automatic tool verification will not run.

Verifying the Environment¶

To verify the environment is set up correctly, you can run:

which openroad
which fab-yosys

You should see paths pointing to the Nix store, for example:

/nix/store/fkpj5szgsm7ydnykm7zcsvxqdmklf0m3-devshell-dir/bin/openroad

If the commands point back to your system’s default installation paths, the Nix environment is not set up correctly. This can happen if another environment was active before you entered the Nix shell. In that case, open a new terminal and use FABulous nix-env to enter a clean environment.