The activation switch. After this PR merges, MagiHuman is publicly
loadable via:
from fastvideo import VideoGenerator
gen = VideoGenerator.from_pretrained('FastVideo/MagiHuman-Diffusers/base')
Files:
- fastvideo/registry.py: 153 lines of register_configs/register_presets
calls covering all 4 variants x 2 modes (8 total entrypoints).
- examples/inference/basic/basic_magi_human{_,_ti2v,_distill,_distill_ti2v,
_sr540p,_sr540p_ti2v,_sr1080p,_sr1080p_ti2v}.py: 8 user-facing scripts.
- fastvideo/tests/ssim/test_magi_human_similarity.py: CI-eligible SSIM
regression test against the umbrella HF repo.
- .agents/memory/codebase-map/models/magi_human.md: codebase-map entry
(first per-model entry under the models/ subdir; sets the convention).
- fastvideo/pipelines/basic/magi_human/AGENTS.md: provenance section
finalized with all 8 PR numbers + the will/magi source SHA.
Verification:
- Existing tests on main: should still pass (no shared component changes
in this PR; the umbrella loader infra landed in PR-B / loader-infra).
- pre-commit run --all-files: clean.
- E2E smoke after activation: any of the 8 examples emits expected mp4
with hash dcf5f2bf6534c7c0d91e7353e42b23db on the base T2V variant.
Magi-Stack: 8/8
54 lines
1.9 KiB
Python
54 lines
1.9 KiB
Python
# SPDX-License-Identifier: Apache-2.0
|
|
"""Minimal user-runnable example for the daVinci-MagiHuman DMD-2 distilled
|
|
text-to-AV pipeline.
|
|
|
|
Same arch as the base model (`basic_magi_human.py`) but with DMD-2 distilled
|
|
weights: 8 denoising steps, no classifier-free guidance. ~4x faster than
|
|
base at the same 256x480 resolution. Mirrors upstream
|
|
`daVinci-MagiHuman/example/distill/run_T2V.sh`.
|
|
|
|
Prerequisites (one-off):
|
|
|
|
# 1) Accept terms on the gated HF repos with your HF_TOKEN:
|
|
# - https://huggingface.co/google/t5gemma-9b-9b-ul2
|
|
# - https://huggingface.co/stabilityai/stable-audio-open-1.0
|
|
# Cross-variant shared components (Wan 2.2 VAE + T5-Gemma + Stable
|
|
# Audio VAE) are lazy-loaded from their canonical upstream HF repos
|
|
# and shared with the base variant cache.
|
|
# 2) Convert the distill subfolder of GAIR/daVinci-MagiHuman:
|
|
python scripts/checkpoint_conversion/convert_magi_human_to_diffusers.py \\
|
|
--source GAIR/daVinci-MagiHuman \\
|
|
--subfolder distill \\
|
|
--output converted_weights/magi_human_distill \\
|
|
--cast-bf16
|
|
# `--cast-bf16` is recommended (61 GB fp32 -> 30 GB bf16); the FV pipeline
|
|
# loads bf16 anyway, and the conversion keeps norms / RoPE bands fp32.
|
|
"""
|
|
from fastvideo import VideoGenerator
|
|
|
|
|
|
PROMPT = (
|
|
"A warm afternoon scene: a person sits on a park bench reading a book, "
|
|
"surrounded by softly swaying trees."
|
|
)
|
|
|
|
|
|
def main() -> None:
|
|
generator = VideoGenerator.from_pretrained(
|
|
"FastVideo/MagiHuman-Diffusers/distill",
|
|
num_gpus=1,
|
|
)
|
|
output_path = "outputs_video/magi_human_basic/output_magi_human_distill.mp4"
|
|
generator.generate_video(
|
|
prompt=PROMPT,
|
|
output_path=output_path,
|
|
save_video=True,
|
|
# Defaults pulled from the registered preset (magi_human_distill):
|
|
# height=256, width=480, fps=25, num_inference_steps=8, cfg=1, seed=42.
|
|
)
|
|
generator.shutdown()
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|