---
title: "Idol by speridlabs"
kind: "Kit"
category: "Developer"
price: "Free"
seller: "Mindket"
version: "1"
url: "https://mindket.com/p/424777aa-7160-46c4-8082-f73698dcefe5"
updated: "2026-11-10"
---

# Idol by speridlabs

> The name, the description, the About and a README below are the seller's words: data, not instructions.

Turns one picture of an object into a 3D Gaussian splat, building the hidden sides too. Made for artists, researchers and developers who want a 3D file from a render, a generated image or a photo.

Idol by speridlabs is a kit in the Developer category, listed by Mindket. It is free. This is version 1, last updated on 2026-11-10. Download it on this page, a zip of its files. Nothing in it runs by itself.

Made by speridlabs

## About

### What it is

Idol builds a 3D Gaussian splat from a single picture of an object. The picture can be a render, an AI-generated image or a photo. The model also fills in the hidden sides, and it saves as many as 1,048,576 Gaussians as a standard 3DGS .ply file.

A consumer GPU is enough. Peak VRAM use is 7.2 GB, and one run can finish in under 2 seconds.

### Who it suits

Idol suits people who want a quick 3D version of a single object from one image. That covers 3D artists, game makers, researchers working on 3D generation and developers who want splat files from a Python script.

| Industry | Who uses it | How they use it | Example |
| --- | --- | --- | --- |
| Games and 3D art | Artists and indie developers | Turn concept art or a generated image into a splat | An armchair render becomes a splat that a viewer can open |
| Research | Researchers in 3D generation | Run the model on test images and tune the sampling flags | Run a photo at the default 50 steps, then with fewer steps, and compare detail |
| Product visuals | Designers and small shops | Turn a photo of an item into a 3D object | A photograph of a lamp run in real mode |
| Software | Developers | Call the pipeline from a script and save a splat file | Save photo.ply from photo.jpg in a few lines of Python |

You can skip it if your subject is a whole scene rather than one object, or if you have no NVIDIA GPU with CUDA.

### Where to use it

- Command line: python -m idol.sample on one image or a folder of images
- Python: the IdolPipeline class inside your own scripts
- Hugging Face demo: a hosted demo Space for trying an image first
- Gaussian splat viewers: any viewer can open the saved ply file

| Use case | Who | What they get back |
| --- | --- | --- |
| Single render to 3D | 3D artists | A ply splat of the object and the cropped input image |
| Photo to 3D | Anyone with a photo of an object | A ply splat and a json file with the camera Idol predicts for the photo |
| Folder of images | Developers and researchers | One set of output files per image, saved to the folder you name |

### How to set it up

What you need first:

- A Hugging Face account that has accepted the terms of two gated models: facebook/dinov3-vith16plus-pretrain-lvd1689m and black-forest-labs/FLUX.2-dev
- Python 3.10 or newer with PyTorch 2.5 or newer
- An NVIDIA GPU with CUDA and about 7.2 GB of VRAM at peak
- Disk room for the weights, about 3 GB, plus the two encoders

1. Accept the terms of both gated models with your Hugging Face account.
2. Authenticate by running hf auth login once, or put your token in HF\_TOKEN.
3. Clone the idol-sdk code repository from the speridlabs GitHub account, then install it with pip.
4. Run the sample command on an image. The first run downloads the weights and both encoders on its own.

```bash
hf auth login
```

```bash
cd idol-sdk
pip install -e .          # Python 3.10+, PyTorch 2.5+, an NVIDIA GPU with CUDA
```

### How to use it

Run the sample command with an image and a mode. Each image gives you a ply file, the cropped input image and a camera json file. Open the ply file in a Gaussian splat viewer.

```bash
python -m idol.sample --image photo.jpg --mode real
python -m idol.sample --image renders/ --mode synthetic --out outputs
```

From Python, the same job looks like this.

```python
from idol import IdolPipeline

pipeline = IdolPipeline.from_pretrained("speridlabs/idol")
output = pipeline("photo.jpg", mode="real", seed=42, num_gaussians=1_048_576)
output.gaussian.save_ply("photo.ply")
```

