Skip to content

Repository files navigation

4DAnyone

4DAnyone: Create Anyone in 4D from a Casual Monocular Video

Project Page  |  Paper

4DAnyone teaser

4DAnyone turns a casual monocular video into multi-view videos, enabling downstream 4DGS reconstruction.

News

  • 2026-08-28: Achieved a 1.42× end-to-end speedup for the complete 24-view generation pipeline.
  • 2026-08-28: Reduced peak GPU memory to 25.4 GiB while slightly improving speed. See Inference performance for details.

Installation

git clone https://github.com/ant-research/4DAnyone.git
cd 4DAnyone
git submodule update --init third_party/GVHMR

conda create -n 4danyone python=3.11 -y
conda activate 4danyone
pip install -r requirements.txt

Missing models and examples are downloaded automatically on first use. You can also download them manually:

python scripts/download_smplx.py
python scripts/download_model.py
python scripts/download_example.py

Inference

4DAnyone supports flexible target-view counts, pitch layers, and yaw coverage. Here are several common camera configurations:

6-View Full Orbit

A compact 360° layout for basic coverage. Start here for an initial test.

python inference.py \
    --video_path "data/source/pexels/2785536-uhd_2160_3840_25fps.mp4" \
    --views_per_layer 6

Six evenly spaced target cameras on one full orbit

24-View Full Orbit

A dense 360° layout with broad angular coverage, suitable for 4DGS reconstruction.

python inference.py \
    --video_path "data/source/pexels/2785536-uhd_2160_3840_25fps.mp4" \
    --views_per_layer 24

Twenty-four evenly spaced target cameras on one full orbit

48-View Full Orbit, Three Pitch Layers

This layout distributes views across three pitch rings for broader coverage, enabling free-viewpoint 4DGS rendering.

python inference.py \
    --video_path "data/source/pexels/2785536-uhd_2160_3840_25fps.mp4" \
    --views_per_layer 16 --layer_pitches '[-10,15,35]'

Forty-eight target cameras arranged over three pitch layers

24-View Frontal Arc, Two Pitch Layers

A two-layer layout for dense coverage across the frontal 180° arc.

python inference.py \
    --video_path "data/source/pexels/2785536-uhd_2160_3840_25fps.mp4" \
    --views_per_layer 12 --layer_pitches '[0,30]' --start_yaw -90 --yaw_span 180

Twenty-four target cameras distributed over two pitch layers along the frontal 180-degree arc

Key Arguments

Run python inference.py --help for the full list.

  • views_per_layer: number of evenly spaced views per pitch layer. It must be divisible by 4 or 6.
  • layer_pitches: pitch angles in degrees, one per layer. Positive values place cameras above the subject. Total views are views_per_layer × len(layer_pitches).
  • start_yaw: horizontal angle of the first view, in degrees. Yaw 0 is the front view.
  • yaw_span: horizontal range covered by each camera layer, in degrees.
  • gpu_ids: GPU IDs used for parallel pose/VAE view stages and target denoising. Defaults to all visible GPUs.

Output

With the default --data_dir data, results follow this layout. See the output documentation for the complete format.

data/
├── gvhmr/results/<clip>/          # reusable motion-recovery result
└── fdanyone/<clip>/
    ├── metadata.json              # run settings, timings, resources
    ├── cameras.json               # the final N-camera rig
    ├── skeletons/00.mp4 ... <N-1>.mp4
    └── videos/
        ├── sparse/{00,04,09,12,14,19}.mp4  # default 24-view RCP proposals
        └── dense/00.mp4 ... <N-1>.mp4       # generated target views

Inference Efficiency

For faster inference on supported GPUs, optionally install FlashAttention-3 or SageAttention. Runtime selection follows one fixed order: FlashAttention-3, SageAttention, then PyTorch SDPA.

See Inference performance for measured 6-view runtimes and peak GPU memory usage on H20-3E, H200, RTX 5880 Ada, and RTX A6000 GPUs.

Custom Data

Use an input video that:

  • is 720p or higher, with 1080p recommended.
  • uses a 9:16 portrait aspect ratio.
  • shows one person in a full-body or upper-body shot.
  • has at least 121 frames.
  • contains only mild camera motion.

3DGS Reconstruction

See the nerfstudio guide for details.

Roadmap

Peak Memory Optimization

  • Reduce peak GPU memory below 32 GB through pose precomputation and memory-efficient operators.

Inference Acceleration

  • Achieve up to 1.42× end-to-end speedup by parallelizing pose encoding and VAE processing across GPUs.
  • Integrate Sol-Engine (expected 2× speedup).
  • Distill the model for few-step inference (expected 5× speedup).

Reconstruction

  • Support 3DGS reconstruction with nerfstudio.
  • Support 4DGS reconstruction with an open-source method.

Citation

If you find 4DAnyone useful or interesting, please cite our work and consider giving the repository a star ⭐:

@article{jin2026fdanyone,
  title={4DAnyone: Create Anyone in 4D from a Casual Monocular Video},
  author={Jin, Yudong and Xie, Tao and Zhang, Qihang and Shen, Zehong and Xu, Zhen and Shen, Yujun and Bao, Hujun and Zhou, Xiaowei and Xu, Yinghao},
  journal={arXiv preprint arXiv:2608.20335},
  year={2026},
  url={https://arxiv.org/abs/2608.20335}
}

About

[SIGGRAPH Asia 2026] 4DAnyone: Create Anyone in 4D from a Casual Monocular Video

Topics

Resources

Stars

1.1k stars

Watchers

11 watching

Forks

Releases

Contributors

Languages