dotfiles/devshells/README.md

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.

nix develop

python-uv

Python development with UV package manager.

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.

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:

# 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.

nix develop .#go

Includes:

• Go compiler
• gopls (language server)
• golangci-lint
• delve (debugger)

web-bun

Modern web development with Bun runtime.

nix develop .#web-bun

Includes:

• Bun
• Node.js 20
• Yarn
• esbuild
• vscode-langservers-extracted

rust

Rust development environment.

nix develop .#rust

Includes:

• Cargo & rustc
• rust-analyzer
• rustfmt
• clippy

zig-nightly (optional)

Zig nightly development (only available if zig overlay is working).

nix develop .#zig-nightly

Usage from Any Directory

You can use these shells from anywhere by referencing your dotfiles:

# 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:

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:

{ pkgs, ... }:

pkgs.mkShell {
  name = "java";
  packages = with pkgs; [ jdk maven ];
  shellHook = ''
    echo "Java development shell ready"
  '';
}

3. Add it to flake.nix imports:

java = importShell "java";

4. Test: nix flake check