Papers › Hallo3: Highly Dynamic and Realistic Portrait Image Animation with Video Diffusion Transformer

Hallo3: Highly Dynamic and Realistic Portrait Image Animation with Video Diffusion Transformer

1 Dec 2024CVPR 2025 1arXiv:2412.00733archive 2025-07-28

Jiahao Cui, Hui Li, Yun Zhan, Hanlin Shang, Kaihui Cheng, Yuqi Ma, Shan Mu, Hang Zhou, Jingdong Wang, Siyu Zhu

Existing methodologies for animating portrait images face significant challenges, particularly in handling non-frontal perspectives, rendering dynamic objects around the portrait, and generating immersive, realistic backgrounds. In this paper, we introduce the first application of a pretrained transformer-based video generative model that demonstrates strong generalization capabilities and generates highly dynamic, realistic videos for portrait animation, effectively addressing these challenges. The adoption of a new video backbone model makes previous U-Net-based methods for identity maintenance, audio conditioning, and video extrapolation inapplicable. To address this limitation, we design an identity reference network consisting of a causal 3D VAE combined with a stacked series of transformer layers, ensuring consistent facial identity across video sequences. Additionally, we investigate various speech audio conditioning and motion frame mechanisms to enable the generation of continuous video driven by speech audio. Our method is validated through experiments on benchmark and newly proposed wild datasets, demonstrating substantial improvements over prior methods in generating realistic portraits characterized by diverse orientations within dynamic and immersive scenes. Further visualizations and the source code are available at: https://fudan-generative-vision.github.io/hallo3/.

PaperPDFConference PDFCodeCode Syntology ran

In Syntology Open this paper in Syntology's Atlas, the map of the papers in Syntology's graph and their citations.

For agents, Syntology's MCP tool lists every function and class Syntology harvested from this paper and whether it ran (how to connect): get_harvested_code_for_paper(arxiv_id="2412.00733")

Code

Syntology Ran 6 of 23 code samples harvested from 1 repository linked to this paper; 17 have no recorded run. Of those that ran: 1 ran · honoured contract; 3 ran · violated contract; 2 ran · our draft was wrong.

By repository: official repository: 23 samples from 1 repository, 6 ran. The run record, sample by sample. “Ran” means executed on a synthesized input, not that the code is correct or reproduces the paper.

fudan-generative-vision/hallo3 officialmentioned in papermentioned on GitHubpytorchMIT report

Repository list and official/mentioned flags are the archive's, frozen 2025-07-28. Reachability, where shown, is from one Syntology probe window (2026-09-16 to 2026-09-18); repositories not probed show nothing. GitHub stars are not tracked.

Code Syntology ran Syntology

23 samples harvested; 6 ran; 1 honoured the contract we drafted; 17 have no recorded run. Read from Syntology's graph 2026-09-24; that is when this build read the record, not when the samples ran.

1ran · honoured contract
3ran · violated contract
2ran · our draft was wrong
17unverified

Licence: 0 of the 23 samples are pointer only, meaning Syntology does not serve that copy's text. This page shows no code text for any sample; each one links to its file in the repository.

Harvested from fudan-generative-vision/hallo3. “Ran” means the sample executed on a synthesized input. It does not mean the output is correct, and nothing here reproduces the paper's results. “Honoured” and “violated” refer to a contract Syntology drafted from the code itself; “our draft was wrong” and “fixture could not drive it” are failures of Syntology's instrument, not of the code.

Each sample ends with its code_sha256, Syntology's identity for that exact code. An agent fetches the stored sample with Syntology's MCP tool get_code(code_sha256="…") (how to connect); click an identity to copy that call.

Repository labels, per sample. official repository: The archive marks this repository official for the paper. named in the paper: The archive records that the paper mentions this repository; it is not marked official. community (archive-listed): In the archive's code links for this paper, not marked official and not recorded as mentioned in the paper. found in paper text by Syntology: Syntology found this repository in the paper's own text; whether it is the authors' implementation is not asserted. community: Not in the archive's code links for this paper; a community repository Syntology harvested. Samples from a repository marked official are listed first. Licence labels name the repository's licence as recorded at harvest. “Pointer only” means Syntology does not serve that copy's text, for one of four reasons: no licence file was found; the licence was not identified; the licence is recorded as permissive but that copy's record is not marked cleared; or the licence is outside the permissive list Syntology serves text under (MIT, Apache-2.0, BSD and similar). Some licences outside that list permit redistribution, such as WTFPL, and GPL-3.0 under its conditions; they are simply not on the list. Hover a licence label for the reason. File links open the file on GitHub at the default branch, which may have changed since the harvest.

