<h1 id="anima-native-reference-v2-e180">Anima Native Reference V2 — E180</h1>Anima Native Reference V2 E180 is an experimental two-reference, image-conditioned generation model developed as part of the NOOB2 Project — Character Reference Bypass Injector Research.It generates a new anime illustration from pure noise while conditioning on:<ul><li>a text prompt;</li><li>Reference Image 1, assigned to ordered slot <code>0</code>;</li><li>Reference Image 2, assigned to ordered slot <code>1</code>.</li></ul>The two slots do not have permanently assigned scene, character, identity, or style roles. Their order is preserved, while the prompt determines how the model should interpret and combine them.The Native Reference V2 modules are already integrated into the E180 checkpoint. No external LoRA, IP-Adapter, or separate reference-adapter weight file is required.This model uses bypass injection, preserving the original text-to-image capabilities of the Anima base model. You can continue using the standard ComfyUI nodes for regular text-to-image generation.<hr /><h2 id="quick-links">Quick Links</h2><ul><li>Custom node and workflows: <a target="_blank" rel="ugc" href="https://github.com/HK416-TYPED/ComfyUI-Anima-Native-Reference">https://github.com/HK416-TYPED/ComfyUI-Anima-Native-Reference</a></li><li>Hugging Face research repository: <a target="_blank" rel="ugc" href="https://huggingface.co/LAXMAYDAY/NOOB2-Project-Character-Reference-Bypass-Injector-Research">https://huggingface.co/LAXMAYDAY/NOOB2-Project-Character-Reference-Bypass-Injector-Research</a></li><li>Anima text encoder and VAE: <a target="_blank" rel="ugc" href="https://huggingface.co/circlestone-labs/Anima">https://huggingface.co/circlestone-labs/Anima</a></li></ul><hr /><h2 id="what-this-model-does">What This Model Does</h2>Anima Native Reference V2 accepts two ordered reference images and a prompt, then creates a new image from pure noise.Possible tasks include:<ul><li>using Image 1 as a scene reference and Image 2 as a character reference;</li><li>combining character identity and costume information from both images;</li><li>transferring a character into a new composition;</li><li>preserving selected facial, hair, color, clothing, or accessory information;</li><li>prompt-controlled changes to pose, framing, lighting, and environment;</li><li>research into multi-reference character generation without training a separate LoRA for every character.</li></ul>The role of each image is defined by your prompt rather than by a fixed node assignment.<hr /><h2 id="important-architecture-notes">Important Architecture Notes</h2><ul><li>This is not img2img.</li><li>Sampling starts from pure noise.</li><li>There is no denoise-strength control.</li><li>It does not use the stock ComfyUI <code>KSampler</code> path.</li><li>It does not expose standard <code>MODEL / CLIP / VAE</code> outputs.</li><li>The E180 checkpoint already contains the learned Native Reference V2 modules.</li><li>No external LoRA, IP-Adapter, or reference-adapter checkpoint is required.</li><li>The current release requires exactly two reference images.</li><li>Each reference input currently accepts one image only.</li></ul>The two reference slots are:<pre><code>Reference Image 1 → ordered slot 0
Reference Image 2 → ordered slot 1</code></pre>Their semantics are determined by the prompt.<hr /><h1 id="installation">Installation</h1><h2 id="1.-install-the-custom-node">1. Install the Custom Node</h2>⚠️ CUSTOM NODE REQUIREDDownload and install ComfyUI-Anima-Native-Reference before using this model:<a target="_blank" rel="ugc" href="https://github.com/HK416-TYPED/ComfyUI-Anima-Native-Reference">https://github.com/HK416-TYPED/ComfyUI-Anima-Native-Reference</a>This is a complete integrated diffusion checkpoint, not a LoRA. Do not load an additional stock Anima diffusion model alongside it.<h3 id="git-installation">Git installation</h3>Open a terminal in <code>ComfyUI/custom_nodes</code> and run:<pre><code>git clone https://github.com/HK416-TYPED/ComfyUI-Anima-Native-Reference.git
cd ComfyUI-Anima-Native-Reference
python -m pip install -r requirements.txt</code></pre>Restart ComfyUI after installation.<h3 id="windows-portable-comfyui">Windows Portable ComfyUI</h3>From the root of a standard Windows Portable ComfyUI installation:<pre><code>cd ComfyUI\custom_nodes
git clone https://github.com/HK416-TYPED/ComfyUI-Anima-Native-Reference.git
cd ComfyUI-Anima-Native-Reference
..\..\..\python_embeded\python.exe -m pip install -r requirements.txt</code></pre>Restart ComfyUI after installation.The custom node does not pin or replace PyTorch. Do not manually replace a working CUDA installation of <code>torch</code> or <code>torchvision</code>.<hr /><h2 id="2.-download-the-required-model-files">2. Download the Required Model Files</h2>You need three files.<h3 id="integrated-native-reference-v2-checkpoint">Integrated Native Reference V2 checkpoint</h3>Download the model file from this Civitai release:<pre><code>anima-native-ref-v2-e180-step64080-256px.safetensors</code></pre>Place it in:<pre><code>ComfyUI/models/diffusion_models/</code></pre>This is the complete diffusion-model checkpoint used for generation.Do not also load a stock Anima diffusion checkpoint.<h3 id="anima-qwen3-text-encoder">Anima Qwen3 text encoder</h3>Download:<pre><code>qwen_3_06b_base.safetensors</code></pre>From:<a target="_blank" rel="ugc" href="https://huggingface.co/circlestone-labs/Anima/tree/main/split_files/text_encoders">https://huggingface.co/circlestone-labs/Anima/tree/main/split_files/text_encoders</a>Place it in:<pre><code>ComfyUI/models/text_encoders/</code></pre><h3 id="qwen-image-vae">Qwen-Image VAE</h3>Download:<pre><code>qwen_image_vae.safetensors</code></pre>From:<a target="_blank" rel="ugc" href="https://huggingface.co/circlestone-labs/Anima/tree/main/split_files/vae">https://huggingface.co/circlestone-labs/Anima/tree/main/split_files/vae</a>Place it in:<pre><code>ComfyUI/models/vae/</code></pre>Your final model layout should be:<pre><code>ComfyUI/
└── models/
 ├── diffusion_models/
 │ └── anima-native-ref-v2-e180-step64080-256px.safetensors
 ├── text_encoders/
 │ └── qwen_3_06b_base.safetensors
 └── vae/
 └── qwen_image_vae.safetensors</code></pre><hr /><h2 id="3.-download-the-workflow">3. Download the Workflow</h2>The standard ComfyUI workflow and API workflow are available in the custom-node repository:<ul><li>Standard workflow: <a target="_blank" rel="ugc" href="https://github.com/HK416-TYPED/ComfyUI-Anima-Native-Reference/tree/main/example_workflows">https://github.com/HK416-TYPED/ComfyUI-Anima-Native-Reference/tree/main/example_workflows</a></li><li>Local <code>/prompt</code> API workflow: <a target="_blank" rel="ugc" href="https://github.com/HK416-TYPED/ComfyUI-Anima-Native-Reference/tree/main/api_workflows">https://github.com/HK416-TYPED/ComfyUI-Anima-Native-Reference/tree/main/api_workflows</a></li></ul>The UI workflow and API workflow use different ComfyUI JSON formats and should not be treated as interchangeable.<hr /><h1 id="included-custom-nodes">Included Custom Nodes</h1><h2 id="anima-reference-v2-loader-(e180)">Anima Reference V2 Loader (E180)</h2>Loads and caches:<ul><li>the integrated E180 Native Reference V2 checkpoint;</li><li>the Anima Qwen3-0.6B text encoder;</li><li>the Qwen-Image VAE.</li></ul>The node returns a custom:<pre><code>ANIMA_NATIVE_REF_V2_PIPELINE</code></pre><h2 id="anima-reference-v2-generate-(2-refs)">Anima Reference V2 Generate (2 Refs)</h2>Generates one image using:<ul><li>the Native Reference V2 pipeline;</li><li>Reference Image 1;</li><li>Reference Image 2;</li><li>positive and negative prompts;</li><li>seed;</li><li>output width and height;</li><li>steps;</li><li>CFG;</li><li>flow shift;</li><li>reference scale;</li><li>maximum preprocessing area per reference.</li></ul><hr /><h1 id="basic-usage">Basic Usage</h1><ol><li>Install the custom node.</li><li>Put the three required model files in the correct folders.</li><li>Restart ComfyUI.</li><li>Load the provided workflow.</li><li>Select one image for Reference Image 1.</li><li>Select one image for Reference Image 2.</li><li>Write a prompt explaining how both references should be used.</li><li>Queue the workflow.</li></ol>A prompt can define Image 1 as a scene and Image 2 as a character, but this is only one possible assignment. The slots do not have permanent roles.<hr /><h1 id="prompt-examples">Prompt Examples</h1><h2 id="scene-from-image-1-character-from-image-2">Scene from Image 1, character from Image 2</h2><pre><code>Use the first image as the scene template and the second image as the