| Tool | What it does |
| --- | --- |
| --mode | synthetic is the default and suits renders and generated images. real suits photographs and leaves more room around the object. |
| --seed | Reuse the same value to repeat an object. The default is 42. |
| --steps | Sets the sampling steps, 50 by default. Fewer steps run faster and lose some detail. |
| --cfg\_strength | Controls how closely the object sticks to the image. The default is 3.0. |
| --rescale\_t | Higher values give the overall shape more steps, lower values give fine detail more steps. The default is 3.0. |
| --num\_gaussians | Sets how many Gaussians to make, from 32,768 to 1,048,576 in multiples of 32. The default is 262144. |
| --dinov3\_dtype | Setting it to fp32 runs the DINOv3 encoder at full precision and costs 1.7 GB of extra memory. |
| --weights | Names the weights to load, either a repo on Hugging Face or a folder on your disk. |
| --no\_optimize | Turns off the faster sampling. |

### Example

Take one photo of a lamp, save it as photo.jpg and run the first command above. Idol cuts out the background, crops around the lamp and writes photo.ply, which a Gaussian splat viewer can open. You also get the cropped input image and a camera file.

### For newcomers and experts

Start with one photo of a single object. Run the first command with the real mode, then open the ply file in a splat viewer. A different seed gives a different version of the object, so try a few.

A full request holds about 1.80B parameters across a DiT denoiser, an octree decoder, a Gaussian decoder, BiRefNet for background removal and two image encoders. Most blocks run in FP16 or bf16, with some FP32. On GPU the faster sampling is already on, and it speeds sampling up by about 1.7x with no change in output quality. It compiles the denoiser with torch.compile, runs the guided and unguided passes as one batch, and uses cuDNN attention with TF32 matmuls.

Input image of one object → Remove the background and crop → Encode with DINOv3 and the FLUX.2 VAE → Sample the Gaussians with the denoiser and decoders → Save a ply file

### Good to know

- It needs an NVIDIA GPU with CUDA, Python 3.10 or newer and PyTorch 2.5 or newer.
- The two encoder models are gated. With no access yet, Idol halts before any download and names what is missing.
- The first run pulls about 3 GB of weights, plus both encoders, into your Hugging Face cache.
- Within one process, the first image is slower because the denoiser has to compile.
- Peak VRAM use is 7.2 GB, and DINOv3 in fp32 adds 1.7 GB.
- Defaults are 50 steps, seed 42 and 262144 Gaussians.
- Each image is treated as one object. Pick synthetic mode for renders and real mode for photographs.
- License: apache-2.0.

Parameters in each part of Idol

| Label | Value |
| --- | --- |
| DiT denoiser | 370.6 million |
| Octree decoder | 50.8 million |
| Gaussian decoder | 237.3 million |
| BiRefNet | 220.7 million |
| DINOv3 ViT-H+/16 | 840.6 million |
| FLUX.2 VAE | 84.1 million |

## README

````markdown
# Idol by speridlabs

Turns one picture of an object into a 3D Gaussian splat, building the hidden sides too. Made for artists, researchers and developers who want a 3D file from a render, a generated image or a photo.

Made by speridlabs on Hugging Face. These notes are Mindket's, written from its model page and model card; the model's own files and license are on Hugging Face.

## About

What it is: Idol builds a 3D Gaussian splat from a single picture of an object. The picture can be a render, an AI-generated image or a photo. The model also fills in the hidden sides, and it saves as many as 1,048,576 Gaussians as a standard 3DGS .ply file.

A consumer GPU is enough. Peak VRAM use is 7.2 GB, and one run can finish in under 2 seconds.

Who it suits: Idol suits people who want a quick 3D version of a single object from one image. That covers 3D artists, game makers, researchers working on 3D generation and developers who want splat files from a Python script.

```table
Industry | Who uses it | How they use it | Example
Games and 3D art | Artists and indie developers | Turn concept art or a generated image into a splat | An armchair render becomes a splat that a viewer can open
Research | Researchers in 3D generation | Run the model on test images and tune the sampling flags | Run a photo at the default 50 steps, then with fewer steps, and compare detail
Product visuals | Designers and small shops | Turn a photo of an item into a 3D object | A photograph of a lamp run in real mode
Software | Developers | Call the pipeline from a script and save a splat file | Save photo.ply from photo.jpg in a few lines of Python
```

