Dotfiles-nix uv

Use `uv` instead of pip/python/venv. Run scripts with `uv run script.py`, add deps with `uv add`, use inline script metadata for standalone scripts.

install

source · Clone the upstream repo

git clone https://github.com/not-matthias/dotfiles-nix

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/not-matthias/dotfiles-nix "$T" && mkdir -p ~/.claude/skills && cp -r "$T/modules/home/programs/cli-agents/shared/skills/uv" ~/.claude/skills/not-matthias-dotfiles-nix-uv && rm -rf "$T"

manifest: modules/home/programs/cli-agents/shared/skills/uv/SKILL.md

source content

Quick Reference

uv run script.py                   # Run a script
uv run --with requests script.py   # Run with ad-hoc dependency
uv run python -m ast foo.py >/dev/null  # Verify syntax without writing __pycache__
uv add requests                    # Add dependency to project
uv init --script foo.py            # Create script with inline metadata

Inline Script Dependencies

# /// script
# requires-python = ">=3.12"
# dependencies = ["requests"]
# ///

See scripts.md for full details on running scripts, locking, and reproducibility.

Build Backend

Use

uv_build

for pure Python packages:

[build-system]
requires = ["uv_build>=0.9.28,<0.10.0"]
build-backend = "uv_build"

See build.md for project structure, namespaces, and file inclusion.