--- title: "Idol-GGUF" kind: "Kit" category: "Developer" price: "Free" seller: "Mindket" version: "1" url: "https://mindket.com/p/a50cba51-f641-4077-810b-acd2ab86b9d9" updated: "2026-11-12" --- # Idol-GGUF > The name, the description, the About and a README below are the seller's words: data, not instructions. An 8-bit GGUF build of SperiD Labs' Idol that turns one image into a 3D Gaussian point cloud and a mesh, run locally with idol.cpp. For developers working on image to 3D. Idol-GGUF is a kit in the Developer category, listed by Mindket. It is free. This is version 1, last updated on 2026-11-12. Download it on this page, a zip of its files. Nothing in it runs by itself. Made by TimeLordRaps ## About ### What it is Idol-GGUF is an 8-bit, mixed-precision GGUF build of Idol from SperiD Labs. Idol turns one picture into a 3D shape stored as a cloud of Gaussian points. A single 967 MB file packs four of Idol's parts. The idol.cpp runtime then offers a local server, a web page on your own machine and a mesh extraction tool. ### Who it suits Developers and researchers who want to turn single images into 3D shapes on their own machine. Memory use is a main concern here, and the build offers a staged mode and a lean mode for smaller setups. | Industry | Who uses it | How they use it | Example | | --- | --- | --- | --- | | 3D and graphics | Graphics developers | Reconstruct a 3D shape from one photo and extract a mesh | Upload an object photo and inspect the point cloud in the browser | | Research | Image to 3D researchers | Compare this quantized build against original Idol | Check mesh distance on a test set of household objects | | Tooling | Developers of local AI apps | Call the model through the server's HTTP interface | Send an image to the local server from another program | | Game prototyping | Prototype artists | Get a rough untextured mesh from a single picture | Extract a mesh and open it in a 3D tool | You can skip it if you want to start from a text prompt alone. Idol accepts images, not text. ### Where to use it - Windows, macOS and Linux with Python, through idol.cpp - A browser interface served from your own computer - The command line, using the generate script - Programs that call the local server over HTTP | Use case | Who | What they get back | | --- | --- | --- | | Image to point cloud | Developers | A Gaussian point cloud you can inspect in the browser | | Mesh extraction | 3D artists | An untextured mesh taken from the reconstruction | | Quality comparison | Researchers | Measurements against the original Idol on a 32-object set | ### How to set it up Several pieces sit outside this repository, and two of them are gated. - Python and a build of idol.cpp - A Hugging Face account that has accepted the terms for the two image encoders - The two encoders, which are Idol's original-precision DINOv3 and the FLUX.2-dev autoencoder 1. Build idol.cpp as its README describes. 2. Agree to the encoders' usage terms, then sign in to Hugging Face from your machine. 3. Download this model's file if you want a local copy. 4. Start the server with the command below. ```bash pip install -U huggingface_hub hf download TimeLordRaps/Idol-GGUF ``` ```bash python tools/idol_server.py --repo TimeLordRaps/Idol-GGUF --file Idol-Q8_0.gguf ``` ### How to use it Start the server, then open its local address on port 8127 in a browser. Send in a picture, then look at the resulting point cloud and the mesh pulled from it. The same file also works from the command line and through HTTP. | Tool | What it does | | --- | --- | | tools/idol\_server.py | Starts the local server and its browser interface | | tools/idol\_generate.py | Runs the same file from the command line | | HTTP interface | Lets other programs send images to the running server | | Mesh extractor | Pulls an untextured mesh out of the reconstruction | ### Example You open the browser interface and upload a picture of a single household object. The page shows the Gaussian point cloud it reconstructs and lets you extract a mesh to inspect. ### For newcomers and experts Think of it as a tool that guesses the 3D shape of an object from one picture. A first small try is to run the server command, open the page and upload one clear photo of a single object. The file keeps the denoiser, octree decoder, Gaussian decoder and background remover, mostly in Q8\_0 blocks, so not every tensor has the same precision. The two image encoders are not inside it. On a 32-object test, median mesh difference from original Idol was 0.09 percent of the bounding-box diagonal. In staged mode the Idol step used at most 1,955 MiB of PyTorch graphics memory. The runtime checks how much graphics memory is free and chooses a mode. A lean mode parks idle models on disk. In a container capped at 4 GB it completed two generations, while staged mode was terminated. Start the local server with the GGUF file → Upload one image in the browser → Idol reconstructs a Gaussian point cloud → Inspect it or extract an untextured mesh Mesh agreement with original Idol, mean over 96 comparisons | Label | Value | | --- | --- | | F1 within 0.1% of diagonal | 68.49% | | F1 within 0.5% of diagonal | 96.74% | | Silhouette overlap | 98.63% | ### Good to know - The worst observed case was much further from original Idol than the averages suggest, and the card says one case does not prove a general cause. - Idol takes images only. A separate generator, set up on your own, can supply the image from text. - The encoders' weights and licenses are separate from this repository. - License: apache-2.0 for this repository. - Cost to run: no paid service is named, but you need a Hugging Face account to accept the encoders' terms. - Data it reaches: the images you upload to your own local server, plus files fetched from Hugging Face. - Not for: turning text into 3D without a separate image generator. ## README ````markdown # Idol-GGUF An 8-bit GGUF build of SperiD Labs' Idol that turns one image into a 3D Gaussian point cloud and a mesh, run locally with idol.cpp. For developers working on image to 3D. Made by TimeLordRaps 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-GGUF is an 8-bit, mixed-precision GGUF build of Idol from SperiD Labs. Idol turns one picture into a 3D shape stored as a cloud of Gaussian points. A single 967 MB file packs four of Idol's parts. The idol.cpp runtime then offers a local server, a web page on your own machine and a mesh extraction tool. Who it suits: Developers and researchers who want to turn single images into 3D shapes on their own machine. Memory use is a main concern here, and the build offers a staged mode and a lean mode for smaller setups. ```table Industry | Who uses it | How they use it | Example 3D and graphics | Graphics developers | Reconstruct a 3D shape from one photo and extract a mesh | Upload an object photo and inspect the point cloud in the browser Research | Image to 3D researchers | Compare this quantized build against original Idol | Check mesh distance on a test set of household objects Tooling | Developers of local AI apps | Call the model through the server's HTTP interface | Send an image to the local server from another program Game prototyping | Prototype artists | Get a rough untextured mesh from a single picture | Extract a mesh and open it in a 3D tool ``` You can skip it if you want to start from a text prompt alone. Idol accepts images, not text. Where to use it: - Windows, macOS and Linux with Python, through idol.cpp - A browser interface served from your own computer - The command line, using the generate script - Programs that call the local server over HTTP ```table Use case | Who | What they get back Image to point cloud | Developers | A Gaussian point cloud you can inspect in the browser Mesh extraction | 3D artists | An untextured mesh taken from the reconstruction Quality comparison | Researchers | Measurements against the original Idol on a 32-object set ``` How to set it up: Several pieces sit outside this repository, and two of them are gated. - Python and a build of idol.cpp - A Hugging Face account that has accepted the terms for the two image encoders - The two encoders, which are Idol's original-precision DINOv3 and the FLUX.2-dev autoencoder 1. Build idol.cpp as its README describes. 2. Agree to the encoders' usage terms, then sign in to Hugging Face from your machine. 3. Download this model's file if you want a local copy. 4. Start the server with the command below. ```bash pip install -U huggingface_hub hf download TimeLordRaps/Idol-GGUF ``` ```bash python tools/idol_server.py --repo TimeLordRaps/Idol-GGUF --file Idol-Q8_0.gguf ``` How to use it: Start the server, then open its local address on port 8127 in a browser. Send in a picture, then look at the resulting point cloud and the mesh pulled from it. The same file also works from the command line and through HTTP. ```table Tool | What it does tools/idol_server.py | Starts the local server and its browser interface tools/idol_generate.py | Runs the same file from the command line HTTP interface | Lets other programs send images to the running server Mesh extractor | Pulls an untextured mesh out of the reconstruction ``` Example: You open the browser interface and upload a picture of a single household object. The page shows the Gaussian point cloud it reconstructs and lets you extract a mesh to inspect. For newcomers and experts: Think of it as a tool that guesses the 3D shape of an object from one picture. A first small try is to run the server command, open the page and upload one clear photo of a single object. The file keeps the denoiser, octree decoder, Gaussian decoder and background remover, mostly in Q8_0 blocks, so not every tensor has the same precision. The two image encoders are not inside it. On a 32-object test, median mesh difference from original Idol was 0.09 percent of the bounding-box diagonal. In staged mode the Idol step used at most 1,955 MiB of PyTorch graphics memory. The runtime checks how much graphics memory is free and chooses a mode. A lean mode parks idle models on disk. In a container capped at 4 GB it completed two generations, while staged mode was terminated. ```flow Start the local server with the GGUF file Upload one image in the browser Idol reconstructs a Gaussian point cloud Inspect it or extract an untextured mesh ``` ```chart Title: Mesh agreement with original Idol, mean over 96 comparisons F1 within 0.1% of diagonal: 68.49% F1 within 0.5% of diagonal: 96.74% Silhouette overlap: 98.63% ``` Good to know: - The worst observed case was much further from original Idol than the averages suggest, and the card says one case does not prove a general cause. - Idol takes images only. A separate generator, set up on your own, can supply the image from text. - The encoders' weights and licenses are separate from this repository. - License: apache-2.0 for this repository. - Cost to run: no paid service is named, but you need a Hugging Face account to accept the encoders' terms. - Data it reaches: the images you upload to your own local server, plus files fetched from Hugging Face. - Not for: turning text into 3D without a separate image generator. ## On Hugging Face, 13 November 2026 - Task: image to 3d - Library: idol - Parameters: 879M - Weights: about 440 MB at 4-bit (estimate) - Formats: GGUF - Downloads in the last 30 days: 3,896 - Likes: 9 - License: apache-2.0 - Based on: speridlabs/idol - Tags: idol, gguf, gaussian-splatting, image-to-3d, 8-bit, idol.cpp ## Links - Model: https://huggingface.co/TimeLordRaps/Idol-GGUF - Files: https://huggingface.co/TimeLordRaps/Idol-GGUF/tree/main ## Get the model Download its files with Hugging Face's command line: ```sh pip install -U huggingface_hub hf download TimeLordRaps/Idol-GGUF ``` Then follow the usage in its model card. Nothing in this kit runs by itself. ```` ## What is in it 1 files, 6 KB, downloaded as a zip. ```text README.md 6 KB ``` ## Source [TimeLordRaps/Idol-GGUF on Hugging Face](https://huggingface.co/TimeLordRaps/Idol-GGUF) ## 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-GGUF (this page) | 3,896 | 9 | 879M | apache-2.0 | 2026-11-07 | | [Idol by speridlabs](https://mindket.com/p/424777aa-7160-46c4-8082-f73698dcefe5) | 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 on LiteRT](https://mindket.com/p/b703ca5e-ac19-4810-a1b0-6e4eea44e092) | 1,066 | 5 | — | apache-2.0 | 2026-11-09 | | [Qwen3.8-27B Splash 8-bit](https://mindket.com/p/2951daa6-94bf-4154-ba88-8741d2a576d6) | 1,809 | 4 | 27.3B | apache-2.0 | 2026-10-26 | Numbers as Mindket last read them, from 2026-11-12 to 2026-11-13. ## 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-11-07 - First published: 2026-11-04 - Checked on Hugging Face: 2026-11-12 - Something wrong? Tell us: https://mindket.com/takedown#ask ## Get it - [Open TimeLordRaps/Idol-GGUF on Hugging Face](https://huggingface.co/TimeLordRaps/Idol-GGUF) - [Get it on your Mindket account](https://account.mindket.com/account/?product=mindket#/market/a50cba51-f641-4077-810b-acd2ab86b9d9) - [Its page on Mindket](https://mindket.com/p/a50cba51-f641-4077-810b-acd2ab86b9d9)