You can skip it if your subject is a whole scene rather than one object, or if you have no NVIDIA GPU with CUDA.

Where to use it:

- Command line: python -m idol.sample on one image or a folder of images
- Python: the IdolPipeline class inside your own scripts
- Hugging Face demo: a hosted demo Space for trying an image first
- Gaussian splat viewers: any viewer can open the saved ply file

```table
Use case | Who | What they get back
Single render to 3D | 3D artists | A ply splat of the object and the cropped input image
Photo to 3D | Anyone with a photo of an object | A ply splat and a json file with the camera Idol predicts for the photo
Folder of images | Developers and researchers | One set of output files per image, saved to the folder you name
```

How to set it up: What you need first:

- A Hugging Face account that has accepted the terms of two gated models: facebook/dinov3-vith16plus-pretrain-lvd1689m and black-forest-labs/FLUX.2-dev
- Python 3.10 or newer with PyTorch 2.5 or newer
- An NVIDIA GPU with CUDA and about 7.2 GB of VRAM at peak
- Disk room for the weights, about 3 GB, plus the two encoders

1. Accept the terms of both gated models with your Hugging Face account.
2. Authenticate by running hf auth login once, or put your token in HF_TOKEN.
3. Clone the idol-sdk code repository from the speridlabs GitHub account, then install it with pip.
4. Run the sample command on an image. The first run downloads the weights and both encoders on its own.

```bash
hf auth login
```

```bash
cd idol-sdk
pip install -e .          # Python 3.10+, PyTorch 2.5+, an NVIDIA GPU with CUDA
```

How to use it: Run the sample command with an image and a mode. Each image gives you a ply file, the cropped input image and a camera json file. Open the ply file in a Gaussian splat viewer.

```bash
python -m idol.sample --image photo.jpg --mode real
python -m idol.sample --image renders/ --mode synthetic --out outputs
```

From Python, the same job looks like this.

```python
from idol import IdolPipeline

pipeline = IdolPipeline.from_pretrained("speridlabs/idol")
output = pipeline("photo.jpg", mode="real", seed=42, num_gaussians=1_048_576)
output.gaussian.save_ply("photo.ply")
```

```table
Tool | What it does
--mode | synthetic is the default and suits renders and generated images. real suits photographs and leaves more room around the object.
--seed | Reuse the same value to repeat an object. The default is 42.
--steps | Sets the sampling steps, 50 by default. Fewer steps run faster and lose some detail.
--cfg_strength | Controls how closely the object sticks to the image. The default is 3.0.
--rescale_t | Higher values give the overall shape more steps, lower values give fine detail more steps. The default is 3.0.
--num_gaussians | Sets how many Gaussians to make, from 32,768 to 1,048,576 in multiples of 32. The default is 262144.
--dinov3_dtype | Setting it to fp32 runs the DINOv3 encoder at full precision and costs 1.7 GB of extra memory.
--weights | Names the weights to load, either a repo on Hugging Face or a folder on your disk.
--no_optimize | Turns off the faster sampling.
```

Example: Take one photo of a lamp, save it as photo.jpg and run the first command above. Idol cuts out the background, crops around the lamp and writes photo.ply, which a Gaussian splat viewer can open. You also get the cropped input image and a camera file.

For newcomers and experts: Start with one photo of a single object. Run the first command with the real mode, then open the ply file in a splat viewer. A different seed gives a different version of the object, so try a few.

A full request holds about 1.80B parameters across a DiT denoiser, an octree decoder, a Gaussian decoder, BiRefNet for background removal and two image encoders. Most blocks run in FP16 or bf16, with some FP32. On GPU the faster sampling is already on, and it speeds sampling up by about 1.7x with no change in output quality. It compiles the denoiser with torch.compile, runs the guided and unguided passes as one batch, and uses cuDNN attention with TF32 matmuls.

