ComfyUI-HiddenImages

ComfyUI-HiddenImages

ComfyUI-HiddenImages is a ComfyUI custom-node pack and installer for hidden-image workflows across SD 1.5, SDXL, and FLUX.

The project is built around three goals:

• single-click dependency setup for hidden-image experiments
• custom nodes for pattern preprocessing, text-mask generation, scheduler presets, and FLUX-style latent ghosting
• workflow blueprints for QR, subliminal text, logo, and optical-illusion style pipelines

Features

• NanoBanana Pattern Preprocessor Normalizes black-and-white source art with blur, thresholding, brightness, and contrast controls.
• NanoBanana Text Mask Generates hidden-text masks directly inside ComfyUI.
• NanoBanana Magic Scheduler Maps a single magic_slider value to recommended per-family ControlNet settings.
• NanoBanana Latent Mask Builds soft luminance masks for FLUX ghost-pattern workflows.
• cross-platform installer install.sh and install.bat install Python dependencies, clone companion nodes, and download public ControlNet assets.
• preset-driven setup qr, text, ghost, and all presets target different hidden-image use cases.

Repository layout

• illusion_nodes.py ComfyUI custom node implementations.
• scripts/check_and_fill.py Manifest-driven dependency installer.
• model_manifest.json Public model list, preset mapping, and manual follow-up entries.
• workflows/ Workflow blueprints for SD 1.5, SDXL, FLUX, and a unified router preset.
• docs/WORKFLOWS.md Notes on how to wire the blueprint workflows inside ComfyUI.

Install

Inside ComfyUI/custom_nodes

cd /path/to/ComfyUI/custom_nodes
git clone https://github.com/GeekatplayStudio/ComfyUI-HiddenImages.git
cd ComfyUI-HiddenImages
./install.sh

Against an external ComfyUI root

git clone https://github.com/GeekatplayStudio/ComfyUI-HiddenImages.git
cd ComfyUI-HiddenImages
./install.sh /path/to/ComfyUI

Windows:

install.bat C:\path\to\ComfyUI

Installer presets

./install.sh /path/to/ComfyUI --preset qr
./install.sh /path/to/ComfyUI --preset text
./install.sh /path/to/ComfyUI --preset ghost
./install.sh --list-presets

• qr Aggressive SD 1.5 and SDXL pattern control for readable QR-style results.
• text Tuned for hidden text and logo reveals.
• ghost FLUX-oriented low-strength ControlNet plus latent-mask setup.
• all Installs every public preset in the manifest.

You can further limit scope with --family sd15, --family sdxl, or --family flux.

Hugging Face token support

Pass a token explicitly:

./install.sh /path/to/ComfyUI --preset ghost --hf-token hf_xxx

Resolution order:

• --hf-token
• manifest-defined token_env, when present
• HF_TOKEN
• HUGGINGFACE_HUB_TOKEN

What the installer does

• checks Python, Git, and Torch visibility
• installs packages from requirements.txt
• clones common dependency nodes when missing:
  • ComfyUI-Manager
  • ComfyUI_IPAdapter_plus
  • comfyui_controlnet_aux
• downloads public hidden-image ControlNet weights for SD 1.5, SDXL, and FLUX

The installer does not auto-download gated or license-acceptance base models such as FLUX.1-dev. Those remain manual and are listed in model_manifest.json under manual_models.

Workflows

The workflows/ directory currently contains blueprint JSON files rather than exported ComfyUI canvases:

• sd15_qr_hidden_image.json
• sdxl_qr_hidden_image.json
• flux_ghost_hidden_image.json
• unified_illusion_router.json

This is intentional for now. Saved ComfyUI graph exports depend on the exact checkpoint loader and FLUX packaging used in a live install.

Roadmap

• importable ComfyUI workflow canvases
• more style presets for logos, spirals, and depth-guided illusions
• optional gated-model manifest entries
• stronger FLUX workflow automation

License

This repository is released under the MIT License. See LICENSE.

Model weights, third-party nodes, and external checkpoints retain their own upstream licenses.