Skip to content

Getting Started

eduardoabreu81 edited this page Nov 6, 2026 · 1 revision

Getting started

Install

  1. In Forge Neo, go to Extensions → Install from URL
  2. Paste https://github.com/eduardoabreu81/idol-forge-neo, click Install and restart the WebUI
  3. Check the console. This line means all is well:
[Idol] native backend enabled (torch ...)

There is nothing to pip install. See Troubleshooting if another message appears.

Get the files

Four files, none of which need a Hugging Face account. The links are on the Models page.

File Size Folder
idol_fp16.safetensors 741 MB models/Stable-diffusion
dino_v3_vit_h_bf16.safetensors 1.7 GB models/text_encoder
flux2-vae.safetensors 336 MB models/VAE
idol_decoder_fp16.safetensors 576 MB models/VAE

Your first object

  1. Choose the idol UI preset and the idol_fp16 checkpoint
  2. Under VAE / Text Encoder, select all three: dino_v3_vit_h_bf16, flux2-vae and idol_decoder_fp16. The panel says All the files are selected when they are in place
  3. Go to img2img and drop in a picture of one object
  4. In the Idol panel, choose the Idol input: Render or generated image, or Photo
  5. Press Generate

The first time, the background removal downloads by itself into models/Idol (444 MB), unless your picture has transparency.

The object opens in the panel's viewer: drag to turn it. The gallery shows the picture the model actually saw: background removed, cropped, 1024 × 1024. The files are next to your usual img2img images, named idol-<seed>-<id>.

Idol Turbo

Tick Idol Turbo in the panel. It runs on the same checkpoint, so there is no other model to select.

  • Its LoRAs are handled for you. The first time, idol_turbo_slow_comfy and idol_turbo_fast_comfy (59 MB each) download into models/Idol.
  • Do not add them yourself. No <lora:...> in the prompt, and keep them out of models/Lora: the extension switches from one to the other in the middle of the sampling, which Forge's own LoRAs cannot do.
  • The settings follow. Ticking it sets 5 steps and CFG 1; unticking it goes back to 50 and CFG 4. CFG and the sampler stay fixed while it is on. Steps are yours: 4 to 8 work best.

Choosing what to save

Open Save as in the panel and tick what you want. .ply and .spz are on by default; tick .glb for a mesh. More in Settings and Controls.

Turning the object

Models do not always put the object's front towards the viewer. To turn the last object without generating it again:

  1. Open Save as
  2. Set Idol rotate X, Y and Z. They follow the viewer: X to the right, Y up, Z towards you
  3. Press Rotate and save

The turned files are saved next to the original, with the angles in their name, and open in the viewer. Each rotation starts from the object as it came out, so pressing twice does not add up.

Opening the files

File Open it in
.ply, .spz A Gaussian splat viewer, such as SuperSplat
.glb Blender (File → Import → glTF 2.0) and other 3D programs. Its colours are on the vertices

Clone this wiki locally