recipe

Manage versioned provider setup packs without contacting a provider. Recipe metadata includes a manifest style template, included workflow hashes, external model hashes and licenses, and an explicit quality stage.

pixelkiln recipe list
pixelkiln recipe inspect comfyui/pixel-art-xl-environment
pixelkiln recipe install comfyui/pixel-art-xl-environment@1.0.0
pixelkiln recipe verify \
  pixelkiln-recipes/comfyui/pixel-art-xl-environment/1.0.0 \
  --model-root /path/to/ComfyUI/models

Subcommand	Effect
list	Lists every recipe bundled with this PixelKiln version.
inspect <id-or-path>	Shows identity, provider, quality stage, native/palette targets, workflow, and required models.
install <id-or-path>	Verifies and copies a pack. The default versioned destination is pixelkiln-recipes/<provider>/<name>/<version>; --out names a different directory. Prints a manifest-ready style entry with the installed workflow path.
verify <id-or-path>	Checks the metadata digest and included workflow bytes. --model-root also hashes every required model and exits nonzero for a missing or mismatched model.

An unversioned id selects the newest bundled version. Exact selectors use provider/name@x.y.z. Install refuses to replace a locally changed declared file unless --force is passed. It never downloads dependencies or removes extra files. list, inspect, install, and verify support --json.

Without --model-root, external models are reported as unchecked and do not make the recipe itself invalid. This distinction lets CI verify the committed pack while workstation setup verifies multi-gigabyte model files. See Versioned recipes for the file contract and update policy.