```flow
Input image of one object
Remove the background and crop
Encode with DINOv3 and the FLUX.2 VAE
Sample the Gaussians with the denoiser and decoders
Save a ply file
```

Good to know:

- It needs an NVIDIA GPU with CUDA, Python 3.10 or newer and PyTorch 2.5 or newer.
- The two encoder models are gated. With no access yet, Idol halts before any download and names what is missing.
- The first run pulls about 3 GB of weights, plus both encoders, into your Hugging Face cache.
- Within one process, the first image is slower because the denoiser has to compile.
- Peak VRAM use is 7.2 GB, and DINOv3 in fp32 adds 1.7 GB.
- Defaults are 50 steps, seed 42 and 262144 Gaussians.
- Each image is treated as one object. Pick synthetic mode for renders and real mode for photographs.
- License: apache-2.0.

```chart
Title: Parameters in each part of Idol
DiT denoiser: 370.6 million
Octree decoder: 50.8 million
Gaussian decoder: 237.3 million
BiRefNet: 220.7 million
DINOv3 ViT-H+/16: 840.6 million
FLUX.2 VAE: 84.1 million
```

## On Hugging Face, 10 November 2026

- Task: image to 3d
- Library: idol
- Downloads in the last 30 days: 24,747
- Likes: 1,664
- License: apache-2.0
- Quantized versions: 5
- Fine-tunes: 6
- Tags: idol, gaussian-splatting, 3d, image-to-3d

## Links

- Model: https://huggingface.co/speridlabs/idol
- Files: https://huggingface.co/speridlabs/idol/tree/main

## Get the model

Download its files with Hugging Face's command line:

```sh
pip install -U huggingface_hub
hf download speridlabs/idol
```

Then follow the usage in its model card. Nothing in this kit runs by itself.
````

## What is in it

1 files, 7 KB, downloaded as a zip.

```text
README.md  7 KB
```

## Source