character template. Generate an edited result where the character matches
Image 2 and the scene remains faithful to Image 1.</code></pre><h2 id="general-two-reference-generation">General two-reference generation</h2><pre><code>Create a new anime illustration using both reference images. Preserve the
relevant visual information from Reference Image 1 and Reference Image 2 while
following this instruction: show the referenced character in a coherent new
composition with clean anime rendering and detailed eyes.</code></pre><h2 id="combine-character-information-from-both-images">Combine character information from both images</h2><pre><code>Create a new anime illustration that combines the character identity and
costume details shown across both reference images. Preserve the most
recognizable facial features, hairstyle, colors, and accessories while placing
the character in a new full-body composition.</code></pre><h2 id="keep-image-1-identity-and-use-image-2-for-costume">Keep Image 1 identity and use Image 2 for costume</h2><pre><code>Use Reference Image 1 for the character's face, hairstyle, and overall
identity. Use Reference Image 2 only for the costume and accessories. Create a
new full-body anime illustration in a different pose and environment.</code></pre>Be explicit about which image should control identity, costume, scene, pose, style, or other visual information.<hr /><h1 id="recommended-settings">Recommended Settings</h1>SettingRecommended valueResolution<code>256 × 256</code>Steps<code>40</code>CFG<code>1.0</code>Flow shift<code>5.0</code>Reference scale<code>1.0</code>Maximum area per reference<code>65,536</code> pixelsOrdered slot IDs<code>[0, 1]</code>Attention mode<code>torch</code>Offload mode<code>balanced</code>The checkpoint was trained and validated with 256-pixel-area buckets.Larger dimensions that are multiples of 16 are accepted by the current implementation, but they should be treated as experimental. Higher resolution does not guarantee better character consistency.<hr /><h1 id="memory-modes">Memory Modes</h1><h2 id="balanced"><code>balanced</code></h2>Keeps the DiT on the GPU and moves the text encoder and VAE to the GPU only during their respective phases.This is the recommended default.<h2 id="high_vram"><code>high_vram</code></h2>Keeps the DiT, text encoder, and VAE on the GPU for faster repeated generation.<h2 id="text_encoder_cpu"><code>text_encoder_cpu</code></h2>Runs text encoding on the CPU as a slower fallback when GPU memory is limited.The node maintains bounded caches for the runtime, prompt embeddings, and preprocessed reference latents. Changing a seed or sampling setting does not normally require reading the full checkpoint from disk again.<hr /><h1 id="current-limitations">Current Limitations</h1>This is an experimental research-preview release.<ul><li>Exactly two reference inputs are currently required.</li><li>Each reference input accepts one image only.</li><li>Reference slots are ordered but do not have automatically inferred roles.</li><li>The model may over-copy pose, framing, clothing, or background from a reference.</li><li>Fine facial features may drift between seeds.</li><li>Eye color, hair ornaments, and small accessories may change or disappear.</li><li>Clothing information from the two references may become mixed.</li><li>Complex backgrounds may leak into the generated result.</li><li>Extreme poses and camera angles may reduce identity consistency.</li><li>Multi-character inputs may cause identity mixing.</li><li>The trained and validated scale is based on 256-pixel-area buckets.</li><li>Larger outputs remain experimental.</li><li>Photorealistic identity transfer is outside the primary target domain.</li><li>Exact reconstruction of either reference is not guaranteed.</li><li>Arbitrary stock Anima or future Native Reference checkpoints are not automatically supported.</li></ul>Try multiple seeds and write explicit prompts when evaluating a reference pair.<hr /><h1 id="verified-integration">Verified Integration</h1>The packaged runtime was validated with the exact E180 release files on an NVIDIA RTX PRO 6000 Blackwell.Validation covered:<ul><li>loading the integrated E180 checkpoint;</li><li>loading the Anima text encoder and Qwen-Image VAE;</li><li>two-reference pure-noise generation;</li><li>ordered slots <code>[0, 1]</code>;</li><li>Native Reference V2 sequence and attention paths;</li><li>prompt and reference-latent caching;</li><li>repeated runtime reuse;</li><li>standard ComfyUI workflow validation;</li><li>local <code>/prompt</code> API execution;</li><li>generated-image saving;</li><li>Chinese and Japanese Unicode prompt preservation.</li></ul>For the held-out integration case, the ComfyUI output was pixel-identical to the accepted native command-line output when decoded to RGB pixels.These tests verify implementation and workflow parity. They are not a complete benchmark of character-reference quality.<hr /><h1 id="responsible-use">Responsible Use</h1>Only use reference images that you own or are authorized to use.Do not use this model to:<ul><li>impersonate real people;</li><li>misrepresent generated content as authentic evidence;</li><li>harass or defame individuals;</li><li>violate privacy or publicity rights;</li><li>reproduce private or sensitive imagery without permission;</li><li>infringe copyright or contractual restrictions;</li><li>create illegal or exploitative content.</li></ul>Users are responsible for applying suitable moderation, human review, and access controls in downstream applications.<hr /><h1 id="license">License</h1>The integrated model checkpoint, required Anima assets, and custom-node source code are distributed under separate terms.<ul><li>The E180 checkpoint remains subject to this model release's terms, the applicable upstream Anima terms, and any relevant third-party licenses.</li><li>The Qwen3 text encoder and Qwen-Image VAE remain subject to their upstream terms.</li><li>The ComfyUI custom node and included runtime source are covered by the licenses included in the GitHub repository.</li><li>A software license applying to inference code does not override the license governing the model checkpoint.</li></ul>Review the current Civitai version license, Hugging Face repository terms, and upstream Anima licenses before redistribution, derivative-model publication, public inference hosting, or commercial use.<hr /><h1 id="acknowledgements">Acknowledgements</h1>This project was made possible through the contributions of many developers, researchers, and testers.<ul><li>Yidhar and Nebulae contributed to model training and dataset development.</li><li>spawner provided important inspiration and portions of the code through the <a target="_blank" rel="ugc" href="https://github.com/akatsuki-neo/anima-edit">anima-edit</a> project.</li><li>potato contributed to the project's early development.</li><li>GHOSTLXH, 年糕特工队, 轻松, Free Will, and 韩小强 contributed testing, feedback, and early validation.</li></ul>We also thank CircleStone Labs and Comfy Org for the development and release of Anima, and the wider ComfyUI developer community for the inference framework and ecosystem.Special thanks to Comfy.org for providing GPU sponsorship.

