Let's try this

.github/workflows/nix_environment_testing.yaml

@@ -16,20 +16,8 @@ jobs:
         uses: actions/checkout@v3
 
       # Step 2: Install Nix
-      - name: Install Nix with Extra Options
-        run: |
-          curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix/pr/1145 | sh -s -- install --no-confirm --extra-conf "
-            extra-substituters = https://openlane.cachix.org
-            extra-trusted-public-keys = openlane.cachix.org-1:qqdwh+QMNGmZAuyeQJTH9ErW57OWSvdtuwfBKdS254E=
-          "
-      # Step 3: Enable Nix Flakes
-      - name: Enable Nix Flakes
-        run: |
-          mkdir -p ~/.config/nix
-          echo "experimental-features = nix-command flakes" >> ~/.config/nix/nix.conf
-      # Step 5: Build the flake with no options
-      - name: Build Flake
-        run: nix build .
+      - name: Install and Build Nix with script
+        run: source scripts/install_piel_nix.sh
 
       # Step 6: Run flake checks/tests
       - name: Run Flake Checks

docs/examples/07_full_flow_demo_electronic_photonic/07_full_flow_demo_electronic_photonic.py

@@ -1,5 +1,36 @@
 # # `piel` Electronic-Photonic Co-Design - Full Flow Demo
 
+# <div style="padding: 10px; border-radius: 5px;">
+# <strong>⚠️ Warning:</strong> This example requires using the piel nix environment which are locally available when cloning and installing the `stable` verision of the github source code. See example setup as follows
+# </div>
+#
+# Note that this is only tested in an ubuntu environment:
+# ```
+# git clone https://github.com/daquintero/piel.git
+# source scripts/install_piel_nix.sh
+# nix develop .
+# ```
+#
+# You can verify you have the tools required by running the following magic cells:
+
+# ! which openlane
+
+# ```
+# /nix/store/9jb8wsk32ny2yy5ghcaq3y7mbmmavi2c-python3.11-openlane/bin/openlane
+# ```
+
+# ! which ngspice
+
+# ```
+# /nix/store/9jb8wsk32ny2yy5ghcaq3y7mbmmavi2c-python3.11-openlane/bin/openlane
+# ```
+
+# ! which gtkwave
+
+# ```
+# /nix/store/9jb8wsk32ny2yy5ghcaq3y7mbmmavi2c-python3.11-openlane/bin/openlane
+# ```
+
 # The goal of this notebook is to demonstrate some of the codesign functionality in a photonics-first electronically-specified system.
 #
 #

scripts/install_piel_nix.sh

@@ -0,0 +1,7 @@
+ curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix/pr/1145 | sh -s -- install --no-confirm --extra-conf "
+    extra-substituters = https://openlane.cachix.org
+    extra-trusted-public-keys = openlane.cachix.org-1:qqdwh+QMNGmZAuyeQJTH9ErW57OWSvdtuwfBKdS254E=
+"
+mkdir -p ~/.config/nix
+echo "experimental-features = nix-command flakes" >> ~/.config/nix/nix.conf
+nix build .