Instructions to use Viggle/Viggle-Animate with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Diffusers
How to use Viggle/Viggle-Animate with Diffusers:
pip install -U diffusers transformers accelerate
import torch from diffusers import DiffusionPipeline # switch to "mps" for apple devices pipe = DiffusionPipeline.from_pretrained("Viggle/Viggle-Animate", dtype=torch.bfloat16, device_map="cuda") prompt = "Astronaut in a jungle, cold color palette, muted colors, detailed, 8k" image = pipe(prompt).images[0] - Notebooks
- Google Colab
- Kaggle
Comparing with vanilla H3 Ref2Video model?
Hi,
Thanks for the contribution to the community, could you also create comparisons between this model and vanilla H3 Ref2Video model?
Thanks.
you may find more discussion here. it works sometimes, but not stable.
An example I just ran on minimax H3-max https://fal.ai/models/minimax/h3-max/reference-to-video
https://fal.ai/models/minimax/h3-max/reference-to-video?share=99b9bc28-6de7-4d3e-bc33-814e550430a8
Another example I got before (with prompt enhancement on).
From my personal experience, it's far from satsifying, especially when I directly using the released ref2va ckpt
Good work, character transfer has been an issue with Minimax from the beginning as well as attention issues on background details like hands, mouth and feet etc.

Spotted some flaws, could be a mode limitation or prompt issue?
It seem to struggle with timing with face and hand detail in the video yycc provided:
- In many of the examples the face doesn't animate much compared to the reference or at all.
2.also notice in the example of yycc above the Viggle video does not turn his head to look at the camera like person does at 4 seconds and at 5 seconds it does not put the 2 fingers like the person does.
These are of importance to correct in the future to make it on par with SOTA models.
An example I just ran on minimax H3-max https://fal.ai/models/minimax/h3-max/reference-to-video
https://fal.ai/models/minimax/h3-max/reference-to-video?share=99b9bc28-6de7-4d3e-bc33-814e550430a8
Thanks for the evaluation, it's kinda obvious now original model sometimes drifts away from ref motion, the new fine-tuned model can better preserve the actions.