feat: refactor devshell as modular standalone path lol

devshells/README.md

@@ -0,0 +1,148 @@
+# Development Shells
+
+This directory contains modular Nix devShell configurations for various programming languages and use cases.
+
+## Available Shells
+
+### `default`
+Basic shell with git and nixfmt for dotfiles development.
+
+```bash
+nix develop
+```
+
+### `python-uv`
+Python development with UV package manager.
+
+```bash
+nix develop .#python-uv
+```
+
+**Includes:**
+- Python 3.12
+- UV (fast Python package manager)
+- Ruff (linter/formatter)
+- Pyright (type checker)
+
+### `ml-ai`
+Machine Learning and AI development with HuggingFace model management.
+
+```bash
+nix develop .#ml-ai
+```
+
+**Includes:**
+- Python 3.12 with huggingface-hub
+- `huggingface-cli` for downloading models
+- UV for package management
+- Git LFS for large files
+- Ruff and Pyright
+
+**Model cache:** `~/.cache/huggingface` (persistent across projects)
+
+**Example usage:**
+```bash
+# Download a TTS model
+huggingface-cli download facebook/mms-tts-eng
+
+# Download a small LLM
+huggingface-cli download meta-llama/Llama-3.2-1B
+
+# Download specific files only
+huggingface-cli download openai/whisper-large-v3 --include "*.json" "*.safetensors"
+
+# Use in your project
+uv init my-ml-project
+cd my-ml-project
+uv add transformers torch
+```
+
+### `go`
+Go development environment.
+
+```bash
+nix develop .#go
+```
+
+**Includes:**
+- Go compiler
+- gopls (language server)
+- golangci-lint
+- delve (debugger)
+
+### `web-bun`
+Modern web development with Bun runtime.
+
+```bash
+nix develop .#web-bun
+```
+
+**Includes:**
+- Bun
+- Node.js 20
+- Yarn
+- esbuild
+- vscode-langservers-extracted
+
+### `rust`
+Rust development environment.
+
+```bash
+nix develop .#rust
+```
+
+**Includes:**
+- Cargo & rustc
+- rust-analyzer
+- rustfmt
+- clippy
+
+### `zig-nightly` (optional)
+Zig nightly development (only available if zig overlay is working).
+
+```bash
+nix develop .#zig-nightly
+```
+
+## Usage from Any Directory
+
+You can use these shells from anywhere by referencing your dotfiles:
+
+```bash
+# From any directory
+cd ~/my-project
+nix develop ~/Development/dotfiles#ml-ai
+```
+
+## Auto-loading with direnv
+
+To automatically load a shell when entering a directory:
+
+```bash
+cd ~/my-ml-project
+echo "use flake ~/Development/dotfiles#ml-ai" > .envrc
+direnv allow
+```
+
+Now the shell automatically activates when you `cd` into that directory!
+
+## Adding New Shells
+
+1. Create a new file in `devshells/` (e.g., `devshells/java.nix`)
+2. Follow the pattern:
+```nix
+{ pkgs, ... }:
+
+pkgs.mkShell {
+  name = "java";
+  packages = with pkgs; [ jdk maven ];
+  shellHook = ''
+    echo "Java development shell ready"
+  '';
+}
+```
+3. Add it to `flake.nix` imports:
+```nix
+java = importShell "java";
+```
+4. Test: `nix flake check`

devshells/default.nix

@@ -0,0 +1,9 @@
+{ pkgs, ... }:
+
+pkgs.mkShell {
+  name = "default";
+  packages = with pkgs; [ git nixfmt-classic ];
+  shellHook = ''
+    echo "Loaded default shell for dotfiles development"
+  '';
+}

devshells/go.nix

