animagine-xl-3.1
cagliostrolabopenrail++textvision

animagine-xl-3.1

Updated Nov 21, 2026
Parameters
2.6B
License
openrail++
Updated
Nov 21, 2026

Will it run on your hardware?

Pick your GPU memory - see which quantizations fit, and the cheapest card for the rest

Runs on your 24 GB - best at FP16
4 of 4 quantizations fit animagine-xl-3.1 with real runtime overhead.
Q4_K_M
2 GB
Q5_K_M
2 GB
Q8_0
3 GB
FP16
5 GB
fits tight too big

Need an exact figure for your context length? Use the VRAM calculator.

Run it locally

Copy-paste - running in under a minute

vLLMOpenAI-compatible API
vllm serve cagliostrolab/animagine-xl-3.1

New to this? Start with Ollama · serve to many users with vLLM.

Deep dive

Notes, sources, and the full write-up

animagine-xl-3.1 is an open-weight image generation model published by cagliostrolab on Hugging Face in March 2024, with 2.6B parameters under the openrail++ license. It is built on cagliostrolab/animagine-xl-3.0.

Among the 26 image generation models in this directory it ranks 16th by monthly Hugging Face downloads, and 13 of the others are larger.

HardwareLink to this section

Unquantized FP16 weights take about 5 GB; 8-bit brings that to ~3 GB and 4-bit (Q4_K_M) to ~2 GB, before activations and any context or image buffers. A 12 GB consumer card holds it at 4-bit; FP16 needs a 24 GB card such as an RTX 4090. Check exact numbers for your card with the VRAM calculator.

Similar image generation modelsLink to this section

PopularityLink to this section

animagine-xl-3.1 was downloaded 273,791 times on Hugging Face in the last month (7,646,710 all-time) and has 756 likes.

Run it locallyLink to this section

Weights and usage instructions are on the cagliostrolab/animagine-xl-3.1 model card; it loads with Hugging Face Diffusers (or ComfyUI).

Local runtimes that fit this model:

  • comfyui - node-based workflows, the usual way to run diffusion models locally
  • invokeai - a canvas UI for image generation and editing

From the community

What users are saying

“Yea I agree with you that AnimagineXL 3.1 is in fp16. If it was fp32 then it would be over 10GB. My problem is the diffusers library is dumb as hell and can't load variant="fp16" without the "fp16" being in the name.”

“Ohh great. However this error keeps popping up. Can you help with this @rit3776 gradioclient.exceptions.AppError: The upstream Gradio app has raised an exception but has not enabled verbose error reporting. To enable, set showerror=True in launch().”

“This error appears to me pls help Cloning repository to /content/animagine-xl Installing required Python libraries Done! The cache for model files in Transformers v4.22.0 has been updated. Migrating your old cache. This is a one-time only operation.”

Frequently asked

Quick answers to common questions

How much VRAM does animagine-xl-3.1 need?

animagine-xl-3.1 with 2.6B parameters needs approximately 2 GB at Q4_K_M quantization. Use our VRAM calculator for an exact estimate.

Is animagine-xl-3.1 better than other cagliostrolab models?

animagine-xl-3.1 has 2.6B parameters - a strong choice for image-generation.

What license is animagine-xl-3.1 under?

animagine-xl-3.1 is released under the openrail++ license, making it suitable for most commercial and personal projects.

What hardware runs animagine-xl-3.1 well?

With 2.6B parameters, animagine-xl-3.1 requires adequate VRAM. High-end GPUs like the RTX 4090 (24GB), RTX 5090 (32GB), or Mac Studio with unified memory are good options. Check our hardware directory for specific recommendations.

What is the best quantization for animagine-xl-3.1?

Q4_K_M is the recommended sweet spot - ~98% of FP16 quality at ~27% of the size. Q5_K_M (~2 GB) is an option if you have spare VRAM. Use our VRAM calculator to compare.

What models compete with animagine-xl-3.1?

animagine-xl-3.1 competes with other models in its class. Browse our model directory for comparisons, benchmarks, and community reviews to find the best fit.

Nearby options

Similar models and compatible hardware by spec