Supported architectures:

• aarch64-linux
• x86_64-linux (Linux and possibly WSL2 on Windows)
• aarch64-darwin (macOS on Apple Silicon)

Usage

You will need a working installation of Nix which can be obtained here (few additional options available).

An optional step is to enable the binary cache for this overlay:

nix-shell -p cachix --run "cachix use epic-eic"

nix-shell

A quick way to start using the packages is to clone the repository and invoke a nix-shell, which will start a shell with environment that includes all the EIC packages:

git clone https://github.com/veprbl/epic-nix.git
cd epic-nix
nix-shell

Flakes

Depending on the version of Nix that you have, you may have to first enable the following features:

echo "experimental-features = nix-command flakes" >> ~/.config/nix/nix.conf

Similar to the nix-shell approach above, one can invoke the environment without cloning the repository:

nix develop github:veprbl/epic-nix

or with cloning:

git clone https://github.com/veprbl/epic-nix.git
cd epic-nix
nix develop

Agent skill

skills/epic-nix/SKILL.md is an Agent Skill that teaches coding agents how to use this flake: overriding package sources with --override-input (local checkouts, branches, pull requests), estimating rebuild cost, and running an npsim + EICrecon chain. It is picked up automatically by agents that read .agents/skills/ when working inside this repository. To use it elsewhere, link it into your user skill directory:

mkdir -p ~/.agents/skills
ln -s "$PWD/skills/epic-nix" ~/.agents/skills/epic-nix  # or ~/.claude/skills/epic-nix