whatisgithub

What is hallo2?

fudan-generative-vision/hallo2 — explained in plain English

Analysis updated 2026-07-03

3,698PythonAudience · researcherComplexity · 5/5Setup · hard

In one sentence

A research tool that takes a single portrait photo and an audio clip and generates a realistic talking-head video up to 1 hour long at 4K resolution, with natural head motion and expressions.

Mindmap

mindmap
  root((hallo2))
    What it does
      Portrait to video
      Audio-driven animation
      4K resolution output
    Key Features
      Up to 1 hour long
      Stable identity
      Natural head motion
    Setup
      Linux and CUDA GPU
      conda and pip install
      HuggingFace weights
    Components
      Vocal separator
      Landmark detector
      Motion generator
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Animate a single portrait photo with an audio recording to produce a long, stable talking-head video for research demos.

USE CASE 2

Build on the pretrained models to study long-duration video generation techniques for facial animation.

USE CASE 3

Generate 4K talking-head videos from lectures or speeches using a single speaker image and the original audio.

What is it built with?

PythonPyTorchCUDAconda

How does it compare?

fudan-generative-vision/hallo2blinkdl/ai-writerabhitronix/vidgear
Stars3,6983,6983,697
LanguagePythonPythonPython
Setup difficultyhardmoderatemoderate
Complexity5/52/53/5
Audienceresearchergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires an A100-class GPU, CUDA 11.8, and downloading several large pretrained model weights from HuggingFace.

License terms are described in the repository but were not summarized in the explanation.

So what is it?

Hallo2 is a research tool from Fudan University that turns a still photo of a person into a talking-head video, driven by an audio recording. You provide one portrait image and one audio clip, and the system generates a video where the person appears to speak, with head movements and facial expressions that follow the rhythm and tone of the audio. The output can run at 4K resolution and stay consistent for videos up to an hour in length, which is longer than most similar tools manage before visual quality starts to drift. The project was accepted at ICLR 2025, a major international conference on machine learning research. The showcase on the project page includes examples like a Taylor Swift speech at NYU (23 minutes, 4K) and a Stanford lecture (up to 1 hour), all animated from a single portrait image. The system is designed to maintain stable identity, consistent lighting, and natural motion across those long durations without the face warping or flickering that earlier approaches tend to produce. Setting it up requires a Linux machine with a capable GPU. The documentation lists Ubuntu 20.04 or 22.04 and CUDA 11.8, and the testing was done on an A100 GPU. You install Python dependencies through conda and pip, then download a set of pretrained model weights from HuggingFace. There are several component models involved: one for separating vocals from audio, one for detecting and tracking facial landmarks, one for motion generation, and the core animation model itself. Once set up, you run inference by pointing the script at your portrait image and your audio file. The README includes example commands and links to a hosted demo on OpenBayes for trying the system without installing anything locally. This is a research release aimed at people who want to study or build on the underlying technique. It is not a polished consumer product, and getting it running requires familiarity with Python environments and GPU computing. The code and pretrained weights are publicly available under the terms described in the repository.

Copy-paste prompts

Prompt 1
I have a portrait image and an MP3 audio file. Write the exact hallo2 inference command to generate a 4K talking-head video from them.
Prompt 2
Show me how to set up the hallo2 conda environment on Ubuntu 22.04 with CUDA 11.8 and download all required HuggingFace model weights.
Prompt 3
Explain what each component model in hallo2 does, vocal separation, landmark detection, motion generation, and the animation model, in plain English.
Prompt 4
How do I run hallo2 inference on a GPU with less VRAM than an A100? What settings can I reduce to fit it on a 24GB card?

Frequently asked questions

What is hallo2?

A research tool that takes a single portrait photo and an audio clip and generates a realistic talking-head video up to 1 hour long at 4K resolution, with natural head motion and expressions.

What language is hallo2 written in?

Mainly Python. The stack also includes Python, PyTorch, CUDA.

What license does hallo2 use?

License terms are described in the repository but were not summarized in the explanation.

How hard is hallo2 to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is hallo2 for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.