How to Install Anima-2.9B in ComfyUI for Anime Images

You can now install Anima-2.9B in ComfyUI 0.33.1 or newer without a custom compatibility node. The clean setup is to download the 5.84 GB diffusion model, reuse Anima’s Qwen-3 0.6B text encoder and Qwen-Image VAE, then adapt ComfyUI’s official Anima Base v1 workflow by selecting the 2.9B diffusion file.

This is a larger community derivative of CircleStone Labs’ 2B Anima model. It targets anime and non-photorealistic illustration, not realistic photography. It is also a preview under a non-commercial model licence, so read that restriction before building a paid service around it.

What changed in Anima-2.9B?

The original Anima diffusion model has 28 transformer layers and about 2 billion parameters. The Anima-2.9B author expanded that structure to 40 layers, then trained the additional layers on 1.7 million more anime and illustration samples. The model card gives a July 2026 knowledge cut-off.

That extra depth originally needed a custom ComfyUI node. ComfyUI 0.33.1, released on 13 August 2026, added native support for Anima fine-tunes with extra blocks. Updating ComfyUI removes the need for the creator’s compatibility node on updated installs.

Anima-2.9B is not a new official CircleStone checkpoint. It is a community fine-tune and architecture expansion that uses CircleStone’s licence. That distinction matters when you assess support, stability and commercial use.

What you need

• ComfyUI 0.33.1 or newer.
• About 7.3 GB for the three model files, plus generated images and temporary download space.
• A GPU supported by your current ComfyUI installation.
• The official Anima Base v1 workflow from ComfyUI’s Template Library, used as a starting template for the 2.9B diffusion file.

The 5.84 GB download size is not a minimum-VRAM figure. Inference also needs memory for the text encoder, VAE, latent tensors and ComfyUI itself. The model author does not publish a minimum GPU requirement, so avoid a guaranteed “runs on 8 GB” claim.

The repository also contains a roughly 3.08 GB Anima-2.9B-preview-v1_int8_convrot.safetensors file. Its model card does not document a complete quality, speed or compatibility comparison, so this guide starts with the full checkpoint. Treat the smaller file as an experimental alternative until its trade-offs are better documented.

Step 1: update ComfyUI to 0.33.1 or newer

Check the version in ComfyUI’s startup console or About information. If it is older than 0.33.1, update through the same supported method you used to install it. Windows Portable users should use the updater included with that package; Desktop users should use the application’s normal update path.

Restart ComfyUI after the update and confirm the version before adding the model. The relevant release note is “Support anima tunes with extra blocks.” If your installation cannot be updated, the creator’s current ComfyUI-Anima-2.9B compatibility node is the documented fallback; use only that official repository and avoid mirrors.

Step 2: download the three model components

Download files only from the two official Hugging Face repositories below.

If you already installed the original Anima workflow, you may already have both shared files. A Qwen-Image workflow may already provide qwen_image_vae.safetensors, but it generally uses a different text encoder. Compare the exact file names and keep a single valid copy rather than downloading duplicates.

Step 3: place each file in the correct folder

Your model directory should contain this layout:

ComfyUI/
└── models/
    ├── diffusion_models/
    │   └── Anima-2.9B-preview-v1.safetensors
    ├── text_encoders/
    │   └── qwen_3_06b_base.safetensors
    └── vae/
        └── qwen_image_vae.safetensors

Do not put the diffusion model in models/checkpoints. The official Anima workflow loads the separate diffusion, encoder and VAE components through standard ComfyUI nodes.

After copying the files, restart ComfyUI so its model lists are refreshed.

Step 4: adapt the official Anima Base v1 workflow

1. Open ComfyUI’s Template Library.
2. Search for Anima Base v1.
3. Open the text-to-image workflow.
4. Open its subgraph if the model selectors are not visible on the main canvas.
5. In the diffusion-model loader, select Anima-2.9B-preview-v1.safetensors.
6. Confirm the text encoder is qwen_3_06b_base.safetensors and the VAE is qwen_image_vae.safetensors.
7. If the workflow exposes a turbo_mode control, keep it turned off for Preview v1.

Comfy Org’s workflow uses the standard UNETLoader, CLIPLoader and VAELoader path. Starting from that template removes a lot of guesswork and makes custom-node conflicts easier to isolate.

Step 5: use a conservative first generation

Start with settings drawn from the creator’s documented ranges and sample workflows:

• Resolution: 832 × 1216
• Sampler: Euler
• Scheduler: SGM Uniform
• Steps: 30
• CFG: 4
• Batch size: 1

The model card recommends 28–50 steps, CFG 3.5–5 and several portrait or square resolutions. Do not begin at 1536 × 1536 if memory is uncertain; even the author labels that size “iffy.”

