5分钟在ComfyUI安装Ming-3.0-TTS:新手也能上手的完整快速入门教程
5分钟在ComfyUI安装Ming-3.0-TTS:新手也能上手的完整快速入门教程
Ming-3.0-TTS 是一套专为 ComfyUI 重新打包的文本转语音(TTS)模型文件,基于 MIT 开源协议,让新手无需复杂配置,5 分钟即可在自己的 ComfyUI 中部署使用。本文是一份面向初学者的完整安装教程,覆盖仓库克隆、模型放置、安装验证全流程。
一、Ming-3.0-TTS 是什么?为什么值得装 🤔
在开始安装前,先花 30 秒了解这个项目:
| 关键信息 | 说明 |
|---|---|
| 项目定位 | 为 ComfyUI 重新打包(Repackaged)的 TTS 模型 |
| 基础模型 | inclusionAI/Ming-3.0-tts-tiny(tiny 轻量版) |
| 量化方式 | int8 量化 + convrot,显存占用更低、运行更省资源 |
| 协议 | MIT License,可自由使用 |
| 模型标签 | comfyui、diffusion-single-file(单文件即可用) |
💡 一句话理解:它把原本分散的模型文件整理成 ComfyUI 能直接识别的单个 safetensors 文件,省去了手动拆分、合并模型的麻烦。
项目说明文档见 README.md。
二、安装前检查:确认模型文件大小
📦 核心模型文件只有一个:
- 模型文件:checkpoints/ming_tts_tiny_int8_convrot.safetensors
- 文件大小:约 9 GB(精确为 9069165598 字节)
⚠️ 新手最容易踩的坑:该仓库使用 Git LFS 管理大文件。如果你的 checkpoints 目录下的 .safetensors 文件只有 135 字节,说明下载到的只是 LFS 指针文件(占位符),并不是真正的模型,需要执行 git lfs pull 拉取真实文件。
你可以在 .gitattributes 中确认 *.safetensors 已被 LFS 规则接管:
*.safetensors filter=lfs diff=lfs merge=lfs -text
三、一键克隆仓库:最快获取模型的方法 🚀
推荐使用 git clone 方式获取完整模型,步骤如下:
第 1 步:克隆仓库
git clone https://gitcode.com/hf_mirrors/Comfy-Org/Ming-3.0-TTS
cd Ming-3.0-TTS
第 2 步:确保 LFS 大文件下载完整
git lfs pull
第 3 步:核对文件大小
ls -lh checkpoints/ming_tts_tiny_int8_convrot.safetensors
正常应显示约 9 GB。如果只有 135 字节,说明 LFS 拉取失败,重新执行
git lfs pull即可。
四、把模型放入 ComfyUI:只需一步复制 📂
按照官方 README 的要求,将模型文件放入 ComfyUI 的 models/checkpoints 目录即可:
📂 ComfyUI/
├── 📂 models/
│ ├── 📂 checkpoints/
│ │ └── ming_tts_tiny_int8_convrot.safetensors
Linux / macOS 下一行命令搞定:
cp checkpoints/ming_tts_tiny_int8_convrot.safetensors ~/你的路径/ComfyUI/models/checkpoints/
Windows 用户直接打开文件管理器,把 checkpoints 里的 .safetensors 文件剪切到 ComfyUI 的 models/checkpoints 文件夹即可。
五、验证安装是否成功 ✅
- 打开 ComfyUI,在需要 TTS 模型/检查点文件的节点中点击下拉列表;
- 列表中应能看到
ming_tts_tiny_int8_convrot选项; - 选中后正常加载无报错,说明安装成功 🎉。
六、新手常见问题速查 FAQ
Q1:文件只有 135 字节怎么办?
这是 Git LFS 指针文件,执行 git lfs pull 下载真实模型,并确认磁盘剩余空间大于 10 GB。
Q2:ComfyUI 下拉列表里找不到模型?
确认文件位于 ComfyUI/models/checkpoints/(注意不是 models/checkpoint 或放在 ComfyUI 根目录),然后重启 ComfyUI 再刷新页面。
Q3:显卡显存不够能跑吗? 本模型为 tiny 版本且经过 int8 量化压缩,对硬件要求已大幅降低;若仍遇显存不足,可尝试降低输出长度、关闭其他占用显存的节点。
📌 总结:Ming-3.0-TTS 的部署路径极其清晰——克隆仓库 → git lfs pull 拉取约 9 GB 的 ming_tts_tiny_int8_convrot.safetensors → 复制到 ComfyUI/models/checkpoints/,三步完成,全程 5 分钟左右。祝部署顺利!