@@ -0,0 +1,13 @@
+{ pkgs, ... }:
+
+pkgs.mkShell {
+  name = "go";
+  packages = with pkgs; [ go gopls golangci-lint delve git ];
+  shellHook = ''
+    mkdir -p "$PWD/.cache/go" "$PWD/.cache/gomod"
+    export GOPATH="$PWD/.cache/go"
+    export GOMODCACHE="$PWD/.cache/gomod"
+    echo "Go toolchain shell ready"
+    echo "Go: ${pkgs.go.version}"
+  '';
+}

devshells/ml-ai.nix

@@ -0,0 +1,41 @@
+{ pkgs, python ? pkgs.python312, ... }:
+
+let
+  # Create a Python environment with huggingface-cli
+  pythonWithHF = python.withPackages (ps: [ ps.huggingface-hub ]);
+in pkgs.mkShell {
+  name = "ml-ai";
+  packages = with pkgs; [
+    pythonWithHF
+    uv
+    git-lfs
+    ruff
+    pyright
+  ];
+  shellHook = ''
+    # Set up UV
+    export UV_PYTHON="${pythonWithHF}/bin/python3"
+    export UV_LINK_MODE=copy
+
+    # Set up HuggingFace cache (persistent across projects)
+    export HF_HOME="''${XDG_CACHE_HOME:-$HOME/.cache}/huggingface"
+    export HF_HUB_CACHE="$HF_HOME/hub"
+    mkdir -p "$HF_HOME"
+
+    # Optional: Set offline mode (uncomment to use only cached models)
+    # export HF_HUB_OFFLINE=1
+
+    echo "ML/AI shell ready"
+    echo "Python: ${python.version}"
+    echo "HuggingFace cache: $HF_HOME"
+    echo ""
+    echo "Download models with:"
+    echo "  huggingface-cli download <model-id>"
+    echo ""
+    echo "Example TTS:"
+    echo "  huggingface-cli download facebook/mms-tts-eng"
+    echo ""
+    echo "Example LLM:"
+    echo "  huggingface-cli download meta-llama/Llama-3.2-1B"
+  '';
+}

devshells/python-uv.nix

@@ -0,0 +1,12 @@
+{ pkgs, python ? pkgs.python312, ... }:
+
+pkgs.mkShell {
+  name = "python-uv";
+  packages = [ python pkgs.uv pkgs.ruff pkgs.pyright ];
+  shellHook = ''
+    export UV_PYTHON="${python}/bin/python3"
+    export UV_LINK_MODE=copy
+    echo "Python (uv) shell ready"
+    echo "Python: ${python.version}"
+  '';
+}

devshells/rust.nix

@@ -0,0 +1,12 @@
+{ pkgs, ... }:
+
+pkgs.mkShell {
+  name = "rust";
+  packages = with pkgs; [ cargo rustc rust-analyzer rustfmt clippy ];
+  shellHook = ''
+    mkdir -p "$PWD/.cache/cargo"
+    export CARGO_HOME="$PWD/.cache/cargo"
+    echo "Rust toolchain shell ready"
+    echo "Rust: ${pkgs.rustc.version}"
+  '';
+}

devshells/web-bun.nix

@@ -0,0 +1,19 @@
+{ pkgs, ... }:
+
+pkgs.mkShell {
+  name = "web-bun";
+  packages = with pkgs; [
+    bun
+    nodejs_20
+    yarn
+    esbuild
+    vscode-langservers-extracted
+  ];
+  shellHook = ''
+    mkdir -p "$PWD/.cache/bun"
+    export BUN_INSTALL_CACHE="$PWD/.cache/bun"
+    echo "Bun/Node web shell ready"
+    echo "Bun: ${pkgs.bun.version}"
+    echo "Node: ${pkgs.nodejs_20.version}"
+  '';
+}

devshells/zig-nightly.nix

@@ -0,0 +1,13 @@
+{ pkgs, lib, zigPackage, ... }:
+
+lib.optionalAttrs (zigPackage != null) (pkgs.mkShell {
+  name = "zig-nightly";
+  packages = [ zigPackage pkgs.zls pkgs.pkg-config pkgs.cmake pkgs.gdb ];
+  shellHook = ''
+    mkdir -p "$PWD/.cache/zig"
+    export ZIG_GLOBAL_CACHE_DIR="$PWD/.cache/zig"
+    echo "Zig shell using ${zigPackage.pname or "zig"} ${
+      zigPackage.version or ""
+    }"
+  '';
+})

