24GB 显存跑通 HunyuanVideo-Avatar说话人视频生成上手指南【免费下载链接】HunyuanVideo-Avatar项目地址: https://gitcode.com/gh_mirrors/hu/HunyuanVideo-Avatar音频驱动的人像动画模型丢一张人物图加一段音频产出带口型、可多角色的说话视频面向做数字人、直播和短视频内容的开发者。跑通前你需要什么项目标准GPUNVIDIA 卡 CUDA 11.8 或 12.4最低 24GB 显存官方推荐 96GB系统Linux环境conda Python 3.10.9 PyTorch 2.4.0权重tencent/HunyuanVideo-Avatar 完整权重含 ckpts/ 下 transformers、vae、whisper-tiny、det_align系统工具ffmpeg用来给生成视频合成音轨最少 3 步拿到可运行环境⚡ 先把仓库克隆下来git clone https://gitcode.com/gh_mirrors/hu/HunyuanVideo-Avatar.git看到根目录下有assets/test.csv和scripts/即成功。接着一条命令建环境装依赖conda create -n HunyuanVideo-Avatar python3.10.9 conda activate HunyuanVideo-Avatar python -m pip install -r requirements.txt跑python -c import diffusers, gradio, librosa无报错即装好。最后把权重下进weights/大文件视网况约 10 分钟到 1 小时pip install huggingface_hub[cli] cd HunyuanVideo-Avatar/weights huggingface-cli download tencent/HunyuanVideo-Avatar --local-dir ./看到weights/ckpts/hunyuan-video-t2v-720p/目录即就位。改完这 4 个参数就能跑 单卡入口是 scripts/run_single_audio.sh真正影响首次运行的只有 4 处--input改哪里 → 脚本命令行参数。改成什么 → 换成你自己的任务 csv列固定为 videoid、image、audio、prompt、fps参考 assets/test.csv。不交会怎样 → 默认跑仓库自带样例数据适合冒烟测试无需改。--ckpt改哪里 → 脚本里checkpoint_path变量。改成什么 → 单卡保持 fp8 版mp_rank_00_model_states_fp8.pt。不交会怎样 → 权重没下全会直接报models_root not exists。--image-size改哪里 → 脚本命令行参数。改成什么 → 保持 704显存紧张降到 512。不交会怎样 → 24GB 卡可能 OOM 且生成很慢。--save-path改哪里 →OUTPUT_BASEPATH变量。改成什么 → 任意输出目录如./results-single。不交会怎样 → 写仓库根目录下无害。其余保持默认即可--infer-steps 50、--cfg-scale 7.5都不用动。首次启动与验证标准⚡ 单卡直接执行bash scripts/run_single_audio.sh脚本带--infer-min每条视频只出约 5 秒方便快速验收。加载权重后终端打印load hunyuan model successful...随后按 csv 逐行生成。最小成功标准results-single/8_audio.mp4对应 csv 首行 videoid8存在、能播放、口型对得上音频。想调参改任务入口都在 hymm_sp/ 的sample_gpu_poor.py。高频踩坑速查症状OOM →根因704 分辨率 24GB 显存余量小 →修复--image-size降档或改用scripts/run_single_poor.sh里带--cpu-offload的版本。症状特定 GPU 报 float point exception (core dump) →根因cuBLAS/CUDNN 版本不匹配 →修复pip install nvidia-cublas-cu1212.4.5.8并把LD_LIBRARY_PATH指向该库目录细节看 README。症状启动报缺 whisper-tiny 或 det_align →根因huggingface 权重没下全 →修复在weights/重跑huggingface-cli download tencent/HunyuanVideo-Avatar --local-dir ./。症状scripts/run_gradio.sh起不来 →根因Web 界面用 torchrun 按 8 卡拉起后端 →修复先跑run_single_audio.sh验证单卡链路。卡住就去 issue 区搜关键词或翻 docs/ 对应章节。【免费下载链接】HunyuanVideo-Avatar项目地址: https://gitcode.com/gh_mirrors/hu/HunyuanVideo-Avatar创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考