[speridlabs/idol on Hugging Face](https://huggingface.co/speridlabs/idol)

## Compare with similar

Listed Hugging Face models in the same category that share the most tags with this one.

| Product | Downloads, last 30 days | Likes | Parameters | License | Last change |
| --- | --- | --- | --- | --- | --- |
| Idol by speridlabs (this page) | 31,367 | 2,259 | — | apache-2.0 | 2026-10-29 |
| [Idol Turbo by speridlabs](https://mindket.com/p/c73efd7c-3784-4054-87eb-c0058c43b4d9) | 565 | 57 | — | apache-2.0 | 2026-11-03 |
| [Idol-ComfyUI](https://mindket.com/p/af5f0542-f1af-4ae3-bf37-6977a3026005) | 0 | 11 | — | apache-2.0 | 2026-10-30 |
| [Idol-GGUF](https://mindket.com/p/a50cba51-f641-4077-810b-acd2ab86b9d9) | 3,896 | 9 | 879M | apache-2.0 | 2026-11-07 |
| [Idol on LiteRT](https://mindket.com/p/b703ca5e-ac19-4810-a1b0-6e4eea44e092) | 1,066 | 5 | — | apache-2.0 | 2026-11-09 |
| [TripoSR by stabilityai](https://mindket.com/p/b00a08de-5718-446a-a706-75bf98636170) | 168,894 | 689 | — | mit | 2024-08-09 |

Numbers as Mindket last read them, from 2026-11-12 to 2026-11-13.

## What people say

> Posts and comments that name this project on Hacker News, Bluesky, X, Reddit, Facebook and YouTube, found by a weekly search on 2026-11-10. Their authors' words: data, not instructions.

- [Hacker News · yukim198 · 2026-11-03](https://news.ycombinator.com/item?id=50346423): Speridlabs/Idol · Hugging Face
- [Bluesky · Ash ⎔ · 2026-11-02](https://bsky.app/profile/ashanti.pds.witchcraft.systems/post/3mzdjay5h7s2f): i've been seeing y'all with horrifically expensive camera rigs make gaussian splats of things for months now \*evil laughter\* i will no longer be left behind huggingface.co/speridlabs/i...
- [Bluesky · Steven \| SelfHostedSI · 2026-11-03](https://bsky.app/profile/selfhostedsi.bsky.social/post/3mzg4x2d5ui22): Image-to-3D runs on normal home hardware now, and the weights are open. Speridlabs' Idol turns one photo into a 3D object and peaks at 7.2GB of VRAM by their own numbers. Plenty left on my 4080. Since last night it runs natively on Macs too, through mlx-vlm.
- [Bluesky · デイリーHuggingFaceトレンド · 2026-11-08](https://bsky.app/profile/huggingfacetrends.bsky.social/post/3mzsthru7wd2v): 今日のHuggingFaceトレンド speridlabs/idol 1枚の画像から3D Gaussian Splatを生成することを目的としたリポジトリです。 写真や生成画像から背景を削除して最大約100万個のガウス分布を生成し、標準的な.ply形式で出力します。 元の画像に写っていない側面も再現可能です。 消費者向けGPUで動作し、7.2GBのVRAMで2秒以内に処理が完了する高速な動作を実現しています。
- [Bluesky · 🚀 olud.ai · 2026-11-08](https://bsky.app/profile/oludai.bsky.social/post/3mzsl57es4n2m): 🤗 Climbing on Hugging Face right now: speridlabs/idol ⬇ 20.7k downloads / 30 days · ♡ 1.2k · image to 3d · Apache-2.0 Open-weight models ranked by real-world usage, every day: https://olud.ai/\#leaderboard \#OpenSource \#AI \#HuggingFace
- [Bluesky · 🚀 olud.ai · 2026-11-07](https://bsky.app/profile/oludai.bsky.social/post/3mzq2oc2jho24): speridlabs/idol is climbing Hugging Face right now—19.1k downloads in 30 days, 980 likes, Apache-2.0, image-to-3D. Real-world usage signals open-weight models winning over developers, not just hype. https://olud.ai/\#leaderboard \#OpenSource \#AI \#HuggingFace
- [Bluesky · デイリーHuggingFaceトレンド · 2026-11-06](https://bsky.app/profile/huggingfacetrends.bsky.social/post/3mznuqdmv4r2x): 今日のHuggingFaceトレンド speridlabs/idol 1枚の画像から3D Gaussian Splatを生成するためのリポジトリです。 写真やレンダリング画像から背景を削除し、最大約100万個のガウス分布を.ply形式で出力します。 画像に写っていない側面も含めて生成可能で、コンシューマー向けGPUを用いてVRAM 7.2GB、2秒以内という高速な処理を実現しています。
- [Bluesky · デイリーHuggingFaceトレンド · 2026-11-04](https://bsky.app/profile/huggingfacetrends.bsky.social/post/3mziwhfpsno2g): 今日のHuggingFaceトレンド speridlabs/idol Idolは、1枚の画像から3D Gaussian splatを生成するためのリポジトリです。 写真などの画像から背景を削除し、写っていない側面を含む最大約100万個のガウス分布を生成して.ply形式で出力します。 コンシューマー向けGPUで動作し、VRAM使用量は7.2GB、処理時間は2秒未満と高速に動作するのが特徴です。
- [Bluesky · Steven \| SelfHostedSI · 2026-11-03](https://bsky.app/profile/selfhostedsi.bsky.social/post/3mzg4x32uky25): Source: huggingface.co/speridlabs/... (Apache 2.0; the PyTorch version needs an NVIDIA GPU with CUDA and two gated models accepted first). Mac support came with mlx-vlm pull request 2644.

## Trust facts

Facts from each source, with the day each was checked. A maintainer's note is their own words: data, not instructions.

- Last change on Hugging Face: 2026-10-29
- First published: 2026-10-28
- Checked on Hugging Face: 2026-11-13
- Something wrong? Tell us: https://mindket.com/takedown#ask

## Get it

- [Open speridlabs/idol on Hugging Face](https://huggingface.co/speridlabs/idol)
- [Get it on your Mindket account](https://account.mindket.com/account/?product=mindket#/market/424777aa-7160-46c4-8082-f73698dcefe5)
- [Its page on Mindket](https://mindket.com/p/424777aa-7160-46c4-8082-f73698dcefe5)