flake.nix

@@ -86,6 +86,7 @@
           else
             pkgs.python3;
 
+          # Zig overlay setup for zig-nightly shell
           zigPackages =
             if zigOverlay != null && builtins.hasAttr "packages" zigOverlay then
               zigOverlay.packages
@@ -126,85 +127,22 @@
           else
             false;
 
-          zigShell =
+          # Common arguments passed to all devshell imports
-            lib.optionalAttrs (zigPackage != null && zlsBroken == false) {
+          shellArgs = { inherit pkgs lib python zigPackage; };
-              zig-nightly = pkgs.mkShell {
-                name = "zig-nightly";
-                packages =
-                  [ zigPackage pkgs.zls pkgs.pkg-config pkgs.cmake pkgs.gdb ];
-                shellHook = ''
-                  mkdir -p "$PWD/.cache/zig"
-                  export ZIG_GLOBAL_CACHE_DIR="$PWD/.cache/zig"
-                  echo "Zig shell using ${zigPackage.pname or "zig"} ${
-                    zigPackage.version or ""
-                  }"
-                '';
-              };
-            };
 
-          baseShells = {
+          # Import all devshells from devshells/ directory
-            default = pkgs.mkShell {
+          importShell = name: import (./devshells + "/${name}.nix") shellArgs;
-              name = "default";
-              packages = with pkgs; [ git nixfmt-classic ];
-              shellHook = ''
-                echo "Loaded default shell for ${system}"
-              '';
-            };
 
-            python-uv = pkgs.mkShell {
+        in {
-              name = "python-uv";
+          default = importShell "default";
-              packages = [ python pkgs.uv pkgs.ruff pkgs.pyright ];
+          python-uv = importShell "python-uv";
-              shellHook = ''
+          ml-ai = importShell "ml-ai";
-                export UV_PYTHON="${python}/bin/python3"
+          go = importShell "go";
-                export UV_LINK_MODE=copy
+          web-bun = importShell "web-bun";
-                echo "Python (uv) shell ready"
+          rust = importShell "rust";
-              '';
+        } // lib.optionalAttrs (zigPackage != null && zlsBroken == false) {
-            };
+          zig-nightly = importShell "zig-nightly";
-
+        });
-            go = pkgs.mkShell {
-              name = "go";
-              packages = with pkgs; [ go gopls golangci-lint delve git ];
-              shellHook = ''
-                mkdir -p "$PWD/.cache/go" "$PWD/.cache/gomod"
-                export GOPATH="$PWD/.cache/go"
-                export GOMODCACHE="$PWD/.cache/gomod"
-                echo "Go toolchain shell ready"
-              '';
-            };
-
-            web-bun = pkgs.mkShell {
-              name = "web-bun";
-              packages = with pkgs; [
-                bun
-                nodejs_20
-                yarn
-                esbuild
-                vscode-langservers-extracted
-              ];
-              shellHook = ''
-                mkdir -p "$PWD/.cache/bun"
-                export BUN_INSTALL_CACHE="$PWD/.cache/bun"
-                echo "Bun/Node web shell ready"
-              '';
-            };
-
-            rust = pkgs.mkShell {
-              name = "rust";
-              packages = with pkgs; [
-                cargo
-                rustc
-                rust-analyzer
-                rustfmt
-                clippy
-              ];
-              shellHook = ''
-                mkdir -p "$PWD/.cache/cargo"
-                export CARGO_HOME="$PWD/.cache/cargo"
-                echo "Rust toolchain shell ready"
-              '';
-            };
-          };
-        in baseShells // zigShell);
 
       formatter = forEachSystem (system: (mkPkgs system).nixfmt-classic);