wan-gguf

wan-gguf

Wan 视频模型的 GGUF 量化版本，可在 ComfyUI 或 diffusers 中做文生视频，包括适合旧机器的 1.3b 小文件。适合在本地制作 AI 短视频的人。

由 calcuis 在 Hugging Face 上制作。这些说明是 Mindket 根据它的模型页面和模型卡写的，模型自己的文件和许可证在 Hugging Face 上。

简介

它是什么：wan-gguf 是 Wan 视频模型的一组 GGUF 量化版本，从 Wan 2.1 的 ComfyUI 发布版重新打包而来。你可以用这些文件在自己的电脑上，根据文字提示词制作短视频。1.3b 的文生视频和 VACE 文件被说明在较旧或低端的机器上运行良好。

适合谁：它适合在本地生成 AI 视频、想要更小模型文件以便在普通硬件上运行的人。也适合已经在用 ComfyUI 或 diffusers 的折腾爱好者。

Title: 谁在用
Industry | Who uses it | How they use it | Example
视频和内容 | 创作者 | 根据文字提示词制作短片 | 根据场景描述生成一段视频
软件 | 工具开发者 | 在脚本里通过 diffusers 运行模型 | 把生成的视频导出为文件
爱好者 | 旧机器的主人 | 在低端硬件上使用 1.3b GGUF 文件 | 在老旧电脑上运行文生视频

想用托管视频服务的人可以跳过它。

用在哪里：

• ComfyUI，配合 gguf-node 之类的 GGUF 节点
• 使用 diffusers 库的 Python
• gguf-connector 命令行
• Windows、macOS 或 Linux

Title: 主要用途
Use case | Who | What they get back
文生视频 | 创作者 | 根据提示词生成的一段短片
图生视频 | 创作者 | 用额外的视觉文件，从一张图像开始的短片
VACE 编辑 | 开发者 | 通过 diffusers 用 1.3b VACE 文件生成的视频

如何设置：

• 你电脑上的 Python
• huggingface_hub 包
• 带有 GGUF 节点的 ComfyUI，或者 diffusers
• 足够容纳所选文件的内存

1. 安装 Hugging Face 的 hub 包。
2. 把文件下载到你的电脑。
3. 按下面的表格，把每个文件放进对应的 ComfyUI 文件夹。
4. 载入工作流并运行。

pip install -U huggingface_hub
hf download calcuis/wan-gguf

Title: 文件放在哪里
File | Folder
GGUF 模型 | ./ComfyUI/models/diffusion_models
t5xxl-um 文本编码器 | ./ComfyUI/models/text_encoders
VAE | ./ComfyUI/models/vae
clip-vision-h，仅用于图生视频 | ./ComfyUI/models/clip_vision

如何使用：在 ComfyUI 里，把模型页面上的一个演示视频拖进浏览器，就能载入工作流。如果你用作者的 gguf 包，请运行它主目录里的 .bat 文件。使用 fp8 缩放的文本编码器时，把 GGUF clip 加载器里的设备设为 cpu，模型卡说这不影响速度。另一条路线是 gguf-connector 命令。

ggc v2

示例：在 diffusers 路线里，模型卡用提示词要一段猪在日落时分的雪林里快速移动、镜头跟拍的短片。它把尺寸设为 720 乘 480，57 帧，24 步，然后以每秒 16 帧导出结果。模型卡在这里没有给出示例视频。

新手与专家：如果你是新手，从 ComfyUI 和模型页面上的一个演示工作流开始。先试小的 1.3b 文生视频文件，因为它是被说明适合普通机器的那个。

对于专家来说，pig 架构是 gguf 节点对任何模型、编码器或 VAE 文件都接受的一个宽松标签。在 comfyui-gguf 节点里，你可能需要把 pig 加到 loader.py 中的图像架构列表里。最新的 1.3b VACE 文件除了块权重之外全部保留 f32，以避免嵌入键错误。

下载 GGUF、编码器和 VAE 文件
把它们放进 ComfyUI 的文件夹
载入演示工作流或 diffusers 脚本
生成并导出视频

注意事项：

• Pig label: 这个架构名称需要你的 GGUF 节点支持。
• fp8 encoders: 按模型卡说法，在 clip 加载器里使用 cpu 卸载。
• License: Apache 2.0。
• Cost to run: 来源未提及。
• Data it reaches: 它从 Hugging Face 下载文件，来源没有提到其他内容。
• Not for: 想要一键应用的人，因为设置需要好几个文件。

Hugging Face 上的数据（2026年11月13日）

• 任务：text to video
• 参数量：127M
• Weights: about 63 MB at 4-bit (estimate)
• Formats: GGUF
• 最近 30 天下载：21,309
• 点赞：210
• 许可证：apache-2.0
• 语言：en
• 基于：Comfy-Org/Wan_2.1_ComfyUI_repackaged
• 标签：gguf, gguf-connector, gguf-node, text-to-video

链接

• 模型：https://huggingface.co/calcuis/wan-gguf
• 文件：https://huggingface.co/calcuis/wan-gguf/tree/main

获取模型

用 Hugging Face 的命令行下载它的文件：

pip install -U huggingface_hub
hf download calcuis/wan-gguf

然后按它的模型卡使用它。这个工具包里没有会自己运行的东西。