Use a detailed prompt that states the subject, pose, clothing, setting, lighting and composition. Anima understands tag-style prompts and natural language. Descriptive visual language is more reproducible than asking it to imitate a named living artist.

safe, 1girl, solo. An original anime character with short auburn hair and a navy raincoat stands at a tram stop at dusk. Wet pavement reflects warm shop lights, medium shot, balanced composition, clean line work, detailed background.

Queue one image and record the seed. Change one setting at a time so you can tell whether a different result came from the prompt, sampler, CFG or random seed.

Step 6: compare settings without losing the baseline

Once the first image works, duplicate the workflow or save it under a new name. The model author suggests two useful combinations:

• Euler + SGM Uniform: a balanced starting point for composition and detail.
• Res-Multistep + Linear Quadratic: spends more time at high-noise steps and may improve composition, but takes more experimentation.

Keep the seed and prompt fixed while comparing. Creator-provided sample images are useful for discovering settings, but they are not an independent quality benchmark.

Common Anima-2.9B problems

The model does not appear in the loader

Confirm that the full file finished downloading and is inside models/diffusion_models, not models/checkpoints. Restart ComfyUI after moving it. A partially downloaded file may have a browser-specific temporary extension and should not be loaded.

ComfyUI reports unsupported blocks or tensor shapes

Recheck the ComfyUI version. Native support for the expanded Anima blocks arrived in 0.33.1. Update and restart before changing the workflow. The model card mentions the creator’s compatibility node as a fallback, but it should not be necessary on a current installation.

The output is blank, noisy or fails in an old workflow

Load the official Anima template in a clean canvas and select the three model files again. The model author warns that some other custom nodes may not work with the expanded model. If the clean official workflow succeeds, reintroduce optional nodes one at a time.

The GPU runs out of memory

Reduce resolution, keep batch size at one, close other GPU-heavy applications and restart ComfyUI. Do not assume the checkpoint’s disk size equals its runtime memory requirement. The smaller int8 file exists, but its official documentation does not yet quantify the quality or compatibility trade-off.

Images look flat or the background is empty

Add concrete details about composition, environment and lighting. The creator says short prompts often produce simple backgrounds. Try 30–40 steps and compare CFG 3.5, 4 and 5 with the same seed rather than pushing CFG far outside the documented range.

Realistic faces or text look poor

That is a model limitation, not necessarily an installation error. The base Anima documentation says realism and lengthy text rendering are out of scope. Use a model designed for photography or add text later in an image editor.

Anima-2.9B FAQ

Do I need a custom node?

No, not with ComfyUI 0.33.1 or newer. That release added native support for Anima fine-tunes with extra blocks.

Is Anima-2.9B the official Anima successor?

No. It is a community fine-tune and layer expansion of CircleStone Labs’ Anima model. ComfyUI officially supports its expanded architecture, but that does not make the checkpoint a CircleStone release.

Can I use Anima-2.9B commercially?

The model card places the derivative weights under the CircleStone Labs Non-Commercial License. Commercial or production use is generally restricted apart from the licence’s narrow exceptions; paid hosting, API access and embedding the weights in a monetised product require a separate licence. The licence separately says generated outputs may be used commercially subject to its restrictions and notes inherited NVIDIA Open Model License terms where applicable. Review the current terms and obtain appropriate advice for your use case; do not infer permission from the availability of a public download.

Does it support image-to-image?

The current model card labels the release text-to-image, and this guide covers only that verified path. Do not advertise image-to-image, ControlNet or video support without a current compatible workflow and primary documentation.

Will it run on an 8 GB GPU?

There is no official minimum-VRAM figure for Preview v1. Resolution, attention implementation, encoder loading and other processes all affect memory, so test conservatively rather than treating 8 GB as guaranteed.

Can Comfy MCP control this workflow?

Once the plain workflow works reliably, you can automate it with my guide to control local ComfyUI with Comfy MCP. Keep the first test manual so an MCP configuration problem cannot be mistaken for a model problem.

Should you install Anima-2.9B?

Try Anima-2.9B if you already use ComfyUI, want a current anime and illustration model, and accept a preview checkpoint under a non-commercial licence. Update to ComfyUI 0.33.1, adapt the official Anima Base v1 template, keep turbo_mode off and begin with the full 5.84 GB model at 832 × 1216.

Stay with the official 2B Anima releases if you want more established documentation, smaller files or clearer support boundaries. Use a different model for photorealism, dependable text rendering or commercial model hosting. If you are comparing other local visual workflows, the MiniMax H3 ComfyUI guide covers video generation with native audio.

Primary sources

• Anima-2.9B Preview v1 model card and files
• ComfyUI 0.33.1 release notes
• ComfyUI expanded Anima-block support change
• Comfy Org Anima workflow documentation
• Original Anima model card, shared files and limitations