moondream2 (Down)Load

moondream2 (Down)Load is the model loader for this pack, and it's the reason you might pick this pack over the more famous alternative. Kijai's ComfyUI-moondream has been around forever, but it expects you to already have the weights - and there's a well-worn trail of people on r/comfyui getting tangled up trying to figure out which safetensors to clone from HuggingFace and where to drop them. Here you get two dropdowns and the node does the fetching for you.

It's a tiny node: size and quant in, a moondream2 model out. First run downloads the weights from vikhyatk/moondream2 on HuggingFace (Apache-2.0, so no licensing surprises), caches them, and every run after that just loads from disk.

The two inputs that matter

• size - 2b (default) or 0.5b. The 2b is the real model: noticeably sharper captions and answers. The 0.5b is the pocket edition - fast, tiny, and you can feel the IQ drop. If your machine runs the 2b at all, run the 2b.
• quant - int8 (default) or int4. int8 is basically fp16 quality at about half the size; if it fits, just use it. int4 is the smallest and fastest option, and it starts to show its teeth on grammar and fine details. Most people never need to leave int8.

The model output feeds the pack's other three nodes: Encode (vision-encoding an image) and, through that, Caption and Query. It's the checkpoint-loader slot of this little ecosystem - nothing works until this has run.

Install

ComfyUI Manager → search ComfyUI-moondream2, or:

cd ComfyUI/custom_nodes
git clone https://github.com/zhilemann/ComfyUI-moondream2

Restart ComfyUI and you're done. There's no separate model file to place by hand - that's the whole point of the node. The pack does need a reasonably recent transformers under the hood; ComfyUI's bundled environment usually has one, and if it doesn't you'll see it the moment the load happens.

Common issues

The first-run download is the thing that catches everyone: a couple of gigabytes pulled from HuggingFace with nothing on screen but a busy node. Give it time; it's cached after that.

If the load itself errors and the traceback mentions transformers, that's the classic moondream failure mode - an environment with a transformers version too old to know the model. pip install -U transformers and restart.

One honest caveat: the author of this pack has basically no community footprint - nothing turns up when you look - so treat it as a small personal project. It works, but there's no update cadence to rely on. And note that moondream2 is itself a generation old upstream; the HuggingFace card now points to a moondream3 preview. Fine for what this does, just don't expect the bleeding edge here.