Views
No views yet

[2026.03.08] 👋 Helios now fully supports Group Offloading and Context Parallelism! These features significantly optimize VRAM (only ~6GB) usage and enable inference across multiple GPUs with Ulysses Attention, Ring Attention, Unified Attention, and Ulysses Anything Attention.[2026.03.06] 🚀 Cache-DiT now supports Helios, it offers Fully Cache Acceleration and Parallelism support for Helios! Special thanks to the Cache-DiT Team for their amazing work.[2026.03.06] 🚀 We fix the Parallel Inference logits for Helios, and provide an example here. Thanks Cache-DiT Team.[2026.03.06] 👋 We official release the Gradio Demo, welcome to try it.[2026.03.05] 👋 We are excited to announce the release of the Helios technical report on arXiv. We welcome discussions and feedback![2026.03.04] 🚀 Day-0 support for Ascend-NPU,with sincere gratitude to the Ascend Team for their support.[2026.03.04] 🚀 Day-0 support for Diffusers,with special thanks to the HuggingFace Team for their support.[2026.03.04] 🚀 Day-0 support for SGLang-Diffusion,with huge thanks to the SGLang Team for their support.[2026.03.04] 🚀 Day-0 support for vLLM-Omni,with heartfelt gratitude to the vLLM Team for their support.[2026.03.04] 🔥 We've released the training/inference code and weights of Helios-Base, Helios-Mid and Helios-Distilled.| Models | Download Link | Supports | Notes |
|---|---|---|---|
| Helios-Base | 🤗 Huggingface 🤖 ModelScope | T2V ✅ I2V ✅ V2V ✅ Interactive ✅ | Best Quality, with v-prediction, standard CFG and custom HeliosScheduler. |
| Helios-Mid | 🤗 Huggingface 🤖 ModelScope | T2V ✅ I2V ✅ V2V ✅ Interactive ✅ | Intermediate Ckpt, with v-prediction, CFG-Zero* and custom HeliosScheduler. |
| Helios-Distilled | 🤗 Huggingface 🤖 ModelScope | T2V ✅ I2V ✅ V2V ✅ Interactive ✅ | Best Efficiency, with x0-prediction and custom HeliosDMDScheduler. |
💡Note:
- All three models share the same architecture, but Helios-Mid and Helios-Distilled use a more aggressive multi-scale sampling pipeline to achieve better efficiency.
- Helios-Mid is an intermediate checkpoint generated in the process of distilling Helios-Base into Helios-Distilled, and may not meet expected quality.
- For Image-to-Video or Video-to-Video, since training is based on Text-to-Video, these two functions may be slightly inferior to Text-to-Video. You may enable
is_skip_first_chunkif you find the first few chunks are static or imporve the value ofimage_noise_sigma_min,image_noise_sigma_max,video_noise_sigma_min, andvideo_noise_sigma_max.
1pip install "huggingface_hub[cli]"
2huggingface-cli download BestWishYSH/Helios-Base --local-dir BestWishYSH/Helios-Base
3huggingface-cli download BestWishYSH/Helios-Mid --local-dir BestWishYSH/Helios-Mid
4huggingface-cli download BestWishYSH/Helios-Distilled --local-dir BestWishYSH/Helios-Distilled1pip install modelscope
2modelscope download BestWishYSH/Helios-Base --local_dir BestWishYSH/Helios-Base
3modelscope download BestWishYSH/Helios-Mid --local_dir BestWishYSH/Helios-Mid
4modelscope download BestWishYSH/Helios-Distilled --local_dir BestWishYSH/Helios-Distillednum_frames should be set to a multiple of 33. If a non-multiple value is provided, it will be automatically rounded up to the nearest multiple of 33.| num_frames | Adjusted Frames | 24 FPS | 16 FPS |
|---|---|---|---|
| 1449 | 1452 (33×44) | ~60s (1min) | ~90s (1min 30s) |
| 720 | 726 (33×22) | ~30s | ~45s |
| 240 | 264 (33×8) | ~11s | ~16s |
| 129 | 132 (33×4) | ~5.5s | ~8s |
| Task | Helios-Base | Helios-Mid | Helios-Distilled |
|---|---|---|---|
| T2V | |||
| V2V |
~6GB of VRAM.1CUDA_VISIBLE_DEVICES=0 python infer_helios.py \
2 --base_model_path "BestWishYsh/Helios-Distilled" \
3 --transformer_path "BestWishYsh/Helios-Distilled" \
4 --sample_type "t2v" \
5 --prompt "A vibrant tropical fish swimming gracefully among colorful coral reefs in a clear, turquoise ocean. The fish has bright blue and yellow scales with a small, distinctive orange spot on its side, its fins moving fluidly. The coral reefs are alive with a variety of marine life, including small schools of colorful fish and sea turtles gliding by. The water is crystal clear, allowing for a view of the sandy ocean floor below. The reef itself is adorned with a mix of hard and soft corals in shades of red, orange, and green. The photo captures the fish from a slightly elevated angle, emphasizing its lively movements and the vivid colors of its surroundings. A close-up shot with dynamic movement." \
6 --num_frames 240 \
7 --guidance_scale 1.0 \
8 --is_enable_stage2 \
9 --pyramid_num_inference_steps_list 2 2 2 \
10 --is_amplify_first_chunk \
11 --output_folder "./output_helios/helios-distilled" \
12 --enable_low_vram_mode \
13 --group_offloading_type "leaf_level"Ulysses Attention, Ring Attention, Unified Attention, and Ulysses Anything Attention. For more details, please refer to the documentation.1CUDA_VISIBLE_DEVICES=0,1,2,3 torchrun --nproc_per_node 4 infer_helios.py \
2 --enable_parallelism \ # remember to enable this config
3 --cp_backend "ulysses" \ # ["ring", "ulysses", "unified", "ulysses_anything"]
4 --base_model_path "BestWishYsh/Helios-Base" \
5 --transformer_path "BestWishYsh/Helios-Base" \
6 --sample_type "t2v" \
7 --num_frames 99 \
8 --fps 24 \
9 --prompt "A vibrant tropical fish swimming gracefully among colorful coral reefs in a clear, turquoise ocean. The fish has bright blue and yellow scales with a small, distinctive orange spot on its side, its fins moving fluidly. The coral reefs are alive with a variety of marine life, including small schools of colorful fish and sea turtles gliding by. The water is crystal clear, allowing for a view of the sandy ocean floor below. The reef itself is adorned with a mix of hard and soft corals in shades of red, orange, and green. The photo captures the fish from a slightly elevated angle, emphasizing its lively movements and the vivid colors of its surroundings. A close-up shot with dynamic movement." \
10 --guidance_scale 5.0 \
11 --output_folder "./output_helios/helios-base"pip install git+https://github.com/huggingface/diffusers.git1import torch
2from diffusers import AutoModel, HeliosPyramidPipeline
3from diffusers.utils import export_to_video, load_video, load_image
4
5vae = AutoModel.from_pretrained("BestWishYsh/Helios-Distilled", subfolder="vae", torch_dtype=torch.float32)
6
7pipeline = HeliosPyramidPipeline.from_pretrained(
8 "BestWishYsh/Helios-Distilled",
9 vae=vae,
10 torch_dtype=torch.bfloat16
11)
12pipeline.to("cuda")
13
14negative_prompt = """
15Bright tones, overexposed, static, blurred details, subtitles, style, works, paintings, images, static, overall gray, worst quality,
16low quality, JPEG compression residue, ugly, incomplete, extra fingers, poorly drawn hands, poorly drawn faces, deformed, disfigured,
17misshapen limbs, fused fingers, still picture, messy background, three legs, many people in the background, walking backwards
18"""
19
20# --- T2V ---
21prompt = """
22A vibrant tropical fish swimming gracefully among colorful coral reefs in a clear, turquoise ocean. The fish has bright blue
23and yellow scales with a small, distinctive orange spot on its side, its fins moving fluidly. The coral reefs are alive with
24a variety of marine life, including small schools of colorful fish and sea turtles gliding by. The water is crystal clear,
25allowing for a view of the sandy ocean floor below. The reef itself is adorned with a mix of hard and soft corals in shades
26of red, orange, and green. The photo captures the fish from a slightly elevated angle, emphasizing its lively movements and
27the vivid colors of its surroundings. A close-up shot with dynamic movement.
28"""
29
30output = pipeline(
31 prompt=prompt,
32 negative_prompt=negative_prompt,
33 num_frames=240,
34 pyramid_num_inference_steps_list=[2, 2, 2],
35 guidance_scale=1.0,
36 is_amplify_first_chunk=True,
37 generator=torch.Generator("cuda").manual_seed(42),
38).frames[0]
39export_to_video(output, "helios_distilled_t2v_output.mp4", fps=24)
40
41# --- I2V ---
42i2v_prompt = """
43A towering emerald wave surges forward, its crest curling with raw power and energy. Sunlight glints off the translucent water,
44illuminating the intricate textures and deep green hues within the wave’s body. A thick spray erupts from the breaking crest,
45casting a misty veil that dances above the churning surface. As the perspective widens, the immense scale of the wave becomes
46apparent, revealing the restless expanse of the ocean stretching beyond. The scene captures the ocean’s untamed beauty and
47relentless force, with every droplet and ripple shimmering in the light. The dynamic motion and vivid colors evoke both awe and
48respect for nature’s might.
49"""
50image_path = "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/diffusers/helios/wave.jpg"
51
52output = pipeline(
53 prompt=i2v_prompt,
54 negative_prompt=negative_prompt,
55 image=load_image(image_path).resize((640, 384)),
56 num_frames=240,
57 pyramid_num_inference_steps_list=[2, 2, 2],
58 guidance_scale=1.0,
59 is_amplify_first_chunk=True,
60 generator=torch.Generator("cuda").manual_seed(42),
61).frames[0]
62export_to_video(output, "helios_distilled_i2v_output.mp4", fps=24)
63
64# --- V2V ---
65v2v_prompt = """
66A bright yellow Lamborghini Huracn Tecnica speeds along a curving mountain road, surrounded by lush green trees
67under a partly cloudy sky. The car's sleek design and vibrant color stand out against the natural backdrop,
68emphasizing its dynamic movement. The road curves gently, with a guardrail visible on one side, adding depth to
69the scene. The motion blur captures the sense of speed and energy, creating a thrilling and exhilarating atmosphere.
70A front-facing shot from a slightly elevated angle, highlighting the car's aggressive stance and the surrounding greenery.
71"""
72video_path = "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/diffusers/helios/car.mp4"
73
74output = pipeline(
75 prompt=v2v_prompt,
76 negative_prompt=negative_prompt,
77 video=load_video(video_path),
78 num_frames=240,
79 pyramid_num_inference_steps_list=[2, 2, 2],
80 guidance_scale=1.0,
81 is_amplify_first_chunk=True,
82 generator=torch.Generator("cuda").manual_seed(42),
83).frames[0]
84export_to_video(output, "helios_distilled_v2v_output.mp4", fps=24)1import torch
2from diffusers import ModularPipeline, ClassifierFreeGuidance
3from diffusers.utils import export_to_video, load_image, load_video
4
5mod_pipe = ModularPipeline.from_pretrained("BestWishYsh/Helios-Distilled")
6mod_pipe.load_components(torch_dtype=torch.bfloat16)
7mod_pipe.to("cuda")
8
9# we need to upload guider to the model repo, so each checkpoint will be able to config their guidance differently
10guider = ClassifierFreeGuidance(guidance_scale=1.0)
11mod_pipe.update_components(guider=guider)
12
13# --- T2V ---
14print("=== T2V ===")
15prompt = (
16 "A vibrant tropical fish swimming gracefully among colorful coral reefs in a clear, turquoise ocean. "
17 "The fish has bright blue and yellow scales with a small, distinctive orange spot on its side, its fins moving "
18 "fluidly. The coral reefs are alive with a variety of marine life, including small schools of colorful fish and "
19 "sea turtles gliding by. The water is crystal clear, allowing for a view of the sandy ocean floor below. The reef "
20 "itself is adorned with a mix of hard and soft corals in shades of red, orange, and green. The photo captures "
21 "the fish from a slightly elevated angle, emphasizing its lively movements and the vivid colors of its surroundings. "
22 "A close-up shot with dynamic movement."
23)
24
25output = mod_pipe(
26 prompt=prompt,
27 height=384,
28 width=640,
29 num_frames=240,
30 pyramid_num_inference_steps_list=[2, 2, 2],
31 is_amplify_first_chunk=True,
32 generator=torch.Generator("cuda").manual_seed(42),
33 output="videos",
34)
35
36export_to_video(output[0], "helios_distilled_modular_t2v_output.mp4", fps=24)
37print(f"T2V max memory: {torch.cuda.max_memory_allocated() / 1024**3:.3f} GB")
38torch.cuda.empty_cache()
39torch.cuda.reset_peak_memory_stats()
40
41# --- I2V ---
42print("=== I2V ===")
43image = load_image(
44 "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/diffusers/helios/wave.jpg"
45)
46i2v_prompt = (
47 "A towering emerald wave surges forward, its crest curling with raw power and energy. "
48 "Sunlight glints off the translucent water, illuminating the intricate textures and deep green hues within the wave's body."
49)
50
51output = mod_pipe(
52 prompt=i2v_prompt,
53 image=image,
54 height=384,
55 width=640,
56 num_frames=240,
57 pyramid_num_inference_steps_list=[2, 2, 2],
58 is_amplify_first_chunk=True,
59 generator=torch.Generator("cuda").manual_seed(42),
60 output="videos",
61)
62
63export_to_video(output[0], "helios_distilled_modular_i2v_output.mp4", fps=24)
64print(f"I2V max memory: {torch.cuda.max_memory_allocated() / 1024**3:.3f} GB")
65torch.cuda.empty_cache()
66torch.cuda.reset_peak_memory_stats()
67
68# --- V2V ---
69print("=== V2V ===")
70video = load_video(
71 "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/diffusers/helios/car.mp4"
72)
73v2v_prompt = (
74 "A dynamic time-lapse video showing the rapidly moving scenery from the window of a speeding train. "
75 "The camera captures various elements such as lush green fields, towering trees, quaint countryside houses, "
76 "and distant mountain ranges passing by quickly."
77)
78
79output = mod_pipe(
80 prompt=v2v_prompt,
81 video=video,
82 height=384,
83 width=640,
84 num_frames=240,
85 pyramid_num_inference_steps_list=[2, 2, 2],
86 is_amplify_first_chunk=True,
87 generator=torch.Generator("cuda").manual_seed(42),
88 output="videos",
89)
90
91export_to_video(output[0], "helios_distilled_modular_v2v_output.mp4", fps=24)
92print(f"V2V max memory: {torch.cuda.max_memory_allocated() / 1024**3:.3f} GB")pip install git+https://github.com/vllm-project/vllm-omni.git1cd vllm-omni
2
3# Helios-Base
4python3 examples/offline_inference/helios/end2end.py \
5 --sample-type t2v \
6 --model ./Helios-Base \
7 --prompt "A vibrant tropical fish swimming gracefully among colorful coral reefs in a clear, turquoise ocean. The fish has bright blue and yellow scales with a small, distinctive orange spot on its side, its fins moving fluidly. The coral reefs are alive with a variety of marine life, including small schools of colorful fish and sea turtles gliding by. The water is crystal clear, allowing for a view of the sandy ocean floor below. The reef itself is adorned with a mix of hard and soft corals in shades of red, orange, and green. The photo captures the fish from a slightly elevated angle, emphasizing its lively movements and the vivid colors of its surroundings. A close-up shot with dynamic movement." \
8 --num-frames 99 \
9 --seed 42 \
10 --output helios_t2v_base.mp4
11
12# Helios-Mid
13python examples/offline_inference/helios/end2end.py \
14 --model ./Helios-Mid --sample-type t2v \
15 --prompt "A vibrant tropical fish swimming gracefully among colorful coral reefs in a clear, turquoise ocean. The fish has bright blue and yellow scales with a small, distinctive orange spot on its side, its fins moving fluidly. The coral reefs are alive with a variety of marine life, including small schools of colorful fish and sea turtles gliding by. The water is crystal clear, allowing for a view of the sandy ocean floor below. The reef itself is adorned with a mix of hard and soft corals in shades of red, orange, and green. The photo captures the fish from a slightly elevated angle, emphasizing its lively movements and the vivid colors of its surroundings. A close-up shot with dynamic movement." \
16 --guidance-scale 5.0 --is-enable-stage2 \
17 --pyramid-num-inference-steps-list 20 20 20 \
18 --num-frames 99 \
19 --use-cfg-zero-star --use-zero-init --zero-steps 1 \
20 --output helios_t2v_mid.mp4
21
22# Helios-Distilled
23python examples/offline_inference/helios/end2end.py \
24 --model ./Helios-Distilled --sample-type t2v \
25 --prompt "A vibrant tropical fish swimming gracefully among colorful coral reefs in a clear, turquoise ocean. The fish has bright blue and yellow scales with a small, distinctive orange spot on its side, its fins moving fluidly. The coral reefs are alive with a variety of marine life, including small schools of colorful fish and sea turtles gliding by. The water is crystal clear, allowing for a view of the sandy ocean floor below. The reef itself is adorned with a mix of hard and soft corals in shades of red, orange, and green. The photo captures the fish from a slightly elevated angle, emphasizing its lively movements and the vivid colors of its surroundings. A close-up shot with dynamic movement." \
26 --num-frames 240 --guidance-scale 1.0 --is-enable-stage2 \
27 --pyramid-num-inference-steps-list 2 2 2 \
28 --is-amplify-first-chunk --output helios_t2v_distilled.mp4pip install git+https://github.com/sgl-project/sglang.git1sglang generate \
2 --model-path BestWishYsh/Helios-Base \
3 --prompt "A vibrant tropical fish swimming gracefully among colorful coral reefs in a clear, turquoise ocean. The fish has bright blue and yellow scales with a small, distinctive orange spot on its side, its fins moving fluidly. The coral reefs are alive with a variety of marine life, including small schools of colorful fish and sea turtles gliding by. The water is crystal clear, allowing for a view of the sandy ocean floor below. The reef itself is adorned with a mix of hard and soft corals in shades of red, orange, and green. The photo captures the fish from a slightly elevated angle, emphasizing its lively movements and the vivid colors of its surroundings. A close-up shot with dynamic movement." \
4 --negative-prompt "Bright tones, overexposed, static, blurred details, subtitles, style, works, paintings, images, static, overall gray, worst quality, low quality, JPEG compression residue, ugly, incomplete, extra fingers, poorly drawn hands, poorly drawn faces, deformed, disfigured, misshapen limbs, fused fingers, still picture, messy background, three legs, many people in the background, walking backwards" \
5 --height 384 \
6 --width 640 \
7 --num-frames 99 \
8 --num-inference-steps 50 \
9 --guidance-scale 5.01sglang generate \
2 --model-path BestWishYsh/Helios-Base \
3 --prompt "A vibrant tropical fish swimming gracefully among colorful coral reefs in a clear, turquoise ocean. The fish has bright blue and yellow scales with a small, distinctive orange spot on its side, its fins moving fluidly. The coral reefs are alive with a variety of marine life, including small schools of colorful fish and sea turtles gliding by. The water is crystal clear, allowing for a view of the sandy ocean floor below. The reef itself is adorned with a mix of hard and soft corals in shades of red, orange, and green. The photo captures the fish from a slightly elevated angle, emphasizing its lively movements and the vivid colors of its surroundings. A close-up shot with dynamic movement." \
4 --negative-prompt "Bright tones, overexposed, static, blurred details, subtitles, style, works, paintings, images, static, overall gray, worst quality, low quality, JPEG compression residue, ugly, incomplete, extra fingers, poorly drawn hands, poorly drawn faces, deformed, disfigured, misshapen limbs, fused fingers, still picture, messy background, three legs, many people in the background, walking backwards" \
5 --height 384 \
6 --width 640 \
7 --num-frames 99 \
8 --num-inference-steps 50 \
9 --guidance-scale 5.0 \
10 --backend diffusers1@article{helios,
2 title={Helios: Real Real-Time Long Video Generation Model},
3 author={Yuan, Shenghai and Yin, Yuanyang and Li, Zongjian and Huang, Xinwei and Yang, Xiao and Yuan, Li},
4 journal={arXiv preprint arXiv:2603.04379},
5 year={2026}
6}