NOOB2 Project-Character Reference Bypass Injector Research

This is the initial public research-preview release of Anima Native Reference V2 E180.Compared with a normal Anima workflow, this version adds an integrated Native Reference V2 path for prompt-controlled generation from two ordered reference images.What is included<ul><li>Integrated checkpoint: <code>anima-native-ref-v2-e180-step64080-256px.safetensors</code></li><li>Checkpoint step: <code>64,080</code></li><li>Two explicitly ordered reference inputs</li><li>Prompt-defined reference semantics</li><li>Pure-noise generation</li><li>Native Reference V2 sequence and attention paths</li><li>Standard ComfyUI workflow</li><li>Local <code>/prompt</code> API workflow</li><li>Balanced, high-VRAM, and CPU text-encoder modes</li><li>Runtime, prompt-embedding, and reference-latent caches</li><li>Checkpoint-layout validation</li><li>Optional release SHA-256 verification</li><li>Integration tests and validation reports</li></ul>Required custom nodeInstall the custom node before using this model:<a target="_blank" rel="ugc" href="https://github.com/HK416-TYPED/ComfyUI-Anima-Native-Reference">https://github.com/HK416-TYPED/ComfyUI-Anima-Native-Reference</a>Required filesIn addition to the E180 checkpoint downloaded from this version, you need:<pre><code>qwen_3_06b_base.safetensors
qwen_image_vae.safetensors</code></pre>Download them from the Anima repository:<a target="_blank" rel="ugc" href="https://huggingface.co/circlestone-labs/Anima">https://huggingface.co/circlestone-labs/Anima</a>Important usage noteThis is a complete integrated diffusion checkpoint, not a LoRA.Do not load an additional stock Anima diffusion checkpoint alongside it.No external LoRA, IP-Adapter, or separate reference-adapter weight file is required.Recommended starting settings<pre><code>Resolution: 256 × 256
Steps: 40
CFG: 1.0
Flow shift: 5.0
Reference scale: 1.0
Offload mode: balanced</code></pre>Larger output sizes are accepted when their dimensions are multiples of 16, but they remain experimental.Current statusThis version is intended as a research preview rather than a final production release. Please report reproducible problems through the GitHub repository and include your workflow, prompt, reference setup, hardware, and error log.

Files with SHA256: 1f970a7867dd7b65858d30b58135134ce84fd3b552ab27fc9f07e7f15209c6dd