Install Dependencies

Two surfaces:

1. System binaries — required: ImageMagick, exiftool. Optional: libvips-tools, libheif-examples, oxipng, pngquant, jpegoptim, mozjpeg, libavif-bin, libjxl-tools, realesrgan-ncnn-vulkan, darktable-cli.
2. Python tools — imagehash, Pillow (perceptual dedupe). Installed into a plugin-owned uv venv at <data-dir>/venv/.

The plugin invokes Python via <data-dir>/venv/bin/python, so the user's system Python stays untouched and PEP 668 / externally-managed-environment errors never occur.

Resolve paths

PLUGIN_DATA_DIR="${CLAUDE_USER_DATA:-${XDG_DATA_HOME:-$HOME/.local/share}/claude-plugins}/image-production"
VENV_DIR="$PLUGIN_DATA_DIR/venv"

Procedure

1. Detect host