Idol

Idol

在 ComfyUI 里把一张图片变成 3D 高斯点云，使用重新打包的 TripoSplat 微调模型文件，适合在 ComfyUI 工作流里用图片生成 3D 的人。

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

简介

它是什么：Idol 是一组为 ComfyUI 重新打包的模型文件，能把一张图片变成 3D 结果。它是 TripoSplat 的微调版本，可以用在现有的 TripoSplat 工作流里。原始模型来自 speridlabs/idol 仓库，由 Comfy-Org 为 ComfyUI 打包。

适合谁：它适合想用单张图片生成 3D 场景的 ComfyUI 用户。

Industry | Who uses it | How they use it | Example
3D 和游戏 | 3D 美术师 | 用一张图片生成高斯点云 | 一张概念图变成可以环顾的 3D 场景
产品设计 | 设计师 | 用一张照片预览物体的 3D 效果 | 一张产品照片变成粗略的 3D 视图
研究 | 机器学习研究人员 | 在节点工作流里运行图片转 3D 模型 | 在同一个工作流里对比 Idol 和 TripoSplat

如果你不用 ComfyUI，可以跳过它。

用在哪里：

• ComfyUI，文件放在它的 models 文件夹里
• 现有的 TripoSplat 工作流
• Comfy-Org 工作流模板里的 Idol: Image to Gaussian Splat 工作流模板
• Windows、macOS 或 Linux，取决于你的 ComfyUI 在哪里运行

Use case | Who | What they get back
图片转高斯点云 | 3D 美术师 | 由一张输入图片生成的高斯点云
复用 TripoSplat 工作流 | ComfyUI 用户 | 你已有的工作流，用 Idol 文件来运行

如何设置：

你需要先准备：

• 电脑上装好 ComfyUI
• Python，用来运行 Hugging Face 下载命令

1. 用 hub 工具下载模型文件。
2. 按下表把四个文件分别复制到 ComfyUI models 文件夹下对应的目录。
3. 在 ComfyUI 里打开 Idol 工作流模板，或者现有的 TripoSplat 工作流。

pip install -U huggingface_hub
hf download Comfy-Org/Idol

Title: 每个文件在 ComfyUI 文件夹里的位置
File | Folder
idol_fp16.safetensors | models/diffusion_models
dino_v3_vit_h_bf16.safetensors | models/clip_vision
flux2-vae.safetensors | models/vae
idol_decoder_fp16.safetensors | models/vae

如何使用：在 ComfyUI 里打开 Idol: Image to Gaussian Splat 工作流，给它一张图片，然后运行。工作流会用到你放进 models 文件夹的文件。

示例：你把一张物体的照片载入 Idol 工作流并运行。得到的是这个物体的高斯点云，也就是工作流名字所指的 3D 结果。

新手与专家：Idol 是一包模型文件，不是一个应用。第一步可以先把四个文件放进各自的文件夹，打开 Idol 工作流模板，用一张清晰的图片试一下。

从内部看，它是 TripoSplat 的微调版本，所以共用该模型的工作流。扩散模型和解码器以 fp16 保存，视觉文件以 bf16 保存。vae 文件夹里还有一个 Flux 2 VAE 文件。

在 ComfyUI 里打开 Idol 工作流
给它一张输入图片
Idol 模型文件处理这张图片
输出一个高斯点云

注意事项：Idol 只是为 ComfyUI 重新打包，所以模型本身的细节在原始仓库里。

• 文件: 四个 safetensors 文件，分放在 diffusion_models、clip_vision 和 vae 文件夹里
• 兼容性: 可用于现有的 TripoSplat 工作流
• License: Apache 2.0
• Cost to run: 未提及
• Data it reaches: 你给它的图片，以及你 ComfyUI 文件夹里的模型文件

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

• 任务：image to 3d
• 框架：diffusion-single-file
• 最近 30 天下载：52,939
• 点赞：165
• 许可证：apache-2.0
• 基于：speridlabs/idol
• 标签：diffusion-single-file, comfyui, image-to-3d

链接

• 模型：https://huggingface.co/Comfy-Org/Idol
• 文件：https://huggingface.co/Comfy-Org/Idol/tree/main

获取模型

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

pip install -U huggingface_hub
hf download Comfy-Org/Idol

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