Nodes/Anima Resolutions/Anima Detailer Align Hook
ComfyUI Node

Anima Detailer Align Hook

FaceDetailer feeding you Anima noise soup? Snap the crops to 32

By cyberdeliaAI·Created 3 months ago·Updated about a month ago· 2
Anima Detailer Align Hook
    • detailer_hook
    alignment32

    If you've ever run Impact Pack's FaceDetailer on Anima, you've probably met the wall: crops that came out crisp on SDXL come back as a noisy mess, or look different depending on which scheduler you happen to be using. That's not you failing - Anima is genuinely more sensitive to detailer crop sizes than the SDXL stack ever was. One reliable part of the fix is sampling the crop at a size the model actually likes. Anima Detailer Align Hook automates that bit: it rounds the detailer's sampling size up to a multiple, 32 by default.

    How it works

    Impact Pack's detailer loop is detect → crop → resample → paste back. The problem is that the crop size handed over by the detector is whatever the bounding box happened to be - a face might come out at 403x371, a size that doesn't play nicely with Anima's latent grid. This node subclasses Impact's DetailerHook and overrides its size hook, rounding both width and height up to the chosen multiple. So that 403px-wide crop gets resampled at 416 instead, on a size grid the model handles better.

    It rounds up, deliberately, never down. A crop a few pixels larger than the detection box is harmless; a crop that's been shrunk risks losing the region you're trying to refine. That "round up, never down" is the whole design philosophy in one sentence.

    The node's single input is alignment - none, 8, 16, 32, or 64, defaulting to 32. Why 32? It's the author's recommended grid for Anima, and it's a safe multiple of the VAE's latent scale. none passes sizes through untouched, which is handy for A/B testing whether alignment is actually changing anything.

    The output is one detailer_hook, and you wire it into the detailer_hook input on an Impact Pack detailer - FaceDetailer or Detailer For Each both take one. That's it. The hook sits alongside the detailer and quietly adjusts its sampling sizes.

    One honest caveat

    This is a grid-alignment fix, not a cure-all. Community reports on Anima detailing are consistent about the other failure mode: large crops - like a whole body - collapse into texture/noise even on a perfect grid, because the model loses the surrounding context once you isolate a huge region. Keep the detector's crop tight (eyes and mouths work best), match the sampler and scheduler to your main pass, and only then let the hook align things. If the detailer keeps fighting you, plenty of people skip it entirely and use a ~1.25x upscale plus img2img at ~0.4 denoise, or a latent upscale at 1.25 with denoise 0.25–0.35. And remember Anima accumulates artifacts if you run multiple detail passes - one pass, then stop.

    Installation

    This node requires ComfyUI Impact Pack, full stop. Install that first via Manager (search "Impact Pack"), then install this pack ("Anima Resolutions"). Manual:

    cd ComfyUI/custom_nodes
    git clone https://github.com/ltdrdata/ComfyUI-Impact-Pack.git
    git clone https://github.com/cyberdeliaAI/ComfyUI-anima-Resolutions.git
    

    Then restart ComfyUI.

    The Impact import is lazy, so the pack itself loads fine without Impact installed - you'll only hit the error when you use the hook, and it's a helpful one: a clear message telling you to install or update Impact Pack and restart. No models are downloaded by this pack; the other two nodes in it work fine without Impact Pack at all.

    CategoryAnima/Detailer

    Inputs (1)

    NameTypeDefaultDescription
    alignmentCOMBO325 options: none, 8, 16, 32, 64

    Outputs (1)

    NameTypeDescription
    detailer_hookDETAILER_HOOK