Repository navigation
Getting Started
- In Forge Neo, go to Extensions → Install from URL
- Paste
https://github.com/eduardoabreu81/idol-forge-neo, click Install and restart the WebUI - 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.
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 |
- Choose the idol UI preset and the
idol_fp16checkpoint - Under VAE / Text Encoder, select all three:
dino_v3_vit_h_bf16,flux2-vaeandidol_decoder_fp16. The panel says All the files are selected when they are in place - Go to img2img and drop in a picture of one object
- In the Idol panel, choose the Idol input: Render or generated image, or Photo
- 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>.
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_comfyandidol_turbo_fast_comfy(59 MB each) download intomodels/Idol. -
Do not add them yourself. No
<lora:...>in the prompt, and keep them out ofmodels/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.
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.
Models do not always put the object's front towards the viewer. To turn the last object without generating it again:
- Open Save as
- Set Idol rotate X, Y and Z. They follow the viewer: X to the right, Y up, Z towards you
- 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.
| 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 |
Idol for Forge Neo
Using it
Reference