---
title: "Idol"
kind: "Kit"
category: "Developer"
price: "Free"
seller: "Mindket"
version: "1"
url: "https://mindket.com/p/10bb6e67-5220-4a1b-9ae1-c5dfd1715479"
updated: "2026-11-10"
---

# Idol

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

Turns one image into a 3D object made of Gaussian splats, in a Gradio demo you run as a Hugging Face Space. For artists and researchers who want to try single-image 3D.

Idol 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 is a demo from Speridlabs that builds a 3D object from a single image. The 3D result is made of Gaussian splats. It runs as a Gradio app on Hugging Face Spaces.

### Who it suits

It suits people who want to see what one picture can become in 3D, and people who want a small example of how such a demo is built.

| Industry | Who uses it | How they use it | Example |
| --- | --- | --- | --- |
| 3D art and games | Artists and prototypers | Turn one reference picture into a 3D object | Trying a character sketch as a 3D figure |
| Computer vision | Researchers | Test single-image 3D on the example images and their saved settings | Comparing two presets on the same kind of picture |
| Software | App developers | Read the Space files to see how a Gradio front end wraps a model | Reusing the Space layout for their own demo |

You can skip it if you need a finished mesh for a game engine, because the demo describes its output as Gaussian splats.

### Where to use it

The Space runs in a web browser through its Gradio interface. You can also copy the Space and run your own.

| Use case | Who | What they get back |
| --- | --- | --- |
| One picture to 3D | Artists | A 3D object built from Gaussian splats |
| Trying the examples | Newcomers | Each example image run with the settings saved for it |

### How to set it up

The source shows no install command, so this page has no code block. The Space needs a Hugging Face token to load two image encoders.

- A Hugging Face account with access to the dinov3-vith16plus-pretrain-lvd1689m encoder from the facebook organization.
- The same account with access to the FLUX.2-dev encoder from black-forest-labs.
- A secret named HF\_TOKEN on your copy of the Space.

1. Request access to both image encoders on your Hugging Face account.
2. Create an access token for that account.
3. Add the token to the Space as a secret named HF\_TOKEN.
4. Open the Space once the secret is saved.

Run these in a terminal:

```sh
# Install Hugging Face's command line
pip install -U huggingface_hub
# Download the Space's files into a folder
hf download speridlabs/idol --repo-type space --local-dir idol
# Go into its folder
cd idol
```

### How to use it

Start with one of the example images. Each one is listed with the settings it runs with, so you can see what the demo does before you change anything.

| Tool | What it does |
| --- | --- |
| app.py | The user interface of the Gradio demo |
| model.py | The model that makes the 3D object |
| examples/presets.json | Holds the example pictures and the settings each one runs under |

### Good to know

- Without an HF\_TOKEN from an account with access to both encoders, the Space cannot load them.
- The source gives no limits on image size, run time or export format.
- The source does not describe how the model works inside. Read model.py if you need that.
- The license is Apache 2.0.

## README

````markdown
# Idol

Turns one image into a 3D object made of Gaussian splats, in a Gradio demo you run as a Hugging Face Space. For artists and researchers who want to try single-image 3D.

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

## About

What it is: Idol is a demo from Speridlabs that builds a 3D object from a single image. The 3D result is made of Gaussian splats. It runs as a Gradio app on Hugging Face Spaces.

Who it suits: It suits people who want to see what one picture can become in 3D, and people who want a small example of how such a demo is built.

```table
Industry | Who uses it | How they use it | Example
3D art and games | Artists and prototypers | Turn one reference picture into a 3D object | Trying a character sketch as a 3D figure
Computer vision | Researchers | Test single-image 3D on the example images and their saved settings | Comparing two presets on the same kind of picture
Software | App developers | Read the Space files to see how a Gradio front end wraps a model | Reusing the Space layout for their own demo
```

You can skip it if you need a finished mesh for a game engine, because the demo describes its output as Gaussian splats.

Where to use it: The Space runs in a web browser through its Gradio interface. You can also copy the Space and run your own.

```table
Use case | Who | What they get back
One picture to 3D | Artists | A 3D object built from Gaussian splats
Trying the examples | Newcomers | Each example image run with the settings saved for it
```

How to set it up: The source shows no install command, so this page has no code block. The Space needs a Hugging Face token to load two image encoders.

- A Hugging Face account with access to the dinov3-vith16plus-pretrain-lvd1689m encoder from the facebook organization.
- The same account with access to the FLUX.2-dev encoder from black-forest-labs.
- A secret named HF_TOKEN on your copy of the Space.

1. Request access to both image encoders on your Hugging Face account.
2. Create an access token for that account.
3. Add the token to the Space as a secret named HF_TOKEN.
4. Open the Space once the secret is saved.

How to use it: Start with one of the example images. Each one is listed with the settings it runs with, so you can see what the demo does before you change anything.

```table
Tool | What it does
app.py | The user interface of the Gradio demo
model.py | The model that makes the 3D object
examples/presets.json | Holds the example pictures and the settings each one runs under
```

Good to know:

- Without an HF_TOKEN from an account with access to both encoders, the Space cannot load them.
- The source gives no limits on image size, run time or export format.
- The source does not describe how the model works inside. Read model.py if you need that.
- The license is Apache 2.0.

## On Hugging Face, 6 November 2026

- Likes: 161
- Built with: gradio
- License: apache-2.0

## Links

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

## Try it

Open the Space in your browser, or copy it to your own Hugging Face account from its page. Nothing in this kit runs by itself.
````

## What is in it

1 files, 3 KB, downloaded as a zip.

```text
README.md  3 KB
```

## Source

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

## Compare with similar

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

| Product | Likes | Built with | License | Last change |
| --- | --- | --- | --- | --- |
| Idol (this page) | 255 | gradio | apache-2.0 | 2026-10-29 |
| [FLUX.1 dev](https://mindket.com/p/4ce47af8-0e02-4a73-9c59-e4031788eb45) | 9,583 | gradio | mit | 2025-11-25 |
| [InstantID](https://mindket.com/p/54fcb36c-756a-4797-80c1-05779f87ebbd) | 3,659 | gradio | apache-2.0 | 2025-08-26 |
| [Chat With Janus-Pro-7B](https://mindket.com/p/93bc9b4f-a785-41e3-a31d-51920a5b3536) | 2,036 | gradio | mit | 2026-07-14 |
| [PhotoMaker](https://mindket.com/p/b3e336b4-4a67-4e52-8c2e-1e94d392ac71) | 1,960 | gradio | apache-2.0 | 2025-08-28 |
| [Z Image Turbo](https://mindket.com/p/adfd87b7-3f3e-405e-95c8-1957bc0da52a) | 1,940 | gradio | apache-2.0 | 2026-05-22 |

Numbers as Mindket last read them, on 2026-11-12.

## 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-12
- Something wrong? Tell us: https://mindket.com/takedown#ask

## Get it

- [Open speridlabs/idol on Hugging Face](https://huggingface.co/spaces/speridlabs/idol)
- [Get it on your Mindket account](https://account.mindket.com/account/?product=mindket#/market/10bb6e67-5220-4a1b-9ae1-c5dfd1715479)
- [Its page on Mindket](https://mindket.com/p/10bb6e67-5220-4a1b-9ae1-c5dfd1715479)
