feat: refactor devshell as modular standalone path lol
This commit is contained in:
parent
41546aa83a
commit
9e6791569e
9 changed files with 284 additions and 79 deletions
148
devshells/README.md
Normal file
148
devshells/README.md
Normal file
|
|
@ -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`
|
||||
9
devshells/default.nix
Normal file
9
devshells/default.nix
Normal file
|
|
@ -0,0 +1,9 @@
|
|||
{ pkgs, ... }:
|
||||
|
||||
pkgs.mkShell {
|
||||
name = "default";
|
||||
packages = with pkgs; [ git nixfmt-classic ];
|
||||
shellHook = ''
|
||||
echo "Loaded default shell for dotfiles development"
|
||||
'';
|
||||
}
|
||||
13
devshells/go.nix
Normal file
13
devshells/go.nix
Normal file
|
|
@ -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}"
|
||||
'';
|
||||
}
|
||||
41
devshells/ml-ai.nix
Normal file
41
devshells/ml-ai.nix
Normal file
|
|
@ -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"
|
||||
'';
|
||||
}
|
||||
12
devshells/python-uv.nix
Normal file
12
devshells/python-uv.nix
Normal file
|
|
@ -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}"
|
||||
'';
|
||||
}
|
||||
12
devshells/rust.nix
Normal file
12
devshells/rust.nix
Normal file
|
|
@ -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}"
|
||||
'';
|
||||
}
|
||||
19
devshells/web-bun.nix
Normal file
19
devshells/web-bun.nix
Normal file
|
|
@ -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}"
|
||||
'';
|
||||
}
|
||||
13
devshells/zig-nightly.nix
Normal file
13
devshells/zig-nightly.nix
Normal file
|
|
@ -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 ""
|
||||
}"
|
||||
'';
|
||||
})
|
||||
Loading…
Add table
Add a link
Reference in a new issue