最近中国的ai速度有些惊人，deepseek都快成过期的明星了，现在站在聚光灯下的是Manus和HunyuanVideo。嘿嘿，今天我们聊聊如何安装HunyuanVideo，怎么安装腾讯的开源视频生成模型 HunyuanVideo。这玩意儿拥有130亿参数，能把你的文字变成超酷的视频，生成的质量杠杠的！想试试安装在自己本机吗？好，一步步来吧，我会尽量讲得简单又清楚。走起！
HunyuanVideo是啥？
先简单说一下，HunyuanVideo是腾讯搞出来的一个AI文生视频工具，牛逼之处在于它完全开源，而且效果能跟一些顶尖的闭源模型PK。比如你随便输一句“一个女孩在森林里跳舞”，它就能给你生成一段带画质、动作流畅的视频，简直像魔法！不过呢，它对硬件要求有点高，特别是显卡显存，所以咱们得先做好准备。
好了，废话不多说，直接进入安装步骤！
安装HunyuanVideo前的准备
装HunyuanVideo之前，你得先检查一下自己的“装备”。这里是我总结的几个要点：
- 硬件要求
- GPU显存最好24GB起步（比如NVIDIA RTX 3090或A100），不然跑不动完整版。
- 如果显存不够（比如16GB或更低），别慌，后面会提到量化版，能凑合跑。
- 系统：Ubuntu推荐（Windows也能试，但可能会有坑）。
- 软件环境
- Python 3.8或以上（3.10也OK）。
- CUDA（显卡驱动配套的，得装好，我用的是12.1）。
- Git（用来下载代码）。
- 一个稳定的网络（下载模型文件不小，耐心点）。
- 空间准备
- 硬盘至少留个50GB，模型和依赖装完可能会更大。
没问题的话，咱们就开干！
详细安装步骤
以下是详细步骤，我尽量写得口语化，像教朋友一样一步步带你搞定。
步骤1：克隆官方仓库
HunyuanVideo的代码都在GitHub上，咱们先把它下载下来。打开终端，输入：
bash
git clone https://github.com/Tencent/HunyuanVideo.git
cd HunyuanVideo这就把代码拉到你电脑上了，接下来进到文件夹里准备干活。
步骤2：安装依赖
官方给了一个requirements.txt文件，里面列了所有需要的库。直接跑下面这句：
bash
pip install -r requirements.txt注意：
- 如果你用的是torch（PyTorch），官方推荐2.4.0，但有用户反馈说2.4.0跑出来是黑屏，建议装2.5.1。我试了下，2.5.1确实稳。
- 安装过程中可能会遇到下载慢的问题，可以换个国内源，比如：bash
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
步骤3：下载模型文件
HunyuanVideo的模型文件不小，得从官方指定地方下。GitHub的README里会告诉你链接，通常是腾讯云的地址。下载后解压，把文件放进项目文件夹下的models目录（没有就自己建一个）。
如果显存不够，可以试试社区的FP8量化版（感谢大神Kijai），显存要求低到12GB也能跑。量化版链接一般也在GitHub讨论区能找到。
步骤4：配置环境
模型下好后，得告诉程序去哪儿找它。编辑一下配置文件（比如config.yaml），把模型路径写进去。像这样：
yaml
model_path: "./models/hunyuanvideo"步骤5：测试跑起来
万事俱备，就差试跑了！官方提供了一个简单的测试脚本，跑跑看：
bash
python scripts/inference.py --prompt "一只猫在草地上打滚" --output "output_video.mp4"- –prompt 就是你想生成的视频描述。
- –output 是输出视频的名字。
如果一切顺利，几分钟后你就能看到生成的视频啦！第一次跑可能会慢点，模型得加载，别急。
遇到问题怎么办？
装的过程中难免会踩坑，我总结了几个常见问题和解法：
- 显存不够咋办？
用量化版吧，效果差点但能跑。或者去云平台（比如趋动云）一键部署，省心。 - 黑屏视频？
检查torch版本，换2.5.1试试。还不行就看看显卡驱动是不是最新的。 - 依赖装不上？
可能是网络问题，换源或者手动装报错的库。
实在搞不定，去GitHub提issue，或者看看社区的帖子，总有大佬帮忙。
HunyuanVideo的核心参数
以下是关于 HunyuanVideo 主要参数的整理，我把它们整理成一个表格，方便你快速查看：
| 参数名称 | 描述 | 默认值/推荐值 | 备注 |
|---|---|---|---|
| model_path | 模型文件的路径 | ./models/hunyuanvideo | 得指向你下载的模型文件夹，不然程序找不到 |
| prompt | 输入的文本描述，也就是你想生成的视频内容 | 无（必填） | 支持中文，比如“一只猫跳舞”，越具体越好 |
| output | 输出视频的文件名 | output_video.mp4 | 可以随便改名，比如my_cat.mp4 |
| num_frames | 生成视频的帧数，决定视频长度 | 24 | 默认24帧，大概1秒左右，想长点可以调高，但显存得撑得住 |
| resolution | 视频分辨率 | 512×512 | 可以调到更高（比如1024×1024），但显存和时间成本会增加 |
| fps | 每秒帧率，影响视频流畅度 | 24 | 24是标配，电影感，调低会卡顿，调高显存压力大 |
| batch_size | 一次处理的帧数，影响生成速度和显存占用 | 1 | 显存大的可以调高（比如4），速度快点，但小显存就老老实实1吧 |
| guidance_scale | 文本引导强度，控制生成结果跟描述的贴合度 | 7.5 | 范围1-20，太低随机性强，太高可能死板，7.5是个平衡点 |
| num_inference_steps | 生成步数，影响质量和速度 | 50 | 步数越多越精致，但也越慢，50算折中，显存不够可以试试30 |
| seed | 随机种子，控制生成结果的随机性 | -1（随机） | 想复现结果就设个固定值，比如123，不然每次跑都不一样 |
| dtype | 数据精度，影响显存和速度 | float16 | float16省显存，float32更精准，看你硬件支持啥 |
| device | 运行设备 | cuda | 默认GPU跑，显卡不行可以用cpu（巨慢，不推荐） |
- 怎么用这些参数？
这些参数一般是在跑脚本时通过命令行传进去，比如：bashpython scripts/inference.py --prompt "一只狗在海边跑" --output "dog.mp4" --num_frames 48 --resolution 1024x1024或者写在配置文件里，具体看官方文档。 - 显存和参数的关系
- 像num_frames、resolution、batch_size调高，显存占用会飙升。24GB显存跑默认配置没啥压力，但想生成长视频或高清视频，得上A100这种大佬级显卡。
- 用量化版（FP8）的话，显存要求能降到12GB左右，但细节可能会丢一点。
- 调参小技巧
- 如果视频太“飘”不贴合描述，试着把guidance_scale调高点。
- 想快点出结果，num_inference_steps可以砍到30，质量稍微差点但能接受。
官方网站和Demo地址
- 官方网站：https://aivideo.hunyuan.tencent.com/
这里有官方介绍和一些基础教程，值得一看。 - GitHub地址：https://github.com/Tencent/HunyuanVideo
代码、文档、模型下载都在这儿，核心基地。 - Demo体验地址：https://video.hunyuan.tencent.com/
想先看看效果？点进去试试，每天有6次免费体验机会，生成的视频质量真的惊艳！
用户反馈
我在网上扒了扒用户评价，总结一下：
- 优点：
- “生成质量超高，动作流畅，画质像电影！”
- “开源免费，太良心了，社区还挺活跃。”
- “比Runway Gen-3还强，尤其中文理解超准。”
- 缺点：
- “显存要求太高，家用机跑不动全版。”
- “安装有点复杂，新手容易懵。”
- “生成速度不算快，得等几分钟。”
总体来说，大家对HunyuanVideo评价挺高，尤其是开源这点，圈粉无数。不过硬件门槛确实劝退了一些小白用户。
最后唠几句
好了，安装HunyuanVideo的步骤就讲到这儿！其实只要硬件跟得上，按我说的步骤走，基本都能装好。装完之后你就可以尽情玩了，生成各种脑洞大开的视频，真的超有意思！我昨天试了个“外星人在沙漠跳迪斯科”，效果笑喷了。
有啥问题欢迎留言，咱们一起解决。