cast_tuple fudan-generative-vision/hallo3/hallo3/vae_modules/cp_enc_dec.py official repository ran · honoured contract fingerprinted MIT (permissive) · c1b68cdd9e73316a · report
default fudan-generative-vision/hallo3/hallo3/vae_modules/attention.py official repository ran · violated contract MIT (permissive) · 424012cb37b31172 · report
divisible_by fudan-generative-vision/hallo3/hallo3/vae_modules/cp_enc_dec.py official repository ran · violated contract fingerprinted MIT (permissive) · f912c209e9c899ca · report
exists fudan-generative-vision/hallo3/hallo3/vae_modules/attention.py official repository ran · violated contract MIT (permissive) · aa5486a3650902d8 · report
get_unique_embedder_keys_from_conditioner fudan-generative-vision/hallo3/hallo3/sample_video.py official repository ran · our draft was wrong MIT (permissive) · da7df331dab819db · report
uniq fudan-generative-vision/hallo3/hallo3/vae_modules/attention.py official repository ran · our draft was wrong MIT (permissive) · 9a299fe5ae09e407 · report
add_model_config_args fudan-generative-vision/hallo3/hallo3/arguments.py official repository unverified MIT (permissive) · ed0fa4fe4bafc350 · report
add_others_config_args fudan-generative-vision/hallo3/hallo3/arguments.py official repository unverified MIT (permissive) · 30f3a95756b04c98 · report
add_sampling_config_args fudan-generative-vision/hallo3/hallo3/arguments.py official repository unverified MIT (permissive) · 0e6cd4a28c32de69 · report
collect_video_folder_paths fudan-generative-vision/hallo3/hallo3/extract_meta_info.py official repository unverified MIT (permissive) · 317239190c059383 · report
construct_meta_info fudan-generative-vision/hallo3/hallo3/extract_meta_info.py official repository unverified MIT (permissive) · 3ec64495f4523050 · report
get_2d_sincos_pos_embed fudan-generative-vision/hallo3/hallo3/dit_video_concat.py official repository unverified MIT (permissive) · cdd29f549144d05e · report
get_2d_sincos_pos_embed_from_grid fudan-generative-vision/hallo3/hallo3/ref_dit_video_concat.py official repository unverified MIT (permissive) · 665d8a4e8f673a4c · report
get_3d_sincos_pos_embed fudan-generative-vision/hallo3/hallo3/dit_video_concat.py official repository unverified MIT (permissive) · 7759e9a501ea471a · report
get_batch fudan-generative-vision/hallo3/hallo3/sample_video.py official repository unverified MIT (permissive) · 4f7e73ff9945218a · report
get_video_paths fudan-generative-vision/hallo3/hallo3/data_preprocess.py official repository unverified MIT (permissive) · b5476e28d6f53521 · report
is_odd fudan-generative-vision/hallo3/hallo3/vae_modules/cp_enc_dec.py official repository unverified MIT (permissive) · 945442cc2f6a19c9 · report
read_video fudan-generative-vision/hallo3/hallo3/data_video.py official repository unverified MIT (permissive) · ea5ba6b6fc22be49 · report
resize_for_rectangle_crop fudan-generative-vision/hallo3/hallo3/data_video.py official repository unverified MIT (permissive) · e0dd6c8c26886b58 · report
resize_for_rectangle_crop fudan-generative-vision/hallo3/hallo3/sample_video.py official repository unverified MIT (permissive) · 5f69a5d32b43f9a1 · report
resize_for_square_padding fudan-generative-vision/hallo3/hallo3/data_video.py official repository unverified MIT (permissive) · 2482e2916bac95cf · report
setup_directories fudan-generative-vision/hallo3/hallo3/data_preprocess.py official repository unverified MIT (permissive) · 91eee6d5c860d74a · report
zero_module fudan-generative-vision/hallo3/hallo3/dit_video_concat.py official repository unverified MIT (permissive) · da94debb8019ad46 · report

Tasks

Image AnimationPortrait Animation

Results from the paper archive 2025-07-28

No leaderboard rows for this paper in the archive.

Report a problem or propose a change · a person checks every report against the paper or source before anything changes; decisions are listed on /corrections